Skip to Content

Changes for page wiki_test

Last modified by Mengting Qiu on 2024/09/05 17:35
From version 101.4
edited by Xiaoling
on 2023/10/10 10:37
Change comment: There is no comment for this version
To version 85.1
edited by Xiaoling
on 2023/09/12 08:56
Change comment: Uploaded new attachment "image-20230912085600-1.png", version {1}

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -SW3L-NB -- NB-IoT Flow Sensor User Manual
1 +DDS45-NB_NB-IoT_Distance_Detection_Sensor_User_Manual
Content
... ... @@ -1,13 +1,7 @@
1 1  (% style="text-align:center" %)
2 -[[image:image-20231010090810-1.png||height="518" width="839"]]
2 +[[image:image-20230911134259-1.png||height="570" width="570"]]
3 3  
4 4  
5 -
6 -
7 -
8 -
9 -
10 -
11 11  **Table of Contents:**
12 12  
13 13  {{toc/}}
... ... @@ -19,33 +19,36 @@
19 19  
20 20  = 1. Introduction =
21 21  
22 -== 1.1 What is SW3L-NB NB-IoT Flow Sensor ==
16 +== 1.1 What is DDS20-NB NB-IoT Ultrasonic liquid level Sensor ==
23 23  
24 24  
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**.
19 +The Dragino DDS20-NB is a (% style="color:blue" %)**NB-IoT Ultrasonic liquid level sensor**(%%) for Internet of Things solution. It uses (% style="color:blue" %)**none-contact method **(%%)to measure the (% style="color:blue" %)**height of liquid**(%%) in a container without opening the container, and send IoT platform via NB-IoT network.
26 26  
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.
21 +The DDS20-NB sensor is installed directly below the container to detect the height of the liquid level. User doesn't need to open a hole on the container to be tested. The none-contact measurement makes the measurement safety, easier and possible for some strict situation. 
28 28  
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**.
23 +DDS20-NB uses (% style="color:blue" %)**ultrasonic sensing technology**(%%) for distance measurement. DDS20-NB is of high accuracy to measure various liquid such as: (% style="color:blue" %)**toxic substances**, **strong acids**, **strong alkalis**(%%) and (% style="color:blue" %)**various pure liquids**(%%) in high-temperature and high-pressure airtight containers.
30 30  
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.
25 +DDS20-NB supports different uplink methods including (% style="color:blue" %)**MQTT, MQTTs, UDP & TCP**(%%) for different application requirement, and support uplinks to various IoT Servers.
32 32  
33 -SW3L-NB (% style="color:blue" %)**supports BLE configure **(%%)and(% style="color:blue" %)** OTA update**(%%) which make user easy to use.
27 +DDS20-NB (% style="color:blue" %)**supports BLE configure **(%%)and(% style="color:blue" %)** OTA update**(%%) which make user easy to use.
34 34  
35 -SW3L-NB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long-term use up to several years.
29 +DDS20-NB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long-term use up to severa years.
36 36  
37 -SW3L-NB has optional built-in SIM card and default IoT server connection version. Which makes it works with simple configuration.
31 +DDS20-NB has optional built-in SIM card and default IoT server connection version. Which makes it works with simple configuration.
38 38  
39 -[[image:image-20231010091546-2.png||height="348" width="909"]]
40 40  
34 +[[image:image-20230911140426-2.png||height="320" width="951"]]
41 41  
36 +
42 42  == 1.2 ​Features ==
43 43  
44 44  
45 45  * NB-IoT Bands: B1/B2/B3/B4/B5/B8/B12/B13/B17/B18/B19/B20/B25/B28/B66/B70/B85 @H-FDD
46 46  * Ultra-low power consumption
47 -* Upload water flow volume
48 -* Monitor water waste
42 +* Liquid Level Measurement by Ultrasonic technology
43 +* Measure through container, No need to contact Liquid
44 +* Valid level range 20mm - 2000mm
45 +* Accuracy: ±(5mm+S*0.5%) (S: Measure Value)
49 49  * Multiply Sampling and one uplink
50 50  * Support Bluetooth v5.1 remote configure and update firmware
51 51  * Uplink on periodically
... ... @@ -54,6 +54,8 @@
54 54  * 8500mAh Battery for long term use
55 55  * Nano SIM card slot for NB-IoT SIM
56 56  
54 +
55 +
57 57  == 1.3 Specification ==
58 58  
59 59  
... ... @@ -99,28 +99,152 @@
99 99  * STOP Mode: 10uA @ 3.3v
100 100  * Max transmit power: 350mA@3.3v
101 101  
102 -(% class="wikigeneratedid" id="H1.4Ratedenvironmentalconditions" %)
103 -(% style="display:none" %) (%%)
104 104  
102 +
103 +== 1.4 Suitable Container & Liquid ==
104 +
105 +
106 +* Solid Wall container such as: steel, iron, glass, ceramics, non-foaming plastics etc.
107 +* Container shape is regular, and surface is smooth.
108 +* Container Thickness:
109 +** Pure metal material.  2~~8mm, best is 3~~5mm
110 +** Pure non metal material: <10 mm
111 +* Pure liquid without irregular deposition.
112 +
113 +
114 +
115 +(% style="display:none" %)
116 +
117 +== 1.5 Install DDS20-NB ==
118 +
119 +
120 +(% style="color:blue" %)**Step 1**(%%):  ** Choose the installation point.**
121 +
122 +DDS20-NB (% style="color:red" %)**MUST**(%%) be installed on the container bottom middle position.
123 +
124 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS20%20-%20LoRaWAN%20Liquid%20Level%20Sensor%20User%20Manual/WebHome/image-20220615091045-3.png?rev=1.1||alt="image-20220615091045-3.png"]]
125 +
126 +
127 +(((
128 +(% style="color:blue" %)**Step 2**(%%):  **Polish the installation point.**
129 +)))
130 +
131 +(((
132 +For Metal Surface with paint, it is important to polish the surface, first use crude sand paper to polish the paint level , then use exquisite sand paper to polish the metal level to make it shine & smooth.
133 +)))
134 +
135 +[[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/image-20230613143052-5.png?rev=1.1||alt="image-20230613143052-5.png"]]
136 +
137 +
138 +No polish needed if the container is shine metal surface without paint or non-metal container.
139 +
140 +[[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/image-20230613143125-6.png?rev=1.1||alt="image-20230613143125-6.png"]]
141 +
142 +
143 +(((
144 +(% style="color:blue" %)**Step3:   **(%%)**Test the installation point.**
145 +)))
146 +
147 +(((
148 +Power on DDS20-NB, check if the blue LED is on, If the blue LED is on, means the sensor works. Then put ultrasonic coupling paste on the sensor and put it tightly on the installation point.
149 +)))
150 +
151 +(((
152 +It is necessary to put the coupling paste between the sensor and the container, otherwise DDS20-NB won't detect the liquid level.
153 +)))
154 +
155 +(((
156 +After paste the DDS20-NB well, power on DDS20-NB. In the first 30 seconds of booting, device will check the sensors status and BLUE LED will show the status as below. After 30 seconds, BLUE LED will be off to save battery life.
157 +)))
158 +
159 +
160 +(((
161 +(% style="color:blue" %)**LED Status:**
162 +)))
163 +
164 +* (((
165 +**Onboard LED**: When power on device, the onboard LED will fast blink 4 times which means detect the sensor well.
166 +)))
167 +
168 +* (((
169 +(% style="color:blue" %)**BLUE LED**(% style="color:red" %)** always ON**(%%): Sensor is power on but doesn't detect liquid. There is problem in installation point.
170 +)))
171 +* (((
172 +(% style="color:blue" %)**BLUE LED**(% style="color:red" %)** slowly blinking**(%%): Sensor detects Liquid Level, The installation point is good.
173 +)))
174 +
175 +(((
176 +DDS20-NB will enter into low power mode at 30 seconds after system reset or power on, Blue LED will be off after that.
177 +)))
178 +
179 +
180 +(((
181 +(% style="color:red" %)**Note :**(%%)** (% style="color:blue" %)Ultrasonic coupling paste(%%)**(% style="color:blue" %) (%%) is subjected in most shipping way. So the default package doesn't include it and user needs to purchase locally.
182 +)))
183 +
184 +
185 +(((
186 +(% style="color:blue" %)**Step4:   **(%%)**Install use Epoxy ab glue.**
187 +)))
188 +
189 +(((
190 +Prepare Eproxy AB glue.
191 +)))
192 +
193 +(((
194 +Put Eproxy AB glue in the sensor and press it hard on the container installation point.
195 +)))
196 +
197 +(((
198 +Reset DDS20-NB and see if the BLUE LED is slowly blinking.
199 +)))
200 +
201 +[[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/image-20230809172509-1.png?rev=1.1||alt="image-20230809172509-1.png"]]
202 +
203 +(((
204 +(% style="color:red" %)**Note :**(% style="color:red; display:none" %)** **
205 +
206 +(% style="color:red" %)**1:**(%%)** (% style="color:blue" %)Eproxy AB glue(%%)** needs 3~~ 5 minutes to stable attached. we can use other glue material to keep it in the position.
207 +)))
208 +
209 +(((
210 +(% style="color:red" %)**2:**(%%)** (% style="color:blue" %)Eproxy AB glue(%%)** is subjected in most shipping way. So the default package doesn't include it and user needs to purchase locally.
211 +)))
212 +
213 +
105 105  == 1.6 Applications ==
106 106  
107 107  
108 -* Flow Sensor application
109 -* Water Control
110 -* Toilet Flow Sensor
111 -* Monitor Waste water
217 +* Smart liquid control solution
112 112  
113 -== 1.7 Sleep mode and working mode ==
219 +* Smart liquefied gas solution
114 114  
115 115  
116 -(% 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.
117 117  
118 -(% 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.
223 +== 1.7 Precautions ==
119 119  
120 120  
121 -== 1.8 Button & LEDs ==
226 +* At room temperature, containers of different materials, such as steel, glass, iron, ceramics, non-foamed plastics and other dense materials, have different detection blind areas and detection limit heights.
122 122  
228 +* For containers of the same material at room temperature, the detection blind zone and detection limit height are also different for the thickness of the container.
123 123  
230 +* When the detected liquid level exceeds the effective detection value of the sensor, and the liquid level of the liquid to be measured shakes or tilts, the detected liquid height is unstable.
231 +
232 +(% style="display:none" %)
233 +
234 +
235 +
236 +== 1.8 Sleep mode and working mode ==
237 +
238 +
239 +(% 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.
240 +
241 +(% 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.
242 +
243 +
244 +== 1.9 Button & LEDs ==
245 +
246 +
124 124  [[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675071855856-879.png]]
125 125  
126 126  
... ... @@ -137,12 +137,14 @@
137 137  )))
138 138  |(% 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.
139 139  
140 -== 1.9 BLE connection ==
141 141  
142 142  
143 -DDS45-NB support BLE remote configure and firmware update.
265 +== 1.10 BLE connection ==
144 144  
145 145  
268 +DDS20-NB support BLE remote configure and firmware update.
269 +
270 +
146 146  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:
147 147  
148 148  * Press button to send an uplink
... ... @@ -152,19 +152,19 @@
152 152  If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode.
153 153  
154 154  
155 -== 1.10 Pin Definitions & Switch ==
280 +== 1.11 Pin Definitions & Switch ==
156 156  
157 157  
158 158  [[image:image-20230819104805-5.png]]
159 159  
160 160  
161 -=== 1.10.1 Jumper JP2 ===
286 +=== 1.11.1 Jumper JP2 ===
162 162  
163 163  
164 164  Power on Device when put this jumper.
165 165  
166 166  
167 -=== 1.10.2 BOOT MODE / SW1 ===
292 +=== 1.11.2 BOOT MODE / SW1 ===
168 168  
169 169  
170 170  **1)** (% style="color:blue" %)**ISP**(%%): upgrade mode, device won't have any signal in this mode. but ready for upgrade firmware. LED won't work. Firmware won't run.
... ... @@ -172,7 +172,7 @@
172 172  **2)** (% style="color:blue" %)**Flash**(%%): work mode, device starts to work and send out console output for further debug
173 173  
174 174  
175 -=== 1.10.3 Reset Button ===
300 +=== 1.11.3 Reset Button ===
176 176  
177 177  
178 178  Press to reboot the device.
... ... @@ -180,8 +180,9 @@
180 180  (% style="display:none" %)
181 181  
182 182  
183 -== 1.11 Mechanical ==
308 +== 1.12 Mechanical ==
184 184  
310 +
185 185  [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual/WebHome/1675143884058-338.png?rev=1.1||alt="1675143884058-338.png"]]
186 186  
187 187  [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual/WebHome/1675143899218-599.png?rev=1.1||alt="1675143899218-599.png"]]
... ... @@ -191,27 +191,28 @@
191 191  
192 192  (% style="color:blue" %)**Probe Mechanical:**
193 193  
194 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS45%20-%20LoRaWAN%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654915562090-396.png?rev=1.1||alt="1654915562090-396.png"]]
320 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS20%20-%20LoRaWAN%20Liquid%20Level%20Sensor%20User%20Manual/WebHome/image-20220615090910-1.png?rev=1.1||alt="image-20220615090910-1.png"]]
195 195  
322 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS20%20-%20LoRaWAN%20Liquid%20Level%20Sensor%20User%20Manual/WebHome/image-20220615090910-2.png?rev=1.1||alt="image-20220615090910-2.png"]]
196 196  
197 197  
198 -= 2. Use DDS45-NB to communicate with IoT Server =
325 += 2. Use DDS20-NB to communicate with IoT Server =
199 199  
200 200  == 2.1 Send data to IoT server via NB-IoT network ==
201 201  
202 202  
203 -The DDS45-NB is equipped with a NB-IoT module, the pre-loaded firmware in DDS45-NB will get environment data from sensors and send the value to local NB-IoT network via the NB-IoT module.  The NB-IoT network will forward this value to IoT server via the protocol defined by DDS45-NB.
330 +The DDS20-NB is equipped with a NB-IoT module, the pre-loaded firmware in DDS20-NB will get environment data from sensors and send the value to local NB-IoT network via the NB-IoT module.  The NB-IoT network will forward this value to IoT server via the protocol defined by DDS20-NB.
204 204  
205 205  
206 206  Below shows the network structure:
207 207  
208 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L-NB_NB-IoT_Flow_Sensor_User_Manual/WebHome/image-20231010091546-2.png?width=909&height=348&rev=1.1||alt="image-20231010091546-2.png"]]
335 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/DDS20-NB_NB-IoT_Ultrasonic_Liquid_Level_Sensor_User_Manual/WebHome/image-20230911140426-2.png?width=951&height=320&rev=1.1||alt="image-20230911140426-2.png"]]
209 209  
210 210  
211 -There are two version: (% style="color:blue" %)**-GE**(%%) and (% style="color:blue" %)**-1D**(%%) version of DDS45-NB.
338 +There are two version: (% style="color:blue" %)**-GE**(%%) and (% style="color:blue" %)**-1D**(%%) version of DDS20-NB.
212 212  
213 213  
214 -(% style="color:blue" %)**GE Version**(%%): This version doesn't include SIM card or point to any IoT server. User needs to use AT Commands to configure below two steps to set DDS45-NB send data to IoT server.
341 +(% style="color:blue" %)**GE Version**(%%): This version doesn't include SIM card or point to any IoT server. User needs to use AT Commands to configure below two steps to set DDS20-NB send data to IoT server.
215 215  
216 216  * Install NB-IoT SIM card and configure APN. See instruction of [[Attach Network>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H2.AttachNetwork]].
217 217  
... ... @@ -241,13 +241,13 @@
241 241  [[image:image-20230819113244-11.png||height="141" width="367"]]
242 242  )))|(% style="width:170px" %)
243 243  
244 -(% style="color:blue" %)**1D Version**(%%): This version has 1NCE SIM card pre-installed and configure to send value to DataCake. User Just need to select the sensor type in DataCake and Activate DDS45-NB and user will be able to see data in DataCake. See here for [[DataCake Config Instruction>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.4Datacake]].
371 +(% style="color:blue" %)**1D Version**(%%): This version has 1NCE SIM card pre-installed and configure to send value to DataCake. User Just need to select the sensor type in DataCake and Activate DDS20-NB and user will be able to see data in DataCake. See here for [[DataCake Config Instruction>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.4Datacake]].
245 245  
246 246  
247 247  == 2.2 ​Payload Types ==
248 248  
249 249  
250 -To meet different server requirement, DDS45-NB supports different payload type.
377 +To meet different server requirement, DDS20-NB supports different payload type.
251 251  
252 252  **Includes:**
253 253  
... ... @@ -273,17 +273,16 @@
273 273  
274 274  This is the General Json Format. As below:
275 275  
276 -(% 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}}**
403 +(% style="color:#4472c4" %)**{"IMEI":866207053462762,"temperature":29.2,"humidity":54.2,"battery":3.27,"signal":24,"Model":DDS20-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}}**
277 277  
278 278  
279 -[[image:image-20230920175015-3.png||height="613" width="890"]]
406 +(% style="color:red" %)**Notice, from above payload:**
280 280  
408 +* Temperature , Humidity , Battery & Signal are the value at uplink time.
281 281  
282 -(% style="color:red" %)**Notice, from above payload:**
410 +* 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.
283 283  
284 -* Distance , Battery & Signal are the value at uplink time.
285 285  
286 -* 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.
287 287  
288 288  === 2.2.2 HEX format Payload(Type~=0) ===
289 289  
... ... @@ -290,28 +290,23 @@
290 290  
291 291  This is the HEX Format. As below:
292 292  
293 -(% style="color:#4472c4" %)**f8662070583784430b640dda15010003a4650abc400000650ab8180000650ab4940000650ab10f0000650aad8b0000650aaa070000650aa6840000650aa3000000650a9308**
419 +(% style="color:#4472c4" %)**f86620705346276200640cba16010000000011011801e864d49c2d011a01e364d49925011901eb64d49871011901e564d497bd011a01e664d49709011901e964d49655011a01e864d495a1011a01e864d494ed011801e864d49439**
294 294  
295 -[[image:image-20230920172200-1.png||height="191" width="1047"]]
421 +[[image:1692424009971-458.png]]
296 296  
297 297  
298 -If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NB sensor uplink data.
299 -
300 -[[image:image-20230920173352-2.png||height="636" width="919"]]
301 -
302 -
303 303  (% style="color:blue" %)**Version:**
304 304  
305 305  These bytes include the hardware and software version.
306 306  
307 -(% style="color:#037691" %)**Higher byte:**(%%) Specify Sensor Model: 0x0b for DDS45-NB
428 +(% style="color:#037691" %)**Higher byte:**(%%) Specify Sensor Model: 0x00 for DDS20-NB
308 308  
309 -(% style="color:#037691" %)**Lower byte:**(%%) Specify the software version: 0x64=100, means firmware version 1.0.0
430 +(% style="color:#037691" %)**Lower byte:**(%%) Specify the software version: 0x64=100, means firmware version 100
310 310  
311 311  
312 312  (% style="color:blue" %)**BAT (Battery Info):**
313 313  
314 -Ex1: 0x0dda = 3546mV
435 +Ex1: 0x0CBA = 3258mV
315 315  
316 316  
317 317  (% style="color:blue" %)**Signal Strength:**
... ... @@ -318,7 +318,7 @@
318 318  
319 319  NB-IoT Network signal Strength.
320 320  
321 -**Ex1: 0x15 = 21**
442 +**Ex1: 0x16 = 22**
322 322  
323 323  **0**  -113dBm or less
324 324  
... ... @@ -331,78 +331,60 @@
331 331  **99**    Not known or not detectable
332 332  
333 333  
334 -(% style="color:blue" %)**Distance:  **
455 +(% style="color:blue" %)**TimeStamp:   **
335 335  
336 -Ex1: 0x03a4 = 932 mm
457 +Unit TimeStamp Example: 64d49439(H) = 1691653177(D)
337 337  
459 +Put the decimal value into this link(https:~/~/www.epochconverter.com/) to get the time.
338 338  
339 -(% style="color:blue" %)**Timestamp:   **
340 340  
341 -Unit Timestamp Example: 650abc40(H) = 1695202368(D)
342 -
343 -Put the decimal value into this link([[https:~~/~~/www.epochconverter.com)>>https://www.epochconverter.com]]) to get the time.
344 -
345 -
346 346  === 2.2.3 ThingsBoard Payload(Type~=3) ===
347 347  
348 348  
349 349  Type3 payload special design for ThingsBoard, it will also configure other default server to ThingsBoard.
350 350  
351 -(% style="color:#4472c4" %)** {"IMEI": "866207058378443","Model": "DDS45-NB","distance": 502,"battery": 3.57,"signal": 23}**
467 +(% style="color:#4472c4" %)**{"IMEI":866207053462762,"temperature":29.2,"humidity":54.2,"battery":3.27,"signal":24}**
352 352  
353 -[[image:image-20230922094043-2.png||height="558" width="851"]]
354 354  
355 -
356 -=== ===
357 -
358 358  === 2.2.4 ThingSpeak Payload(Type~=1) ===
359 359  
360 360  
361 -This payload meets ThingSpeak platform requirement. It includes only four fields. Form 1~~3 are:
473 +This payload meets ThingSpeak platform requirement. It includes only four fields. Form 1~~4 are:
362 362  
363 -Distance, Battery & Signal. This payload type only valid for ThingsSpeak Platform
475 +Temperature, Humidity, Battery & Signal. This payload type only valid for ThingsSpeak Platform
364 364  
365 365  As below:
366 366  
367 -(% style="color:#4472c4" %)**field1=Distance value&field2=Battery value&field3=Singal value**
479 +(% style="color:#4472c4" %)**field1=27.9&field2=49.9&field3=3.23&field4=28**
368 368  
369 -[[image:image-20230921104741-1.png||height="565" width="826"]]
370 370  
371 -
372 372  == 2.3  ​Uplink Payload ==
373 373  
374 374  
375 375  (((
376 -DDS45-NB will uplink payload via LoRaWAN with below payload format: 
486 +DDS20-NB will uplink payload via LoRaWAN with below payload format: 
377 377  )))
378 378  
379 379  (((
380 -Uplink payload includes in total 21 bytes.
490 +Uplink payload includes in total 8 bytes.
381 381  )))
382 382  
383 383  (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %)
384 -|=(% 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
385 -|(% style="width:95px" %)Value|(% style="width:61px" %)f+IMEI|(% style="width:61px" %)Ver|(% style="width:61px" %)[[BAT>>||anchor="H2.3.1A0BatteryInfo"]]|(% style="width:61px" %)(((
386 -Singal
494 +|=(% 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
495 +|(% style="width:95px" %)Value|(% style="width:61px" %)[[BAT>>||anchor="H2.3.1A0BatteryInfo"]]|(((
496 +[[Distance>>||anchor="H2.3.2A0Distance"]]
497 +(unit: mm)
498 +)))|[[Digital Interrupt (Optional)>>||anchor="H2.3.3A0InterruptPin"]]|(((
499 +[[Temperature (Optional)>>||anchor="H2.3.4A0DS18B20Temperaturesensor"]]
500 +)))|[[Sensor Flag>>||anchor="H2.3.5A0SensorFlag"]]
387 387  
388 -Strength
389 -)))|(% 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" %)(((
390 -Timestamp
502 +[[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"]]
391 391  
392 -
393 -)))
394 394  
395 -If the cache upload mechanism is turned on, you will receive the payload shown in the figure below.
396 -
397 -(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:512px" %)
398 -|(% 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)**
399 -
400 -=== ===
401 -
402 402  === 2.3.1  Battery Info ===
403 403  
404 404  
405 -Check the battery voltage for DDS45-NB.
508 +Check the battery voltage for DDS20-NB.
406 406  
407 407  Ex1: 0x0B45 = 2885mV
408 408  
... ... @@ -409,9 +409,28 @@
409 409  Ex2: 0x0B49 = 2889mV
410 410  
411 411  
412 -=== 2.3.2  Interrupt ===
515 +=== 2.3.2  Distance ===
413 413  
414 414  
518 +(((
519 +Get the distance. Flat object range 20mm - 2000mm.
520 +)))
521 +
522 +(((
523 +For example, if the data you get from the register is **0x06 0x05**, the distance between the sensor and the measured object is(% style="color:#4472c4" %)** **
524 +
525 +(% style="color:blue" %)**0605(H) = 1541 (D) = 1541 mm.**
526 +)))
527 +
528 +* If the sensor value is 0x0000, it means system doesn't detect ultrasonic sensor.
529 +
530 +* If the sensor value lower than 0x0014 (20mm), the sensor value will be invalid.
531 +
532 +
533 +
534 +=== 2.3.3  Interrupt Pin ===
535 +
536 +
415 415  This data field shows if this packet is generated by interrupt or not.
416 416  
417 417  **Example:**
... ... @@ -421,24 +421,28 @@
421 421  0x01: Interrupt Uplink Packet.
422 422  
423 423  
424 -=== 2.3.3  Distance ===
546 +=== 2.3.4  DS18B20 Temperature sensor ===
425 425  
426 426  
427 -(((
428 -Get the distance. Flat object range 30mm - 4500mm.
429 -)))
549 +This is optional, user can connect external DS18B20 sensor to the +3.3v, 1-wire and GND pin . and this field will report temperature.
430 430  
431 -(((
432 -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" %)** **
551 +**Example**:
433 433  
434 -(% style="color:blue" %)**0B05(H) = 2821 (D) = 2821 mm.**
435 -)))
553 +If payload is: 0105H:  (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree
436 436  
437 -* If the sensor value is 0x0000, it means system doesn't detect ultrasonic sensor.
555 +If payload is: FF3FH :  (FF3F & FC00 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
438 438  
439 -* If the sensor value lower than 0x001E (30mm), the sensor value will be 0x00.
440 440  
558 +=== 2.3.5  Sensor Flag ===
559 +
560 +
441 441  (((
562 +0x01: Detect Ultrasonic Sensor
563 +)))
564 +
565 +(((
566 +0x00: No Ultrasonic Sensor
567 +
442 442  
443 443  )))
444 444  
... ... @@ -457,7 +457,7 @@
457 457  == 2.5 Multi-Samplings and One uplink ==
458 458  
459 459  
460 -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:
586 +To save battery life, DDS20-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:
461 461  
462 462  * (% 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)
463 463  
... ... @@ -471,7 +471,7 @@
471 471  == 2.6 Trggier an uplink by external interrupt ==
472 472  
473 473  
474 -DDS45-NB has an external trigger interrupt function. Users can use the PB15 pin to trigger the upload of data packets.
600 +DDS20-NB has an external trigger interrupt function. Users can use the PB15 pin to trigger the upload of data packets.
475 475  
476 476  (% style="color:blue" %)**AT command:**
477 477  
... ... @@ -485,17 +485,21 @@
485 485  
486 486  * (% style="color:#037691" %)**AT+INTMOD=3  **(%%) ~/~/ Trigger by rising edge
487 487  
488 -= 3. Configure DDS45-NB =
489 489  
615 +
616 += 3. Configure DDS20-NB =
617 +
490 490  == 3.1 Configure Methods ==
491 491  
492 492  
493 -DDS45-NB supports below configure method:
621 +DDS20-NB supports below configure method:
494 494  
495 495  * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
496 496  
497 497  * 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]].
498 498  
627 +
628 +
499 499  == 3.2 AT Commands Set ==
500 500  
501 501  
... ... @@ -579,7 +579,7 @@
579 579  = 4. Battery & Power Consumption =
580 580  
581 581  
582 -DDS45-NB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
712 +DDS20-NB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
583 583  
584 584  [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
585 585  
... ... @@ -593,7 +593,7 @@
593 593  
594 594  * Fix bugs.
595 595  
596 -Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/l0bszumyrmil3yv/AAAg8LYGeAgDsD_ycCnweD72a?dl=0]]**
726 +Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/nyzeu0lf0amcaek/AAC6UZrqyTcAyJgXOH7l9F9Ka?dl=0]]**
597 597  
598 598  Methods to Update Firmware:
599 599  
... ... @@ -601,6 +601,8 @@
601 601  
602 602  * 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]]**.
603 603  
734 +
735 +
604 604  = 6. FAQ =
605 605  
606 606  == 6.1 How can I access t BC660K-GL AT Commands? ==
... ... @@ -611,49 +611,23 @@
611 611  [[See BC660K-GL AT Command set>>url:https://www.dropbox.com/sh/5f6ssda5fum8rvs/AABT68l8ZzWOvZ5eg2qwOoFda?dl=0]]
612 612  
613 613  
614 -== 6.2 Can I use DDS45-NB in condensation environment? ==
746 += 7.  Trouble Shooting =
615 615  
748 +== 7.1  Why i always see 0x0000 or 0 for the distance value? ==
616 616  
617 -DDS45-NB is not suitable to be used in condensation environment. Condensation on the DDS45-NB probe will affect the reading and always got 0.
618 618  
751 +(((
752 +DDS20-NB has a strict [[**installation requirement**>>||anchor="H1.5A0InstallDDS20-NB"]]. Please make sure the installation method exactly follows up with the installation requirement. Otherwise, the reading might be always 0x00.
619 619  
620 -= 7. Trouble Shooting =
754 +If you have followed the instruction requirement exactly but still see the 0x00 reading issue, please. please double-check the decoder, you can check the raw payload to verify.
621 621  
622 -== 7.1 Why does the sensor reading show 0 or "No sensor" ==
756 +
757 +)))
623 623  
624 -
625 -~1. The measurement object is very close to the sensor, but in the blind spot of the sensor.
626 -
627 -2. Sensor wiring is disconnected
628 -
629 -3. Not using the correct decoder
630 -
631 -
632 -== 7.2 Abnormal readings The gap between multiple readings is too large or the gap between the readings and the actual value is too large ==
633 -
634 -
635 -1) Please check if there is something on the probe affecting its measurement (condensed water, volatile oil, etc.)
636 -
637 -2) Does it change with temperature, temperature will affect its measurement
638 -
639 -3) If abnormal data occurs, you can turn on DEBUG mode, Please use downlink or AT COMMAN to enter DEBUG mode.
640 -
641 -downlink command: (% style="color:blue" %)**F1 01**(%%), AT command: (% style="color:blue" %)**AT+DDEBUG=1**
642 -
643 -4) After entering the debug mode, it will send 20 pieces of data at a time, and you can send its uplink to us for analysis
644 -
645 -[[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-20230113135125-2.png?width=1057&height=136&rev=1.1||alt="image-20230113135125-2.png"]]
646 -
647 -
648 -Its original payload will be longer than other data. Even though it is being parsed, it can be seen that it is abnormal data.
649 -
650 -Please send the data to us for check.
651 -
652 -
653 653  = 8. Order Info =
654 654  
655 655  
656 -Part Number: (% style="color:blue" %)**DDS45-NB-XX**
762 +Part Number: (% style="color:blue" %)**DDS20-NB-XX**
657 657  
658 658  (% style="color:red" %)**XX**(%%):
659 659  
... ... @@ -669,7 +669,7 @@
669 669  
670 670  (% style="color:#037691" %)**Package Includes**:
671 671  
672 -* DDS45-NB NB-IoT Distance Detection sensor x 1
778 +* DDS20-NB NB-IoT Ultrasonic liquid level sensor x 1
673 673  
674 674  * External antenna x 1
675 675  
... ... @@ -683,6 +683,8 @@
683 683  
684 684  * Weight / pcs : 180g
685 685  
792 +
793 +
686 686  = 10. Support =
687 687  
688 688  
image-20230912102813-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -110.4 KB
Content
image-20230920172200-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -37.9 KB
Content
image-20230920173352-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -63.7 KB
Content
image-20230920175015-3.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -76.6 KB
Content
image-20230921104741-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -74.2 KB
Content
image-20230922093814-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -125.1 KB
Content
image-20230922094043-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -104.1 KB
Content
image-20231010090810-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -539.0 KB
Content
image-20231010091546-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -95.6 KB
Content