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,7 +105,6 @@ 105 105 * Sleep Mode: 5uA @ 3.3v 106 106 * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm 107 107 108 - 109 109 == 1.4 Effective measurement range Reference beam pattern == 110 110 111 111 ... ... @@ -193,6 +193,18 @@ 193 193 [[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675143909447-639.png]] 194 194 195 195 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 + 196 196 = 2. Configure DDS75-LB to connect to LoRaWAN network = 197 197 198 198 == 2.1 How it works == ... ... @@ -253,355 +253,178 @@ 253 253 After join success, it will start to upload messages to TTN and you can see the messages in the panel. 254 254 255 255 256 -== 2.3 Uplink Payload == 267 +== 2.3 Uplink Payload == 257 257 258 -=== 2.3.1 Device Status, FPORT~=5 === 259 259 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 - 355 355 ((( 356 -SW3L-LB will send this uplink **after** Device Status once join the LoRaWAN network successfully. And SW3L-LB will: 271 +((( 272 +DDS75-LB will uplink payload via LoRaWAN with below payload format: 357 357 ))) 358 358 359 359 ((( 360 -periodically send this uplink every 20 minutes, this interval [[can be changed>>||anchor="H3.3.1SetTransmitIntervalTime"]]. 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 361 361 ))) 279 +))) 362 362 363 363 ((( 364 - UplinkPayload totals 11 bytes.282 + 365 365 ))) 366 366 367 367 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %) 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"]] 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"]] 373 373 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 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"]] 378 378 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"]] 380 380 299 +=== 2.3.1 Battery Info === 381 381 382 -* ((( 383 -(% style="color:#037691" %)**Calculate Flag** 384 -))) 385 385 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 -))) 302 +Check the battery voltage for DDS75-LB. 389 389 390 -((( 391 -**Example: in the default payload:** 392 -))) 304 +Ex1: 0x0B45 = 2885mV 393 393 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 -))) 306 +Ex2: 0x0B49 = 2889mV 403 403 404 -((( 405 -Default value: 0. 406 -))) 407 407 408 -((( 409 -Range (6 bits): (b)000000 ~~ (b) 111111 309 +=== 2.3.2 Distance === 410 410 411 -If user use with a meter for example is 0.02L/pulse. To proper decode the correct value in server, 412 412 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. 312 +((( 313 +Get the distance. Flat object range 280mm - 7500mm. 416 416 ))) 417 417 418 418 ((( 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 -))) 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" %)** ** 421 421 422 -* ((( 423 -(% style="color:#037691" %)**Alarm** 319 +(% style="color:#4472c4" %)**0B05(H) = 2821 (D) = 2821 mm.** 424 424 ))) 425 425 426 -((( 427 -See [[Alarm for continuously water flow>>||anchor="H3.3.4Alarmforcontinuouslywaterflow"]] 428 -))) 429 429 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"]] 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. 431 431 326 +=== 2.3.3 Interrupt Pin === 432 432 433 -* ((( 434 -(% style="color:#037691" %)**Total pulse** 435 -))) 436 436 437 -((( 438 -Total pulse/counting since factory 439 -))) 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. 440 440 441 -((( 442 -Range (4 Bytes) : 0x00000000~~ 0xFFFFFFFF . 443 -))) 331 +**Example:** 444 444 445 -* ((( 446 -(% style="color:#037691" %)**Last Pulse** 447 -))) 333 +0x00: Normal uplink packet. 448 448 449 -((( 450 -Total pulse since last FPORT=2 uplink. (Default 20 minutes) 451 -))) 335 +0x01: Interrupt Uplink Packet. 452 452 453 -((( 454 -Range (4 Bytes) : 0x00000000~~ 0xFFFFFFFF . 455 -))) 456 456 457 -* ((( 458 -(% style="color:#037691" %)**MOD: Default =0** 459 -))) 338 +=== 2.3.4 DS18B20 Temperature sensor === 460 460 461 -((( 462 -MOD=0 ~-~-> Uplink Total Pulse since factory 463 -))) 464 464 465 -((( 466 -MOD=1 ~-~-> Uplink total pulse since last FPORT=2 uplink. 467 -))) 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. 468 468 469 -* ((( 470 -(% style="color:#037691" %)**Water Flow Value** 471 -))) 343 +**Example**: 472 472 473 -((( 474 -**Total Water Flow Volume = (Calculate Flag) x (Total Pulse)=9597/450=21.3L** 475 -))) 345 +If payload is: 0105H: (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree 476 476 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"]]347 +If payload is: FF3FH : (FF3F & FC00 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees. 478 478 349 +(% style="color:red" %)**Note: DS18B20 feature is supported in the hardware version > v1.3 which made since early of 2021.** 479 479 480 -((( 481 -**Total Water Flow for TDC timer = (Calculate Flag) x (Last Pulse)=79/450=0.2L** 482 -))) 483 483 484 - [[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"]] ** **352 +=== 2.3.5 Sensor Flag === 485 485 486 486 487 -=== 2.3.4 Historical Water Flow Status, FPORT~=3 === 488 - 489 - 490 490 ((( 491 - SW3L-LBstores sensor values and userscan retrievethese history valuesvia the [[downlinkcommand>>||anchor="H2.5DatalogFeature"]].356 +0x01: Detect Ultrasonic Sensor 492 492 ))) 493 493 494 494 ((( 495 - Thehistoricalpayload includese or multipliesentriesand every entry has the same payload as Real-Time waterflow status.360 +0x00: No Ultrasonic Sensor 496 496 ))) 497 497 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 -))) 501 501 502 -((( 503 -For example, in the US915 band, the max payload for different DR is: 504 -))) 364 +=== 2.3.6 Decode payload in The Things Network === 505 505 506 -((( 507 -(% style="color:blue" %)**a) DR0:**(%%) max is 11 bytes so one entry of data 508 -))) 509 509 510 -((( 511 -(% style="color:blue" %)**b) DR1:**(%%) max is 53 bytes so devices will upload 4 entries of data (total 44 bytes) 512 -))) 367 +While using TTN network, you can add the payload format to decode the payload. 513 513 514 -((( 515 -(% style="color:blue" %)**c) DR2:**(%%) total payload includes 11 entries of data 516 -))) 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"]] 517 517 518 -((( 519 -(% style="color:blue" %)**d) DR3:**(%%) total payload includes 22 entries of data. 520 -))) 371 +The payload decoder function for TTN V3 is here: 521 521 522 522 ((( 523 - IfSW3L-LBdoesn'thaveany datainthe pollingtime. Itwilluplink 11 bytesof 0374 +DDS75-LB TTN V3 Payload Decoder: [[ttps:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]] 524 524 ))) 525 525 526 -((( 527 -(% style="color:#037691" %)**Downlink:** 528 -))) 529 529 530 -((( 531 -0x31 62 46 B1 F0 62 46 B3 94 07 532 -))) 378 +== 2.4 Uplink Interval == 533 533 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"]] 535 535 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"]] 536 536 537 -((( 538 -(% style="color:#037691" %)**Uplink:** 539 -))) 540 540 541 -((( 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 543 -))) 384 +== 2.5 Show Data in DataCake IoT Server == 544 544 545 -((( 546 -(% style="color:#037691" %)**Parsed Value:** 547 -))) 548 548 549 549 ((( 550 -[Alar m,CalculateFlag,MOD, Totalpulse orLastPulse,****WaterFlowValue,TIME]388 +[[DATACAKE>>url:https://datacake.co/]] provides a human friendly interface to show the sensor data, once we have data in TTN, we can use [[DATACAKE>>url:https://datacake.co/]] to connect to TTN and see the data in DATACAKE. Below are the steps: 551 551 ))) 552 552 553 - 554 554 ((( 555 - [FALSE,0,0,0,0.0,2022-04-0108:04:54],392 + 556 556 ))) 557 557 558 558 ((( 559 - [FALSE,0,0,0,0.0,2022-04-0108:05:49],396 +(% style="color:blue" %)**Step 1**(%%)**: Be sure that your device is programmed and properly connected to the network at this time.** 560 560 ))) 561 561 562 562 ((( 563 - [FALSE,0,0,0,0.0,2022-04-0108:06:49],400 +(% style="color:blue" %)**Step 2**(%%)**: To configure the Application to forward data to DATACAKE you will need to add integration. To add the DATACAKE integration, perform the following steps:** 564 564 ))) 565 565 566 -((( 567 -[FALSE,0,0,0,0.0,2022-04-01 08:07:49], 568 -))) 569 569 570 -((( 571 -[FALSE,0,0,277,0.6,2022-04-01 08:08:49], 572 -))) 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"]] 573 573 574 -((( 575 -[FALSE,0,0,287,0.6,2022-04-01 08:10:38], 576 -))) 577 577 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"]]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"]] 579 579 580 580 581 - ==2.4 PayloadDecoderfile==410 +(% style="color:blue" %)**Step 3**(%%)**: Create an account or log in Datacake.** 582 582 412 +(% style="color:blue" %)**Step 4**(%%)**: Search the DDS75-LB and add DevEUI.** 583 583 584 - In TTN, usecandacustom payloadtshowsfriendlyreading414 +[[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"]] 585 585 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]] 587 587 417 +After added, the sensor data arrive TTN V3, it will also arrive and show in Datacake. 588 588 589 - == 2.5g Feature419 +[[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"]] 590 590 591 591 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. 593 593 423 +== 2.6 Datalog Feature == 594 594 595 -=== 2.5.1 Ways to get datalog via LoRaWAN === 596 596 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. 597 597 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 599 429 +=== 2.6.1 Ways to get datalog via LoRaWAN === 430 + 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 + 600 600 * ((( 601 -a) S W3L-LB will do an ACK check for data records sending to make sure every data arrive server.435 +a) DDS75-LB will do an ACK check for data records sending to make sure every data arrive server. 602 602 ))) 603 603 * ((( 604 -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.438 +b) DDS75-LB will send data in **CONFIRMED Mode** when PNACKMD=1, but DDS75-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 DDS75-LB gets a ACK, DDS75-LB will consider there is a network connection and resend all NONE-ACK messages. 605 605 ))) 606 606 607 607 Below is the typical case for the auto-update datalog feature (Set PNACKMD=1) ... ... @@ -609,10 +609,10 @@ 609 609 [[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"]] 610 610 611 611 612 -=== 2. 5.2 Unix TimeStamp ===446 +=== 2.6.2 Unix TimeStamp === 613 613 614 614 615 -S W3L-LB uses Unix TimeStamp format based on449 +DDS75-LB uses Unix TimeStamp format based on 616 616 617 617 [[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"]] 618 618 ... ... @@ -626,17 +626,17 @@ 626 626 So, we can use AT+TIMESTAMP=1611889405 or downlink 3060137afd00 to set the current time 2021 – Jan ~-~- 29 Friday 03:03:25 627 627 628 628 629 -=== 2. 5.3 Set Device Time ===463 +=== 2.6.3 Set Device Time === 630 630 631 631 632 632 User need to set (% style="color:blue" %)**SYNCMOD=1**(%%) to enable sync time via MAC command. 633 633 634 -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).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. If DDS75-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). 635 635 636 636 (% 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.** 637 637 638 638 639 -=== 2. 5.4 Poll sensor value ===473 +=== 2.6.4 Poll sensor value === 640 640 641 641 642 642 Users can poll sensor values based on timestamps. Below is the downlink command. ... ... @@ -659,14 +659,14 @@ 659 659 ))) 660 660 661 661 ((( 662 -Uplink Internal =5s,means S W3L-LB will send one packet every 5s. range 5~~255s.496 +Uplink Internal =5s,means DDS75-LB will send one packet every 5s. range 5~~255s. 663 663 ))) 664 664 665 665 666 -== 2. 6Frequency Plans ==500 +== 2.7 Frequency Plans == 667 667 668 668 669 -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.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. 670 670 671 671 [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]] 672 672 ... ... @@ -676,7 +676,7 @@ 676 676 == 3.1 Configure Methods == 677 677 678 678 679 -S W3L-LB supports below configure method:513 +DDS75-LB supports below configure method: 680 680 681 681 * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]]. 682 682 ... ... @@ -698,10 +698,10 @@ 698 698 [[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/]] 699 699 700 700 701 -== 3.3 Commands special design for S W3L-LB ==535 +== 3.3 Commands special design for DDS75-LB == 702 702 703 703 704 -These commands only valid for S W3L-LB, as below:538 +These commands only valid for DDS75-LB, as below: 705 705 706 706 707 707 === 3.3.1 Set Transmit Interval Time === ... ... @@ -746,166 +746,10 @@ 746 746 Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 747 747 ))) 748 748 749 -=== 3.3.2 Quit AT Command === 750 750 584 +=== 3.3.2 Set Interrupt Mode === 751 751 752 -Feature: Quit AT Command mode, so user needs to input the password again before using AT Commands. 753 753 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 - 909 909 Feature, Set Interrupt mode for PA8 of pin. 910 910 911 911 When AT+INTMOD=0 is set, PA8 is used as a digital input port. ... ... @@ -937,29 +937,11 @@ 937 937 938 938 * Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 939 939 940 -=== 3.3.9 Set work mode === 941 941 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 - 959 959 = 4. Battery & Power Consumption = 960 960 961 961 962 -S W3L-LB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.622 +DDS75-LB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace. 963 963 964 964 [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] . 965 965 ... ... @@ -968,7 +968,7 @@ 968 968 969 969 970 970 (% class="wikigeneratedid" %) 971 -User can change firmware S W3L-LB to:631 +User can change firmware DDS75-LB to: 972 972 973 973 * Change Frequency band/ region. 974 974