Skip to Content
Version 106.1 by Mengting Qiu on 2024/03/16 11:29
Show last authors
1 (% aria-label="image-20230911134259-1.png image widget" contenteditable="false" role="region" tabindex="-1" %)
2 (((
3 (% data-widget="image" style="text-align:center" %)
4 [[image:image-20230911134259-1.png||height="570" width="570"]](% title="Click and drag to resize" %)​
5
6 (% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||height="15" role="presentation" title="Click and drag to move" width="15"]]
7 )))
8
9
10 **Table of Contents:**
11
12 (% aria-label="macro:toc widget" contenteditable="false" role="region" tabindex="-1" %)
13 (((
14 {{toc/}}
15
16 (% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||height="15" role="presentation" title="Click and drag to move" width="15"]]
17 )))
18
19
20
21
22
23
24 = 1. Introduction =
25
26 == 1.1 What is DDS20-NB NB-IoT Ultrasonic liquid level Sensor ==
27
28
29 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.
30
31 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. 
32
33 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.
34
35 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.
36
37 DDS20-NB (% style="color:blue" %)**supports BLE configure **(%%)and(% style="color:blue" %)** OTA update**(%%) which make user easy to use.
38
39 DDS20-NB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long-term use up to several years.
40
41 DDS20-NB has optional built-in SIM card and default IoT server connection version. Which makes it works with simple configuration.
42
43
44 (% aria-label="image-20230911140426-2.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20230911140426-2.png||data-widget="image" height="320" width="951"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
45
46
47 == 1.2 ​Features ==
48
49
50 * NB-IoT Bands: B1/B2/B3/B4/B5/B8/B12/B13/B17/B18/B19/B20/B25/B28/B66/B70/B85 @H-FDD
51 * Ultra-low power consumption
52 * Liquid Level Measurement by Ultrasonic technology
53 * Measure through container, No need to contact Liquid
54 * Valid level range 20mm - 2000mm
55 * Accuracy: ±(5mm+S*0.5%) (S: Measure Value)
56 * Multiply Sampling and one uplink
57 * Support Bluetooth v5.1 remote configure and update firmware
58 * Uplink on periodically
59 * Downlink to change configure
60 * IP66 Waterproof Enclosure
61 * 8500mAh Battery for long term use
62 * Nano SIM card slot for NB-IoT SIM
63
64 == 1.3 Specification ==
65
66
67 (% style="color:blue" %)**Common DC Characteristics:**
68
69 * Supply Voltage: 2.5v ~~ 3.6v
70 * Operating Temperature: -40 ~~ 85°C
71
72 (% style="color:blue" %)**NB-IoT Spec:**
73
74 (% style="color:#037691" %)**NB-IoT Module: BC660K-GL**
75
76 (% style="color:#037691" %)**Support Bands:**
77
78 * B1 @H-FDD: 2100MHz
79 * B2 @H-FDD: 1900MHz
80 * B3 @H-FDD: 1800MHz
81 * B4 @H-FDD: 2100MHz
82 * B5 @H-FDD: 860MHz
83 * B8 @H-FDD: 900MHz
84 * B12 @H-FDD: 720MHz
85 * B13 @H-FDD: 740MHz
86 * B17 @H-FDD: 730MHz
87 * B18 @H-FDD: 870MHz
88 * B19 @H-FDD: 870MHz
89 * B20 @H-FDD: 790MHz
90 * B25 @H-FDD: 1900MHz
91 * B28 @H-FDD: 750MHz
92 * B66 @H-FDD: 2000MHz
93 * B70 @H-FDD: 2000MHz
94 * B85 @H-FDD: 700MHz
95
96 (% style="color:blue" %)**Battery:**
97
98 * Li/SOCI2 un-chargeable battery
99 * Capacity: 8500mAh
100 * Self Discharge: <1% / Year @ 25°C
101 * Max continuously current: 130mA
102 * Max boost current: 2A, 1 second
103
104 (% style="color:blue" %)**Power Consumption**
105
106 * STOP Mode: 10uA @ 3.3v
107 * Max transmit power: 350mA@3.3v
108
109 == 1.4 Suitable Container & Liquid ==
110
111
112 * Solid Wall container such as: steel, iron, glass, ceramics, non-foaming plastics etc.
113 * Container shape is regular, and surface is smooth.
114 * Container Thickness:
115 ** Pure metal material.  2~~8mm, best is 3~~5mm
116 ** Pure non metal material: <10 mm
117 * Pure liquid without irregular deposition.
118
119 (% style="display:none" %)
120
121 == 1.5 Install DDS20-NB ==
122
123
124 (% style="color:blue" %)**Step 1**(%%):  ** Choose the installation point.**
125
126 DDS20-NB (% style="color:red" %)**MUST**(%%) be installed on the container bottom middle position.
127
128 (% aria-label="image-20220615091045-3.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[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" data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
129
130
131 (((
132 (% style="color:blue" %)**Step 2**(%%):  **Polish the installation point.**
133 )))
134
135 (((
136 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.
137 )))
138
139 (% aria-label="image-20230613143052-5.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[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" data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
140
141
142 No polish needed if the container is shine metal surface without paint or non-metal container.
143
144 (% aria-label="image-20230613143125-6.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[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" data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
145
146
147 (((
148 (% style="color:blue" %)**Step3:   **(%%)**Test the installation point.**
149 )))
150
151 (((
152 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.
153 )))
154
155 (((
156 It is necessary to put the coupling paste between the sensor and the container, otherwise DDS20-NB won't detect the liquid level.
157 )))
158
159 (((
160 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.
161 )))
162
163
164 (((
165 (% style="color:blue" %)**LED Status:**
166 )))
167
168 * (((
169 **Onboard LED**: When power on device, the onboard LED will fast blink 4 times which means detect the sensor well.
170 )))
171
172 * (((
173 (% 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.
174 )))
175 * (((
176 (% style="color:blue" %)**BLUE LED**(% style="color:red" %)** slowly blinking**(%%): Sensor detects Liquid Level, The installation point is good.
177 )))
178
179 (((
180 DDS20-NB will enter into low power mode at 30 seconds after system reset or power on, Blue LED will be off after that.
181 )))
182
183 (((
184 (% 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.
185 )))
186
187
188 (((
189 (% style="color:blue" %)**Step4:   **(%%)**Install use Epoxy ab glue.**
190
191
192 After ensuring that the ultrasonic coupling paste is applied to the sensor and adheres closely to the mounting point, and the sensor can work normally, add AB epoxy glue.
193
194 ((% style="color:red" %)**Note :**(%%)The ultrasonic coupling agent is used to help the sensor detect the liquid in the container, and the epoxy AB glue is used to fix the probe. Both need to be used at the same time.)
195 )))
196
197 (((
198 Prepare Eproxy AB glue.
199 )))
200
201 (((
202 Put Eproxy AB glue in the sensor and press it hard on the container installation point.
203 )))
204
205 (((
206 Reset DDS20-NB and see if the BLUE LED is slowly blinking.
207 )))
208
209 (% aria-label="image-20230809172509-1.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[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" data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​(%%)     
210
211 (((
212 (% style="color:red" %)**Note :**(% style="color:red; display:none" %)** **
213
214 (% 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.
215 )))
216
217 (((
218 (% 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.
219 )))
220
221
222 == 1.6 Applications ==
223
224
225 * Smart liquid control solution
226
227 * Smart liquefied gas solution
228
229 == 1.7 Precautions ==
230
231
232 * 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.
233
234 * 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.
235
236 * 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.
237
238 (% style="display:none" %)
239
240
241
242 == 1.8 Sleep mode and working mode ==
243
244
245 (% 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.
246
247 (% 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.
248
249
250 == 1.9 Button & LEDs ==
251
252
253 (% aria-label="1675071855856-879.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675071855856-879.png||data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
254
255
256 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
257 |=(% style="width: 167px;background-color:#4F81BD;color:white" %)**Behavior on ACT**|=(% style="width: 117px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width:225px;background-color:#4F81BD;color:white" %)**Action**
258 |(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:117px" %)Send an uplink|(% style="width:225px" %)(((
259 If sensor has already attached to NB-IoT network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once.
260 Meanwhile, BLE module will be active and user can connect via BLE to configure device.
261 )))
262 |(% style="width:167px" %)Pressing ACT for more than 3s|(% style="width:117px" %)Active Device|(% style="width:225px" %)(((
263 (% style="color:green" %)**Green led**(%%) will fast blink 5 times, device will enter (% style="color:#037691" %)**OTA mode**(%%) for 3 seconds. And then start to attach NB-IoT network.
264 (% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network.
265 Once sensor is active, BLE module will be active and user can connect via BLE to configure device, no matter if device attach NB-IoT network or not.
266 )))
267 |(% 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.
268
269 (% style="color:red" %)**Note: When the device is executing a program, the buttons may become invalid. It is best to press the buttons after the device has completed the program execution.**
270
271
272 == 1.10 BLE connection ==
273
274
275 DDS20-NB support BLE remote configure and firmware update.
276
277
278 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:
279
280 * Press button to send an uplink
281 * Press button to active device.
282 * Device Power on or reset.
283
284 If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode.
285
286
287 == 1.11 Pin Definitions , Switch & SIM Direction ==
288
289
290 (% aria-label="image-20230819104805-5.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20230819104805-5.png||data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
291
292
293 === 1.11.1 Jumper JP2 ===
294
295
296 Power on Device when put this jumper.
297
298
299 === 1.11.2 BOOT MODE / SW1 ===
300
301
302 **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.
303
304 **2)** (% style="color:blue" %)**Flash**(%%): work mode, device starts to work and send out console output for further debug
305
306
307 === 1.11.3 Reset Button ===
308
309
310 Press to reboot the device.
311
312 (% style="display:none" %)
313
314
315 === 1.11.4 SIM Card Direction ===
316
317
318 See this link. [[How to insert SIM Card>>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]].
319
320
321 == 1.12 Mechanical ==
322
323
324 (% aria-label="1675143884058-338.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[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" data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
325
326 (% aria-label="1675143899218-599.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[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" data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
327
328 (% aria-label="1675143909447-639.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[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/1675143909447-639.png?rev=1.1||alt="1675143909447-639.png" data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
329
330
331 (% style="color:blue" %)**Probe Mechanical:**
332
333 (% aria-label="image-20220615090910-1.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[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" data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
334
335 (% aria-label="image-20220615090910-2.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[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" data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
336
337
338 = 2. Use DDS20-NB to communicate with IoT Server =
339
340 == 2.1 Send data to IoT server via NB-IoT network ==
341
342
343 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.
344
345
346 Below shows the network structure:
347
348 (% aria-label="image-20230911140426-2.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[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" data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
349
350
351 There are two version: (% style="color:blue" %)**-GE**(%%) and (% style="color:blue" %)**-1D**(%%) version of DDS20-NB.
352
353
354 (% 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.
355
356 * 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]].
357
358 * Set up sensor to point to IoT Server. See instruction of [[Configure to Connect Different Servers>>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.Configuretoconnecttodifferentservers]]. 
359
360 Below shows result of different server as a glance.
361
362 (% border="1" cellspacing="4" style="width:515px" %)
363 |(% style="background-color:#4f81bd; color:white; width:100px" %)**Servers**|(% style="background-color:#4f81bd; color:white; width:300px" %)**Dash Board**|(% style="background-color:#4f81bd; color:white; width:115px" %)**Comments**
364 |(% style="width:127px" %)[[Node-Red>>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.5A0Node-RedA028viaA0MQTT29]]|(% style="width:385px" %)(((
365 (% aria-label="image-20230819113244-8.png image widget" contenteditable="false" role="region" tabindex="-1" %)
366 (((
367 (% data-widget="image" style="text-align:center" %)
368 [[image:image-20230819113244-8.png||height="183" width="367"]](% title="Click and drag to resize" %)​
369
370 (% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||height="15" role="presentation" title="Click and drag to move" width="15"]]
371 )))
372 )))|(% style="width:170px" %)
373 |(% style="width:127px" %)[[DataCake>>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]]|(% style="width:385px" %)(((
374 (% aria-label="image-20230819113244-9.png image widget" contenteditable="false" role="region" tabindex="-1" %)
375 (((
376 (% data-widget="image" style="text-align:center" %)
377 [[image:image-20230819113244-9.png||height="119" width="367"]](% title="Click and drag to resize" %)​
378
379 (% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||height="15" role="presentation" title="Click and drag to move" width="15"]]
380 )))
381 )))|(% style="width:170px" %)
382 |(% style="width:127px" %)[[Tago.IO>>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.7A0Tago.ioA028viaA0MQTT29]]|(% style="width:385px" %) |(% style="width:170px" %)
383 |(% style="width:127px" %)[[General UDP>>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.1GeneralA0UDPA0Connection]]|(% style="width:385px" %)Raw Payload. Need Developer to design Dash Board|(% style="width:170px" %)
384 |(% style="width:127px" %)[[General MQTT>>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.2GeneralA0MQTTA0Connection]]|(% style="width:385px" %)Raw Payload. Need Developer to design Dash Board|(% style="width:170px" %)
385 |(% style="width:127px" %)[[ThingSpeak>>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.3A0ThingSpeakA028viaA0MQTT29]]|(% style="width:385px" %)(((
386 (% aria-label="image-20230819113244-10.png image widget" contenteditable="false" role="region" tabindex="-1" %)
387 (((
388 (% data-widget="image" style="text-align:center" %)
389 [[image:image-20230819113244-10.png||height="104" width="367"]](% title="Click and drag to resize" %)​
390
391 (% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||height="15" role="presentation" title="Click and drag to move" width="15"]]
392 )))
393 )))|(% style="width:170px" %)
394 |(% style="width:127px" %)[[ThingsBoard>>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.6A0ThingsBoard.CloudA028viaA0MQTT29]]|(% style="width:385px" %)(((
395 (% aria-label="image-20230819113244-11.png image widget" contenteditable="false" role="region" tabindex="-1" %)
396 (((
397 (% data-widget="image" style="text-align:center" %)
398 [[image:image-20230819113244-11.png||height="141" width="367"]](% title="Click and drag to resize" %)​
399
400 (% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||height="15" role="presentation" title="Click and drag to move" width="15"]]
401 )))
402 )))|(% style="width:170px" %)
403
404 (% 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]].
405
406
407 == 2.2 ​Payload Types ==
408
409
410 To meet different server requirement, DDS20-NB supports different payload type.
411
412 **Includes:**
413
414 * [[General JSON format payload>>||anchor="H2.2.1GeneralJsonFormat28Type3D529"]]. (Type=5)
415
416 * [[HEX format Payload>>||anchor="H2.2.2HEXformatPayload28Type3D029"]]. (Type=0)
417
418 * [[ThingSpeak Format>>||anchor="H2.2.4ThingSpeakPayload28Type3D129"]]. (Type=1)
419
420 * [[ThingsBoard Format>>||anchor="H2.2.3ThingsBoardPayload28Type3D329"]]. (Type=3)
421
422 User can specify the payload type when choose the connection protocol. Example:
423
424 (% style="color:#037691" %)**AT+PRO=2,0**  (%%) ~/~/ Use UDP Connection & hex Payload
425
426 (% style="color:#037691" %)**AT+PRO=2,5**   (%%) ~/~/ Use UDP Connection & Json Payload
427
428 (% style="color:#037691" %)**AT+PRO=3,5 ** (%%) ~/~/ Use MQTT Connection & Json Payload
429
430
431 === 2.2.1 General Json Format(Type~=5) ===
432
433
434 This is the General Json Format. As below:
435
436 (% style="color:#4472c4" %)**{"IMEI":"866207058378443","Model":"DDS20-NB","distance":38,"battery":3.57,"signal":24,"1":{38,2023/09/20 02:51:33},"2":{38,2023/09/20 02:36:33},"3":{0,2023/09/20 02:08:29},"4":{0,2023/09/20 01:27:18},"5":{0,2023/09/20 01:12:19},"6":{0,2023/09/20 00:57:19},"7":{0,2023/09/18 09:58:53},"8":{0,2023/09/18 09:43:53}}**
437
438
439 (% aria-label="image-20230920110813-4.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20230920110813-4.png||data-widget="image" height="673" width="975"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
440
441
442 (% style="color:red" %)**Notice, from above payload:**
443
444 * Temperature , Humidity , Battery & Signal are the value at uplink time.
445
446 * 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.
447
448 === 2.2.2 HEX format Payload(Type~=0) ===
449
450
451 This is the HEX Format. As below:
452
453 (% style="color:#4472c4" %)**f8662070583784430a640dfd1801000026650a57780000650a541d0000650a4a760000650a46f30000650a436f000065081f5d000065081bd90000650818550eaf65080e1f **
454
455 (% aria-label="image-20230920104818-3.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20230920104818-3.png||data-widget="image" height="210" width="1052"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
456
457
458 If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NB sensor uplink data.
459
460 (% aria-label="image-20230920104047-2.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20230920104047-2.png||data-widget="image" height="657" width="952"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
461
462 (% style="color:blue" %)**Version:**
463
464 These bytes include the hardware and software version.
465
466 (% style="color:#037691" %)**Higher byte:**(%%) Specify Sensor Model: 0x0a for DDS20-NB
467
468 (% style="color:#037691" %)**Lower byte:**(%%) Specify the software version: 0x64=100, means firmware version 1.0.0
469
470
471 (% style="color:blue" %)**BAT (Battery Info):**
472
473 Ex1: 0x0dfd = 3581mV
474
475
476 (% style="color:blue" %)**Signal Strength:**
477
478 NB-IoT Network signal Strength.
479
480 **Ex1: 0x18 = 24**
481
482 **0**  -113dBm or less
483
484 **1**  -111dBm
485
486 **2...30** -109dBm... -53dBm
487
488 **31**   -51dBm or greater
489
490 **99**    Not known or not detectable
491
492
493 (% style="color:blue" %)**Distance:  **
494
495 Ex1: 0x0026 = 38 mm
496
497
498 (% style="color:blue" %)**TimeStamp:   **
499
500 Unit TimeStamp Example: 650a541d(H) = 1695175709(D)
501
502 Put the decimal value into this link ([[https:~~/~~/www.epochconverter.com)>>https://www.epochconverter.com]]）to get the time.
503
504
505 === 2.2.3 ThingsBoard Payload(Type~=3) ===
506
507
508 Type3 payload special design for ThingsBoard, it will also configure other default server to ThingsBoard.
509
510 (% style="color:#4472c4" %)**{"IMEI": "866207058378443","Model": "DDS20-NB","distance": 40,"battery": 3.55, "signal": 20}**
511
512 (% aria-label="image-20230922095654-1.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20230922095654-1.png||data-widget="image" height="529" width="939"]](% style="background:url(~"http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png~") rgba(220, 220, 220, 0.5); left:0px; top:-15px" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
513
514
515 === 2.2.4 ThingSpeak Payload(Type~=1) ===
516
517
518 This payload meets ThingSpeak platform requirement. It includes only four fields. Form 1~~3 are:
519
520 Distance, Battery & Signal. This payload type only valid for ThingsSpeak Platform
521
522 As below:
523
524 (% style="color:#4472c4" %)**field1=Distance value&field2=Battery value&field3=Signal value**
525
526 (% aria-label="image-20230920113340-5.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20230920113340-5.png||data-widget="image" height="562" width="935"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]]
527
528 (% title="Click and drag to resize" %)​
529
530 == 2.3  ​Uplink Payload ==
531
532
533 (((
534 DDS20-NB will uplink payload via NB-IoT with below payload format: 
535 )))
536
537 (((
538 Uplink payload includes in total 21 bytes.
539 )))
540
541 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %)
542 |=(% style="width: 60px; background-color:#4F81BD;color:white" %)Size(bytes)|=(% style="width: 40px; background-color:#4F81BD;color:white" %)8|=(% style="width: 40px; background-color:#4F81BD;color:white" %)2|=(% style="width: 40px;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
543 |(% style="width:95px" %)Value|(% style="width:61px" %)f+IMEI|(% style="width:61px" %)Ver|(% style="width:61px" %)[[BAT>>||anchor="H2.3.1A0BatteryInfo"]]|(% style="width:61px" %)(((
544 Signal Strength
545 )))|(% 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" %)Timestamp
546
547 If the cache upload mechanism is turned on, you will receive the payload shown in the figure below.
548
549 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:512px" %)
550 |(% 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)**
551
552 === 2.3.1  Battery Info ===
553
554
555 Check the battery voltage for DDS20-NB.
556
557 Ex1: 0x0B45 = 2885mV
558
559 Ex2: 0x0B49 = 2889mV
560
561
562 === 2.3.2  Interrupt ===
563
564
565 This data field shows if this packet is generated by interrupt or not.
566
567 **Example:**
568
569 0x00: Normal uplink packet.
570
571 0x01: Interrupt Uplink Packet.
572
573
574 === 2.3.3  Distance ===
575
576
577 (((
578 Get the distance. Flat object range 20mm - 2000mm.
579 )))
580
581 (((
582 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" %)** **
583
584 (% style="color:blue" %)**0605(H) = 1541 (D) = 1541 mm.**
585 )))
586
587 * If the sensor value is 0x0000, it means system doesn't detect ultrasonic sensor.
588
589 * If the sensor value lower than 0x0014 (20mm), the sensor value will be invalid.
590
591 (((
592
593
594
595 )))
596
597 == 2.4 Test Uplink and Change Update Interval ==
598
599
600 By default, Sensor will send uplinks (% style="color:blue" %)**every 2 hours**(%%) & AT+NOUD=8
601
602 User can use below commands to change the (% style="color:blue" %)**uplink interval**.
603
604 (% style="color:#037691" %)**AT+TDC=600 ** (%%) ~/~/ Set Update Interval to 600s
605
606 User can also push the button for more than 1 seconds to activate an uplink.
607
608
609 == 2.5 Multi-Samplings and One uplink ==
610
611
612 To save battery life, DDS20-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:
613
614 * (% 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)
615
616 * (% style="color:#037691" %)**AT+NOUD=8**     (%%)~/~/  The device uploads 8 sets of recorded data by default. Up to 32 sets of record data can be uploaded.
617
618 The diagram below explains the relationship between TR, NOUD, and TDC more clearly:
619
620 (% aria-label="1692424376354-959.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:1692424376354-959.png||data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
621
622
623 == 2.6 Trggier an uplink by external interrupt ==
624
625
626 DDS20-NB has an external trigger interrupt function. Users can use the PB15 pin to trigger the upload of data packets.
627
628 (% style="color:blue" %)**AT command:**
629
630 * (% style="color:#037691" %)**AT+INTMOD **(%%) ~/~/ Set the trigger interrupt mode
631
632 * (% style="color:#037691" %)**AT+INTMOD=0 **(%%) ~/~/ Disable Interrupt
633
634 * (% style="color:#037691" %)**AT+INTMOD=1 **(%%) ~/~/ Trigger by rising and falling edge
635
636 * (% style="color:#037691" %)**AT+INTMOD=2 **(%%) ~/~/ Trigger by falling edge
637
638 * (% style="color:#037691" %)**AT+INTMOD=3  **(%%) ~/~/ Trigger by rising edge
639
640 = 3. Configure DDS20-NB =
641
642 == 3.1 Configure Methods ==
643
644
645 DDS20-NB supports below configure method:
646
647 * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
648
649 * 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]].
650
651 == 3.2 AT Commands Set ==
652
653
654 AT+<CMD>?        : Help on <CMD>
655
656 AT+<CMD>         : Run <CMD>
657
658 AT+<CMD>=<value> : Set the value
659
660 AT+<CMD>=?       : Get the value
661
662
663 (% style="color:blue" %)**General Commands**      
664
665 AT                    : Attention       
666
667 AT?  : Short Help     
668
669 ATZ  : MCU Reset    
670
671 AT+TDC  : Application Data Transmission Interval
672
673 AT+CFG  : Print all configurations
674
675 AT+CFGMOD           : Working mode selection
676
677 AT+DEUI  : Get or set the Device ID
678
679 AT+INTMOD            : Set the trigger interrupt mode
680
681 AT+5VT           : Set extend the time of 5V power  
682
683 AT+PRO          : Choose agreement
684
685 AT+RXDL  : Extend the sending and receiving time
686
687 AT+DNSCFG  : Get or Set DNS Server
688
689 AT+GETSENSORVALUE   : Returns the current sensor measurement
690
691 AT+NOUD  : Get or Set the number of data to be uploaded
692
693 AT+CDP     : Read or Clear cached data
694
695 AT+SHTEMP:  Get or Set alarm of temp
696
697 AT+SHHUM:  Get or Set alarm of moisture
698
699 AT+SERVADDR :  Server Address
700
701
702 (% style="color:blue" %)**UDP Management**
703
704 AT+CFM  :  Upload confirmation mode (only valid for UDP)
705
706
707 (% style="color:blue" %)**MQTT Management**
708
709 AT+CLIENT               : Get or Set MQTT client
710
711 AT+UNAME              : Get or Set MQTT Username
712
713 AT+PWD                  : Get or Set MQTT password
714
715 AT+PUBTOPIC  : Get or Set MQTT publish topic
716
717 AT+SUBTOPIC  : Get or Set MQTT subscription topic
718
719
720 (% style="color:blue" %)**Information**          
721
722 AT+FDR  : Factory Data Reset
723
724 AT+PWORD  : Serial Access Password
725
726 AT+LDATA  : Get the last upload data
727
728 AT+CDP  : Read or Clear cached data
729
730
731 = 4. Battery & Power Consumption =
732
733
734 DDS20-NB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
735
736 [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
737
738
739 = 5. Firmware update =
740
741
742 User can change device firmware to::
743
744 * Update with new features.
745
746 * Fix bugs.
747
748 Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/nyzeu0lf0amcaek/AAC6UZrqyTcAyJgXOH7l9F9Ka?dl=0]]**
749
750 Methods to Update Firmware:
751
752 * (Recommended way) OTA firmware update via BLE: [[**Instruction**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/BLE_Firmware_Update_NB_Sensors_BC660K-GL/]].
753
754 * Update through UART TTL interface : **[[Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/UART_Access_for_NB_ST_BC660K-GL/#H4.2UpdateFirmware28Assumethedevicealreadyhaveabootloader29]]**.
755
756 = 6. FAQ =
757
758 == 6.1 How can I access t BC660K-GL AT Commands? ==
759
760
761 User can access to BC660K-GL directly and send AT Commands.
762
763 [[See BC660K-GL AT Command set>>url:https://www.dropbox.com/sh/5f6ssda5fum8rvs/AABT68l8ZzWOvZ5eg2qwOoFda?dl=0]]
764
765
766 = 7.  Trouble Shooting =
767
768 == 7.1  Why i always see 0x0000 or 0 for the distance value? ==
769
770
771 (((
772 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.
773
774 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.
775
776
777 )))
778
779 = 8. Order Info =
780
781
782 Part Number: (% style="color:blue" %)**DDS20-NB-XX**
783
784 (% style="color:red" %)**XX**(%%):
785
786 * (% style="color:#037691" %)**GE**(%%): General version ( Exclude SIM card)
787
788 * (% style="color:#037691" %)**1D**(%%): with 1NCE* 10 years 500MB SIM card and Pre-configure to DataCake server
789
790 (% style="color:#037691" %)**1NCE SIM Card NB-IoT network coverage**(%%): Austria, Belgium, Bulgaria, Croatia, Czech Republic, Denmark, Finland, Germany, Great Britain, Greece, Hungary, Ireland, Italy, Latvia, Malta, Netherlands, Norway, Puerto Rico, Russia, Slovak , Republic, Slovenia, Spain, Sweden, Switzerland, Taiwan, USA, US Virgin Islands
791
792
793 = 9. ​Packing Info =
794
795
796 (% style="color:#037691" %)**Package Includes**:
797
798 * DDS20-NB NB-IoT Ultrasonic liquid level sensor x 1
799
800 * External antenna x 1
801
802 (% style="color:#037691" %)**Dimension and weight**:
803
804 * Device Size: 13.0 x 5 x 4.5 cm
805
806 * Device Weight: 150g
807
808 * Package Size / pcs : 14.0 x 8x 5 cm
809
810 * Weight / pcs : 180g
811
812 = 10. Support =
813
814
815 * Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8. Due to different timezones we cannot offer live support. However, your questions will be answered as soon as possible in the before-mentioned schedule.
816
817 * Provide as much information as possible regarding your enquiry (product models, accurately describe your problem and steps to replicate it etc) and send a mail to [[Support@dragino.cc>>mailto:Support@dragino.cc]].
818
819 (% style="display:none" %) (%%)