Skip to Content

Changes for page wiki_test

Last modified by Mengting Qiu on 2024/09/05 17:35
From version 87.2
edited by Mengting Qiu
on 2023/09/20 17:22
Change comment: There is no comment for this version
To version 100.4
edited by Xiaoling
on 2023/10/10 09:13
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -DDS45-NB -- NB-IoT Distance Detection Sensor User Manual
1 +SW3L-NB -- NB-IoT Flow Sensor User Manual
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.ting
1 +XWiki.Xiaoling
Content
... ... @@ -1,5 +1,5 @@
1 1  (% style="text-align:center" %)
2 -[[image:image-20230912085600-1.png||height="519" width="731"]]
2 +[[image:image-20231010090810-1.png||height="518" width="839"]]
3 3  
4 4  
5 5  
... ... @@ -8,7 +8,6 @@
8 8  
9 9  
10 10  
11 -
12 12  **Table of Contents:**
13 13  
14 14  {{toc/}}
... ... @@ -20,21 +20,23 @@
20 20  
21 21  = 1. Introduction =
22 22  
23 -== 1.1 What is DDS45-NB NB-IoT Distance Detection Sensor ==
22 +== 1.1 What is SW3L-NB NB-IoT Flow Sensor ==
24 24  
25 25  
26 -The Dragino DDS45-NB is a (% style="color:blue" %)** NB-IoT Distance Detection Sensor**(%%) for Internet of Things solution. It is used to measure the distance between the sensor and a flat object. The distance detection sensor is a module that uses (% style="color:blue" %)** ultrasonic sensing technology**(%%) for distance measurement, and (% style="color:blue" %)** temperature compensation**(%%) is performed internally to improve the reliability of data. The DDS45-NB can be applied to scenarios such as horizontal distance measurement, liquid level measurement, parking management system, object proximity and presence detection, intelligent trash can management system, robot obstacle avoidance, automatic control, sewer, bottom water level monitoring, etc.
25 +The Dragino SW3L-NB is a (% style="color:blue" %)**NB-IoT Flow Sensor**(%%). It detects water flow volume and uplink to IoT server via NB-IoT network. User can use this to (% style="color:blue" %)**monitor the water usage for buildings**.
27 27  
28 -It detects the distance (% style="color:blue" %)** between the measured object and the sensor**(%%), and and send IoT platform via NB-IoT network.
27 +The SW3L-NB will send water flow volume every 20 minutes. It can also detect the (% style="color:blue" %)**water flow status and send Alarm**(%%), to avoid the waste for water usage such as broken toilet case.
29 29  
30 -DDS45-NB supports different uplink methods including (% style="color:blue" %)**MQTT, MQTTs, UDP & TCP**(%%) for different application requirement, and support uplinks to various IoT Servers.
29 +SW3L-NB is designed for both indoor and outdoor use. It has a weatherproof enclosure and industrial level battery to (% style="color:blue" %)**work in low to high temperatures**.
31 31  
32 -DDS45-NB (% style="color:blue" %)**supports BLE configure **(%%)and(% style="color:blue" %)** OTA update**(%%) which make user easy to use.
31 +SW3L-NB supports different uplink methods including (% style="color:blue" %)**MQTT, MQTTs, UDP & TCP**(%%) for different application requirement, and support uplinks to various IoT Servers.
33 33  
34 -DDS45-NB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long-term use up to severa years.
33 +SW3L-NB (% style="color:blue" %)**supports BLE configure **(%%)and(% style="color:blue" %)** OTA update**(%%) which make user easy to use.
35 35  
36 -DDS45-NB has optional built-in SIM card and default IoT server connection version. Which makes it works with simple configuration.
35 +SW3L-NB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long-term use up to several years.
37 37  
37 +SW3L-NB has optional built-in SIM card and default IoT server connection version. Which makes it works with simple configuration.
38 +
38 38  [[image:image-20230912102813-2.png||height="320" width="923"]]
39 39  
40 40  
... ... @@ -55,7 +55,6 @@
55 55  * 8500mAh Battery for long term use
56 56  * Nano SIM card slot for NB-IoT SIM
57 57  
58 -
59 59  == 1.3 Specification ==
60 60  
61 61  
... ... @@ -101,7 +101,6 @@
101 101  * STOP Mode: 10uA @ 3.3v
102 102  * Max transmit power: 350mA@3.3v
103 103  
104 -
105 105  == 1.4 Rated environmental conditions ==
106 106  
107 107  
... ... @@ -150,13 +150,12 @@
150 150  * Sewer
151 151  * Bottom water level monitoring
152 152  
153 -
154 154  == 1.7 Sleep mode and working mode ==
155 155  
156 156  
157 -(% style="color:blue" %)**Deep Sleep Mode: **(%%)Sensor doesn't have any LoRaWAN activate. This mode is used for storage and shipping to save battery life.
155 +(% style="color:blue" %)**Deep Sleep Mode: **(%%)Sensor doesn't have any NB-IoT activate. This mode is used for storage and shipping to save battery life.
158 158  
159 -(% 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.
157 +(% style="color:blue" %)**Working Mode:** (%%)In this mode, Sensor will work as NB-IoT Sensor to Join NB-IoT 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.
160 160  
161 161  
162 162  == 1.8 Button & LEDs ==
... ... @@ -178,7 +178,6 @@
178 178  )))
179 179  |(% 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.
180 180  
181 -
182 182  == 1.9 BLE connection ==
183 183  
184 184  
... ... @@ -315,38 +315,45 @@
315 315  
316 316  This is the General Json Format. As below:
317 317  
318 -(% style="color:#4472c4" %)**{"IMEI":866207053462762,"temperature":29.2,"humidity":54.2,"battery":3.27,"signal":24,"Model":DDS45-NB, "1":{28.2,48.3,2023/08/10 08:00:37},"2":{28.1,49.1,2023/08/10 07:57:37},"3":{28.1,48.5,2023/08/10 07:54:37},"4":{28.2,48.6,2023/08/10 07:51:37},"5":{28.1,48.9,2023/08/10 07:48:37},"6":{28.2,48.8,2023/08/10 07:45:37},"7":{28.2,48.8,2023/08/10 07:42:37},"8":{28.0,48.8,2023/08/10 07:39:37}}**
315 +(% style="color:#4472c4" %)**{"IMEI":"866207058378443","Model":"DDS45-NB","distance":217,"battery":3.54,"signal":24,"1":{221,2023/09/20 09:47:01},"2":{0,2023/09/20 09:15:04},"3":{0,2023/09/20 09:00:04},"4":{0,2023/09/20 08:45:03},"5":{0,2023/09/20 08:30:03},"6":{0,2023/09/20 08:15:03},"7":{0,2023/09/20 08:00:04},"8":{0,2023/09/20 07:45:04}}**
319 319  
320 320  
321 -(% style="color:red" %)**Notice, from above payload:**
318 +[[image:image-20230920175015-3.png||height="613" width="890"]]
322 322  
323 -* Temperature , Humidity , Battery & Signal are the value at uplink time.
324 324  
325 -* Json entry 1 ~~ 8 are the last 1 ~~ 8 sampling data as specify by (% style="color:#037691" %)**AT+NOUD=8 ** (%%)Command. Each entry includes (from left to right): Temperature, Humidity, Sampling time.
321 +(% style="color:red" %)**Notice, from above payload:**
326 326  
323 +* Distance , Battery & Signal are the value at uplink time.
327 327  
325 +* Json entry 1 ~~ 8 are the last 1 ~~ 8 sampling data as specify by (% style="color:#037691" %)**AT+NOUD=8 ** (%%)Command. Each entry includes (from left to right): Distance, Sampling time.
326 +
328 328  === 2.2.2 HEX format Payload(Type~=0) ===
329 329  
330 330  
331 331  This is the HEX Format. As below:
332 332  
333 -(% style="color:#4472c4" %)**f86620705346276200640cba16010000000011011801e864d49c2d011a01e364d49925011901eb64d49871011901e564d497bd011a01e664d49709011901e964d49655011a01e864d495a1011a01e864d494ed011801e864d49439**
332 +(% style="color:#4472c4" %)**f8662070583784430b640dda15010003a4650abc400000650ab8180000650ab4940000650ab10f0000650aad8b0000650aaa070000650aa6840000650aa3000000650a9308**
334 334  
335 -[[image:image-20230920172200-1.png||height="198" width="1085"]]
334 +[[image:image-20230920172200-1.png||height="191" width="1047"]]
336 336  
337 337  
337 +If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NB sensor uplink data.
338 +
339 +[[image:image-20230920173352-2.png||height="636" width="919"]]
340 +
341 +
338 338  (% style="color:blue" %)**Version:**
339 339  
340 340  These bytes include the hardware and software version.
341 341  
342 -(% style="color:#037691" %)**Higher byte:**(%%) Specify Sensor Model: 0x00 for DDS45-NB
346 +(% style="color:#037691" %)**Higher byte:**(%%) Specify Sensor Model: 0x0b for DDS45-NB
343 343  
344 -(% style="color:#037691" %)**Lower byte:**(%%) Specify the software version: 0x64=100, means firmware version 100
348 +(% style="color:#037691" %)**Lower byte:**(%%) Specify the software version: 0x64=100, means firmware version 1.0.0
345 345  
346 346  
347 347  (% style="color:blue" %)**BAT (Battery Info):**
348 348  
349 -Ex1: 0x0CBA = 3258mV
353 +Ex1: 0x0dda = 3546mV
350 350  
351 351  
352 352  (% style="color:blue" %)**Signal Strength:**
... ... @@ -353,7 +353,7 @@
353 353  
354 354  NB-IoT Network signal Strength.
355 355  
356 -**Ex1: 0x16 = 22**
360 +**Ex1: 0x15 = 21**
357 357  
358 358  **0**  -113dBm or less
359 359  
... ... @@ -366,33 +366,44 @@
366 366  **99**    Not known or not detectable
367 367  
368 368  
369 -(% style="color:blue" %)**TimeStamp:   **
373 +(% style="color:blue" %)**Distance:  **
370 370  
371 -Unit TimeStamp Example: 64d49439(H) = 1691653177(D)
375 +Ex1: 0x03a4 = 932 mm
372 372  
373 -Put the decimal value into this link(https:~/~/www.epochconverter.com/) to get the time.
374 374  
378 +(% style="color:blue" %)**Timestamp:   **
375 375  
380 +Unit Timestamp Example: 650abc40(H) = 1695202368(D)
381 +
382 +Put the decimal value into this link([[https:~~/~~/www.epochconverter.com)>>https://www.epochconverter.com]]) to get the time.
383 +
384 +
376 376  === 2.2.3 ThingsBoard Payload(Type~=3) ===
377 377  
378 378  
379 379  Type3 payload special design for ThingsBoard, it will also configure other default server to ThingsBoard.
380 380  
381 -(% style="color:#4472c4" %)**{"IMEI":866207053462762,"temperature":29.2,"humidity":54.2,"battery":3.27,"signal":24}**
390 +(% style="color:#4472c4" %)** {"IMEI": "866207058378443","Model": "DDS45-NB","distance": 502,"battery": 3.57,"signal": 23}**
382 382  
392 +[[image:image-20230922094043-2.png||height="558" width="851"]]
383 383  
394 +
395 +=== ===
396 +
384 384  === 2.2.4 ThingSpeak Payload(Type~=1) ===
385 385  
386 386  
387 -This payload meets ThingSpeak platform requirement. It includes only four fields. Form 1~~4 are:
400 +This payload meets ThingSpeak platform requirement. It includes only four fields. Form 1~~3 are:
388 388  
389 -Temperature, Humidity, Battery & Signal. This payload type only valid for ThingsSpeak Platform
402 +Distance, Battery & Signal. This payload type only valid for ThingsSpeak Platform
390 390  
391 391  As below:
392 392  
393 -(% style="color:#4472c4" %)**field1=27.9&field2=49.9&field3=3.23&field4=28**
406 +(% style="color:#4472c4" %)**field1=Distance value&field2=Battery value&field3=Singal value**
394 394  
408 +[[image:image-20230921104741-1.png||height="565" width="826"]]
395 395  
410 +
396 396  == 2.3  ​Uplink Payload ==
397 397  
398 398  
... ... @@ -401,21 +401,28 @@
401 401  )))
402 402  
403 403  (((
404 -Uplink payload includes in total 8 bytes.
419 +Uplink payload includes in total 21 bytes.
405 405  )))
406 406  
407 407  (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %)
408 -|=(% style="width: 95px; background-color:#4F81BD;color:white" %)Size(bytes)|=(% style="width: 61px; background-color:#4F81BD;color:white" %)2|=(% style="background-color:#4F81BD;color:white" %)2|=(% style="background-color:#4F81BD;color:white" %)1|=(% style="background-color:#4F81BD;color:white" %)2|=(% style="background-color:#4F81BD;color:white" %)1
409 -|(% style="width:95px" %)Value|(% style="width:61px" %)[[BAT>>||anchor="H2.3.1A0BatteryInfo"]]|(((
410 -[[Distance>>||anchor="H2.3.2A0Distance"]]
411 -(unit: mm)
412 -)))|[[Digital Interrupt (Optional)>>||anchor="H2.3.3A0InterruptPin"]]|(((
413 -[[Temperature (Optional)>>||anchor="H2.3.4A0DS18B20Temperaturesensor"]]
414 -)))|[[Sensor Flag>>||anchor="H2.3.5A0SensorFlag"]]
423 +|=(% style="width: 95px; background-color:#4F81BD;color:white" %)Size(bytes)|=(% style="width: 61px; background-color:#4F81BD;color:white" %)8|=(% style="width: 61px; background-color:#4F81BD;color:white" %)2|=(% style="background-color:#4F81BD;color:white" %)2|=(% style="background-color:#4F81BD;color:white" %)1|=(% style="background-color: rgb(79, 129, 189); color: white; width: 49px;" %)1|=(% style="background-color: rgb(79, 129, 189); color: white; width: 79px;" %)1|=(% style="background-color:#4F81BD;color:white" %)2|=(% style="background-color:#4F81BD;color:white" %)4
424 +|(% style="width:95px" %)Value|(% style="width:61px" %)f+IMEI|(% style="width:61px" %)Ver|(% style="width:61px" %)[[BAT>>||anchor="H2.3.1A0BatteryInfo"]]|(% style="width:61px" %)(((
425 +Singal
415 415  
416 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/DDS20-LB_LoRaWAN_Ultrasonic_Liquid_Level_Sensor_User_Manual/WebHome/%E5%BE%AE%E4%BF%A1%E6%88%AA%E5%9B%BE_20230702135733.png?width=964&height=215&rev=1.1||alt="微信截图_20230702135733.png"]]
427 +Strength
428 +)))|(% style="width:49px" %)Mod|(% style="width:79px" %)[[Digital Interrupt >>||anchor="H2.3.2A0Interrupt"]]|(% style="width:61px" %)[[Distance>>||anchor="H2.3.3A0Distance"]](unit: mm)|(% style="width:61px" %)(((
429 +Timestamp
417 417  
431 +
432 +)))
418 418  
434 +If the cache upload mechanism is turned on, you will receive the payload shown in the figure below.
435 +
436 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:512px" %)
437 +|(% style="width:115px" %)**Frame header**|(% style="width:118px" %)**Frame data(1)**|(% style="width:116px" %)**Frame data(2)**|(% style="width:39px" %)**F…**|(% style="width:117px" %)**Frame data(X)**
438 +
439 +=== ===
440 +
419 419  === 2.3.1  Battery Info ===
420 420  
421 421  
... ... @@ -426,27 +426,9 @@
426 426  Ex2: 0x0B49 = 2889mV
427 427  
428 428  
429 -=== 2.3.2  Distance ===
451 +=== 2.3.2  Interrupt ===
430 430  
431 431  
432 -(((
433 -Get the distance. Flat object range 30mm - 4500mm.
434 -)))
435 -
436 -(((
437 -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" %)** **
438 -
439 -(% style="color:blue" %)**0B05(H) = 2821 (D) = 2821 mm.**
440 -)))
441 -
442 -* If the sensor value is 0x0000, it means system doesn't detect ultrasonic sensor.
443 -
444 -* If the sensor value lower than 0x001E (30mm), the sensor value will be 0x00.
445 -
446 -
447 -=== 2.3.3  Interrupt Pin ===
448 -
449 -
450 450  This data field shows if this packet is generated by interrupt or not.
451 451  
452 452  **Example:**
... ... @@ -456,28 +456,24 @@
456 456  0x01: Interrupt Uplink Packet.
457 457  
458 458  
459 -=== 2.3.4  DS18B20 Temperature sensor ===
463 +=== 2.3.3  Distance ===
460 460  
461 461  
462 -This is optional, user can connect external DS18B20 sensor to the +3.3v, 1-wire and GND pin . and this field will report temperature.
466 +(((
467 +Get the distance. Flat object range 30mm - 4500mm.
468 +)))
463 463  
464 -**Example**:
470 +(((
471 +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" %)** **
465 465  
466 -If payload is: 0105H:  (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree
473 +(% style="color:blue" %)**0B05(H) = 2821 (D) = 2821 mm.**
474 +)))
467 467  
468 -If payload is: FF3FH :  (FF3F & FC00 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
476 +* If the sensor value is 0x0000, it means system doesn't detect ultrasonic sensor.
469 469  
478 +* If the sensor value lower than 0x001E (30mm), the sensor value will be 0x00.
470 470  
471 -=== 2.3.5  Sensor Flag ===
472 -
473 -
474 474  (((
475 -0x01: Detect Ultrasonic Sensor
476 -)))
477 -
478 -(((
479 -0x00: No Ultrasonic Sensor
480 -
481 481  
482 482  )))
483 483  
... ... @@ -496,7 +496,7 @@
496 496  == 2.5 Multi-Samplings and One uplink ==
497 497  
498 498  
499 -To save battery life, DDS45-NB will sample temperature & humidity data every 15 minutes and send one uplink every 2 hours. So each uplink it will include 8 stored data + 1 real-time data. They are defined by:
499 +To save battery life, DDS45-NB will sample Distance data every 15 minutes and send one uplink every 2 hours. So each uplink it will include 8 stored data + 1 real-time data. They are defined by:
500 500  
501 501  * (% style="color:#037691" %)**AT+TR=900**   (%%) ~/~/ The unit is seconds, and the default is to record data once every 900 seconds (15 minutes, the minimum can be set to 180 seconds)
502 502  
... ... @@ -524,7 +524,6 @@
524 524  
525 525  * (% style="color:#037691" %)**AT+INTMOD=3  **(%%) ~/~/ Trigger by rising edge
526 526  
527 -
528 528  = 3. Configure DDS45-NB =
529 529  
530 530  == 3.1 Configure Methods ==
... ... @@ -536,7 +536,6 @@
536 536  
537 537  * 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]].
538 538  
539 -
540 540  == 3.2 AT Commands Set ==
541 541  
542 542  
... ... @@ -642,7 +642,6 @@
642 642  
643 643  * 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]]**.
644 644  
645 -
646 646  = 6. FAQ =
647 647  
648 648  == 6.1 How can I access t BC660K-GL AT Commands? ==
... ... @@ -725,7 +725,6 @@
725 725  
726 726  * Weight / pcs : 180g
727 727  
728 -
729 729  = 10. Support =
730 730  
731 731  
image-20230920173352-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +63.7 KB
Content
image-20230920175015-3.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +76.6 KB
Content
image-20230921104741-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +74.2 KB
Content
image-20230922093814-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +125.1 KB
Content
image-20230922094043-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +104.1 KB
Content
image-20231010090810-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +539.0 KB
Content