Skip to Content

Changes for page wiki_test

Last modified by Mengting Qiu on 2024/09/05 17:35
From version 100.2
edited by Xiaoling
on 2023/10/10 09:10
Change comment: There is no comment for this version
To version 84.27
edited by Xiaoling
on 2023/09/12 08:54
Change comment: Update document after refactoring.

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 DDS45-NB NB-IoT Distance Detection Sensor ==
16 +== 1.1 What is DDS20-NB NB-IoT Ultrasonic liquid level Sensor ==
23 23  
24 24  
25 -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.
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 -It detects the distance (% style="color:blue" %)** between the measured object and the sensor**(%%), and and send IoT platform via NB-IoT network.
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 -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.
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 -DDS45-NB (% style="color:blue" %)**supports BLE configure **(%%)and(% style="color:blue" %)** OTA update**(%%) which make user easy to use.
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 -DDS45-NB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long-term use up to several years.
27 +DDS20-NB (% style="color:blue" %)**supports BLE configure **(%%)and(% style="color:blue" %)** OTA update**(%%) which make user easy to use.
34 34  
35 -DDS45-NB has optional built-in SIM card and default IoT server connection version. Which makes it works with simple configuration.
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 -[[image:image-20230912102813-2.png||height="320" width="923"]]
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 39  
34 +[[image:image-20230911140426-2.png||height="320" width="951"]]
35 +
36 +
40 40  == 1.2 ​Features ==
41 41  
42 42  
43 43  * NB-IoT Bands: B1/B2/B3/B4/B5/B8/B12/B13/B17/B18/B19/B20/B25/B28/B66/B70/B85 @H-FDD
44 44  * Ultra-low power consumption
45 -* Distance Detection by Ultrasonic technology
46 -* Flat object range 30mm - 4500mm
47 -* Accuracy: ±(1cm+S*0.3%) (S: Distance)
48 -* Measure Angle: 60°
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,65 +99,152 @@
99 99  * STOP Mode: 10uA @ 3.3v
100 100  * Max transmit power: 350mA@3.3v
101 101  
102 -== 1.4 Rated environmental conditions ==
103 103  
104 104  
105 -(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:500px" %)
106 -|(% style="background-color:#4f81bd; color:white; width:163px" %)**Item**|(% style="background-color:#4f81bd; color:white; width:90px" %)**Minimum value**|(% style="background-color:#4f81bd; color:white; width:70px" %)**Typical value**|(% style="background-color:#4f81bd; color:white; width:87px" %)**Maximum value**|(% style="background-color:#4f81bd; color:white; width:40px" %)**Unit**|(% style="background-color:#4f81bd; color:white; width:50px" %)**Remarks**
107 -|(% style="width:174px" %)Storage temperature|(% style="width:86px" %)-25|(% style="width:66px" %)25|(% style="width:90px" %)80|(% style="width:48px" %)℃|(% style="width:203px" %)
108 -|(% style="width:174px" %)Storage humidity|(% style="width:86px" %) |(% style="width:66px" %)65%|(% style="width:90px" %)90%|(% style="width:48px" %)RH|(% style="width:203px" %)(1)
109 -|(% style="width:174px" %)Operating temperature|(% style="width:86px" %)-15|(% style="width:66px" %)25|(% style="width:90px" %)60|(% style="width:48px" %)℃|(% style="width:203px" %)
110 -|(% style="width:174px" %)Working humidity|(% style="width:86px" %)(((
111 -
103 +== 1.4 Suitable Container & Liquid ==
112 112  
113 -
114 -)))|(% style="width:66px" %)65%|(% style="width:90px" %)80%|(% style="width:48px" %)RH|(% style="width:203px" %)(1)
115 115  
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 +
116 116  (((
117 -(% style="color:red" %)**Remarks: (1) a. When the ambient temperature is 0-39 ℃, the maximum humidity is 90% (non-condensing);       **
128 +(% style="color:blue" %)**Step 2**(%%):  **Polish the installation point.**
129 +)))
118 118  
119 -(% style="color:red" %)** b. When the ambient temperature is 40-50 ℃, the highest humidity is the highest humidity in the natural world at the current temperature (no condensation)**
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 +)))
120 120  
121 -
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.**
122 122  )))
123 123  
124 -== 1.5 Effective measurement range Reference beam pattern ==
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 +)))
125 125  
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 +)))
126 126  
127 -(% style="color:blue" %)**1. The tested object is a white cylindrical tube made of PVC, with a height of 100cm and a diameter of 7.5cm.**
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 +)))
128 128  
129 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS75%20-%20LoRaWAN%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654852253176-749.png?rev=1.1||alt="1654852253176-749.png"]]
130 130  
160 +(((
161 +(% style="color:blue" %)**LED Status:**
162 +)))
131 131  
132 -(% style="color:blue" %)**2. The object to be tested is a "corrugated cardboard box" perpendicular to the central axis of 0 °, and the length * width is 60cm * 50cm.**
164 +* (((
165 +**Onboard LED**: When power on device, the onboard LED will fast blink 4 times which means detect the sensor well.
166 +)))
133 133  
134 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS75%20-%20LoRaWAN%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654852175653-550.png?rev=1.1||alt="1654852175653-550.png"]]
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 +)))
135 135  
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 +)))
136 136  
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 +
137 137  == 1.6 Applications ==
138 138  
139 139  
140 -* Horizontal distance measurement
141 -* Liquid level measurement
142 -* Parking management system
143 -* Object proximity and presence detection
144 -* Intelligent trash can management system
145 -* Robot obstacle avoidance
146 -* Automatic control
147 -* Sewer
148 -* Bottom water level monitoring
217 +* Smart liquid control solution
149 149  
150 -== 1.7 Sleep mode and working mode ==
219 +* Smart liquefied gas solution
151 151  
152 152  
153 -(% 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.
154 154  
155 -(% 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 ==
156 156  
157 157  
158 -== 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.
159 159  
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.
160 160  
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 +
161 161  [[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675071855856-879.png]]
162 162  
163 163  
... ... @@ -174,12 +174,14 @@
174 174  )))
175 175  |(% 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.
176 176  
177 -== 1.9 BLE connection ==
178 178  
179 179  
180 -DDS45-NB support BLE remote configure and firmware update.
265 +== 1.10 BLE connection ==
181 181  
182 182  
268 +DDS20-NB support BLE remote configure and firmware update.
269 +
270 +
183 183  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:
184 184  
185 185  * Press button to send an uplink
... ... @@ -189,19 +189,19 @@
189 189  If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode.
190 190  
191 191  
192 -== 1.10 Pin Definitions & Switch ==
280 +== 1.11 Pin Definitions & Switch ==
193 193  
194 194  
195 195  [[image:image-20230819104805-5.png]]
196 196  
197 197  
198 -=== 1.10.1 Jumper JP2 ===
286 +=== 1.11.1 Jumper JP2 ===
199 199  
200 200  
201 201  Power on Device when put this jumper.
202 202  
203 203  
204 -=== 1.10.2 BOOT MODE / SW1 ===
292 +=== 1.11.2 BOOT MODE / SW1 ===
205 205  
206 206  
207 207  **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.
... ... @@ -209,7 +209,7 @@
209 209  **2)** (% style="color:blue" %)**Flash**(%%): work mode, device starts to work and send out console output for further debug
210 210  
211 211  
212 -=== 1.10.3 Reset Button ===
300 +=== 1.11.3 Reset Button ===
213 213  
214 214  
215 215  Press to reboot the device.
... ... @@ -217,8 +217,9 @@
217 217  (% style="display:none" %)
218 218  
219 219  
220 -== 1.11 Mechanical ==
308 +== 1.12 Mechanical ==
221 221  
310 +
222 222  [[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"]]
223 223  
224 224  [[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"]]
... ... @@ -228,27 +228,28 @@
228 228  
229 229  (% style="color:blue" %)**Probe Mechanical:**
230 230  
231 -[[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"]]
232 232  
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"]]
233 233  
234 234  
235 -= 2. Use DDS45-NB to communicate with IoT Server =
325 += 2. Use DDS20-NB to communicate with IoT Server =
236 236  
237 237  == 2.1 Send data to IoT server via NB-IoT network ==
238 238  
239 239  
240 -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.
241 241  
242 242  
243 243  Below shows the network structure:
244 244  
245 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/DDS45-NB_NB-IoT_Distance_Detection_Sensor_User_Manual/WebHome/image-20230912102813-2.png?width=923&height=320&rev=1.1||alt="image-20230912102813-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"]]
246 246  
247 247  
248 -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.
249 249  
250 250  
251 -(% 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.
252 252  
253 253  * 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]].
254 254  
... ... @@ -278,13 +278,13 @@
278 278  [[image:image-20230819113244-11.png||height="141" width="367"]]
279 279  )))|(% style="width:170px" %)
280 280  
281 -(% 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]].
282 282  
283 283  
284 284  == 2.2 ​Payload Types ==
285 285  
286 286  
287 -To meet different server requirement, DDS45-NB supports different payload type.
377 +To meet different server requirement, DDS20-NB supports different payload type.
288 288  
289 289  **Includes:**
290 290  
... ... @@ -310,17 +310,16 @@
310 310  
311 311  This is the General Json Format. As below:
312 312  
313 -(% 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}}**
314 314  
315 315  
316 -[[image:image-20230920175015-3.png||height="613" width="890"]]
406 +(% style="color:red" %)**Notice, from above payload:**
317 317  
408 +* Temperature , Humidity , Battery & Signal are the value at uplink time.
318 318  
319 -(% 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.
320 320  
321 -* Distance , Battery & Signal are the value at uplink time.
322 322  
323 -* 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.
324 324  
325 325  === 2.2.2 HEX format Payload(Type~=0) ===
326 326  
... ... @@ -327,28 +327,23 @@
327 327  
328 328  This is the HEX Format. As below:
329 329  
330 -(% style="color:#4472c4" %)**f8662070583784430b640dda15010003a4650abc400000650ab8180000650ab4940000650ab10f0000650aad8b0000650aaa070000650aa6840000650aa3000000650a9308**
419 +(% style="color:#4472c4" %)**f86620705346276200640cba16010000000011011801e864d49c2d011a01e364d49925011901eb64d49871011901e564d497bd011a01e664d49709011901e964d49655011a01e864d495a1011a01e864d494ed011801e864d49439**
331 331  
332 -[[image:image-20230920172200-1.png||height="191" width="1047"]]
421 +[[image:1692424009971-458.png]]
333 333  
334 334  
335 -If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NB sensor uplink data.
336 -
337 -[[image:image-20230920173352-2.png||height="636" width="919"]]
338 -
339 -
340 340  (% style="color:blue" %)**Version:**
341 341  
342 342  These bytes include the hardware and software version.
343 343  
344 -(% 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
345 345  
346 -(% 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
347 347  
348 348  
349 349  (% style="color:blue" %)**BAT (Battery Info):**
350 350  
351 -Ex1: 0x0dda = 3546mV
435 +Ex1: 0x0CBA = 3258mV
352 352  
353 353  
354 354  (% style="color:blue" %)**Signal Strength:**
... ... @@ -355,7 +355,7 @@
355 355  
356 356  NB-IoT Network signal Strength.
357 357  
358 -**Ex1: 0x15 = 21**
442 +**Ex1: 0x16 = 22**
359 359  
360 360  **0**  -113dBm or less
361 361  
... ... @@ -368,78 +368,60 @@
368 368  **99**    Not known or not detectable
369 369  
370 370  
371 -(% style="color:blue" %)**Distance:  **
455 +(% style="color:blue" %)**TimeStamp:   **
372 372  
373 -Ex1: 0x03a4 = 932 mm
457 +Unit TimeStamp Example: 64d49439(H) = 1691653177(D)
374 374  
459 +Put the decimal value into this link(https:~/~/www.epochconverter.com/) to get the time.
375 375  
376 -(% style="color:blue" %)**Timestamp:   **
377 377  
378 -Unit Timestamp Example: 650abc40(H) = 1695202368(D)
379 -
380 -Put the decimal value into this link([[https:~~/~~/www.epochconverter.com)>>https://www.epochconverter.com]]) to get the time.
381 -
382 -
383 383  === 2.2.3 ThingsBoard Payload(Type~=3) ===
384 384  
385 385  
386 386  Type3 payload special design for ThingsBoard, it will also configure other default server to ThingsBoard.
387 387  
388 -(% 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}**
389 389  
390 -[[image:image-20230922094043-2.png||height="558" width="851"]]
391 391  
392 -
393 -=== ===
394 -
395 395  === 2.2.4 ThingSpeak Payload(Type~=1) ===
396 396  
397 397  
398 -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:
399 399  
400 -Distance, Battery & Signal. This payload type only valid for ThingsSpeak Platform
475 +Temperature, Humidity, Battery & Signal. This payload type only valid for ThingsSpeak Platform
401 401  
402 402  As below:
403 403  
404 -(% 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**
405 405  
406 -[[image:image-20230921104741-1.png||height="565" width="826"]]
407 407  
408 -
409 409  == 2.3  ​Uplink Payload ==
410 410  
411 411  
412 412  (((
413 -DDS45-NB will uplink payload via LoRaWAN with below payload format: 
486 +DDS20-NB will uplink payload via LoRaWAN with below payload format: 
414 414  )))
415 415  
416 416  (((
417 -Uplink payload includes in total 21 bytes.
490 +Uplink payload includes in total 8 bytes.
418 418  )))
419 419  
420 420  (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %)
421 -|=(% 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
422 -|(% style="width:95px" %)Value|(% style="width:61px" %)f+IMEI|(% style="width:61px" %)Ver|(% style="width:61px" %)[[BAT>>||anchor="H2.3.1A0BatteryInfo"]]|(% style="width:61px" %)(((
423 -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"]]
424 424  
425 -Strength
426 -)))|(% 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" %)(((
427 -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"]]
428 428  
429 -
430 -)))
431 431  
432 -If the cache upload mechanism is turned on, you will receive the payload shown in the figure below.
433 -
434 -(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:512px" %)
435 -|(% 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)**
436 -
437 -=== ===
438 -
439 439  === 2.3.1  Battery Info ===
440 440  
441 441  
442 -Check the battery voltage for DDS45-NB.
508 +Check the battery voltage for DDS20-NB.
443 443  
444 444  Ex1: 0x0B45 = 2885mV
445 445  
... ... @@ -446,9 +446,28 @@
446 446  Ex2: 0x0B49 = 2889mV
447 447  
448 448  
449 -=== 2.3.2  Interrupt ===
515 +=== 2.3.2  Distance ===
450 450  
451 451  
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 +
452 452  This data field shows if this packet is generated by interrupt or not.
453 453  
454 454  **Example:**
... ... @@ -458,24 +458,28 @@
458 458  0x01: Interrupt Uplink Packet.
459 459  
460 460  
461 -=== 2.3.3  Distance ===
546 +=== 2.3.4  DS18B20 Temperature sensor ===
462 462  
463 463  
464 -(((
465 -Get the distance. Flat object range 30mm - 4500mm.
466 -)))
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.
467 467  
468 -(((
469 -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**:
470 470  
471 -(% style="color:blue" %)**0B05(H) = 2821 (D) = 2821 mm.**
472 -)))
553 +If payload is: 0105H:  (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree
473 473  
474 -* 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.
475 475  
476 -* If the sensor value lower than 0x001E (30mm), the sensor value will be 0x00.
477 477  
558 +=== 2.3.5  Sensor Flag ===
559 +
560 +
478 478  (((
562 +0x01: Detect Ultrasonic Sensor
563 +)))
564 +
565 +(((
566 +0x00: No Ultrasonic Sensor
567 +
479 479  
480 480  )))
481 481  
... ... @@ -494,7 +494,7 @@
494 494  == 2.5 Multi-Samplings and One uplink ==
495 495  
496 496  
497 -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:
498 498  
499 499  * (% 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)
500 500  
... ... @@ -508,7 +508,7 @@
508 508  == 2.6 Trggier an uplink by external interrupt ==
509 509  
510 510  
511 -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.
512 512  
513 513  (% style="color:blue" %)**AT command:**
514 514  
... ... @@ -522,17 +522,21 @@
522 522  
523 523  * (% style="color:#037691" %)**AT+INTMOD=3  **(%%) ~/~/ Trigger by rising edge
524 524  
525 -= 3. Configure DDS45-NB =
526 526  
615 +
616 += 3. Configure DDS20-NB =
617 +
527 527  == 3.1 Configure Methods ==
528 528  
529 529  
530 -DDS45-NB supports below configure method:
621 +DDS20-NB supports below configure method:
531 531  
532 532  * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
533 533  
534 534  * 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]].
535 535  
627 +
628 +
536 536  == 3.2 AT Commands Set ==
537 537  
538 538  
... ... @@ -616,7 +616,7 @@
616 616  = 4. Battery & Power Consumption =
617 617  
618 618  
619 -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.
620 620  
621 621  [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
622 622  
... ... @@ -630,7 +630,7 @@
630 630  
631 631  * Fix bugs.
632 632  
633 -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]]**
634 634  
635 635  Methods to Update Firmware:
636 636  
... ... @@ -638,6 +638,8 @@
638 638  
639 639  * 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]]**.
640 640  
734 +
735 +
641 641  = 6. FAQ =
642 642  
643 643  == 6.1 How can I access t BC660K-GL AT Commands? ==
... ... @@ -648,49 +648,23 @@
648 648  [[See BC660K-GL AT Command set>>url:https://www.dropbox.com/sh/5f6ssda5fum8rvs/AABT68l8ZzWOvZ5eg2qwOoFda?dl=0]]
649 649  
650 650  
651 -== 6.2 Can I use DDS45-NB in condensation environment? ==
746 += 7.  Trouble Shooting =
652 652  
748 +== 7.1  Why i always see 0x0000 or 0 for the distance value? ==
653 653  
654 -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.
655 655  
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.
656 656  
657 -= 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.
658 658  
659 -== 7.1 Why does the sensor reading show 0 or "No sensor" ==
756 +
757 +)))
660 660  
661 -
662 -~1. The measurement object is very close to the sensor, but in the blind spot of the sensor.
663 -
664 -2. Sensor wiring is disconnected
665 -
666 -3. Not using the correct decoder
667 -
668 -
669 -== 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 ==
670 -
671 -
672 -1) Please check if there is something on the probe affecting its measurement (condensed water, volatile oil, etc.)
673 -
674 -2) Does it change with temperature, temperature will affect its measurement
675 -
676 -3) If abnormal data occurs, you can turn on DEBUG mode, Please use downlink or AT COMMAN to enter DEBUG mode.
677 -
678 -downlink command: (% style="color:blue" %)**F1 01**(%%), AT command: (% style="color:blue" %)**AT+DDEBUG=1**
679 -
680 -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
681 -
682 -[[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"]]
683 -
684 -
685 -Its original payload will be longer than other data. Even though it is being parsed, it can be seen that it is abnormal data.
686 -
687 -Please send the data to us for check.
688 -
689 -
690 690  = 8. Order Info =
691 691  
692 692  
693 -Part Number: (% style="color:blue" %)**DDS45-NB-XX**
762 +Part Number: (% style="color:blue" %)**DDS20-NB-XX**
694 694  
695 695  (% style="color:red" %)**XX**(%%):
696 696  
... ... @@ -706,7 +706,7 @@
706 706  
707 707  (% style="color:#037691" %)**Package Includes**:
708 708  
709 -* DDS45-NB NB-IoT Distance Detection sensor x 1
778 +* DDS20-NB NB-IoT Ultrasonic liquid level sensor x 1
710 710  
711 711  * External antenna x 1
712 712  
... ... @@ -720,6 +720,8 @@
720 720  
721 721  * Weight / pcs : 180g
722 722  
792 +
793 +
723 723  = 10. Support =
724 724  
725 725  
image-20230912085600-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -646.5 KB
Content
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