Last modified by Mengting Qiu on 2024/05/09 15:25
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 (% style="color:red" %)Notice: The AT+NOUD feature is upgraded to Clock Logging, please refer [[Clock Logging Feature>>||anchor="H2.7Clocklogging28Sincefirmwareversionv1.2.129"]]
612
613 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:
614
615 * (% 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)
616
617 * (% 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.
618
619 The diagram below explains the relationship between TR, NOUD, and TDC more clearly:
620
621 (% 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" %)​
622
623
624 == 2.6 Trggier an uplink by external interrupt ==
625
626
627 DDS20-NB has an external trigger interrupt function. Users can use the PB15 pin to trigger the upload of data packets.
628
629 (% style="color:blue" %)**AT command:**
630
631 * (% style="color:#037691" %)**AT+INTMOD **(%%) ~/~/ Set the trigger interrupt mode
632
633 * (% style="color:#037691" %)**AT+INTMOD=0 **(%%) ~/~/ Disable Interrupt
634
635 * (% style="color:#037691" %)**AT+INTMOD=1 **(%%) ~/~/ Trigger by rising and falling edge
636
637 * (% style="color:#037691" %)**AT+INTMOD=2 **(%%) ~/~/ Trigger by falling edge
638
639 * (% style="color:#037691" %)**AT+INTMOD=3  **(%%) ~/~/ Trigger by rising edge
640
641 == 2.7 Clock logging (Since firmware version v1.2.1) ==
642
643
644 Sometimes when we deploy lots of end nodes in field. We want all sensors sample data at the same time, and upload these data together for analyze. In such case, we can use clock loging feature.
645
646 We can use this command to set the start time of data recording and the time interval to meet the requirements of the specific collection time of data.
647
648 * (% style="color:blue" %)**AT command: **(% style="color:#037691" %)**AT+CLOCKLOG=a,b,c,d**
649
650 (% style="color:#037691" %)**a:**(%%)** 0:** Disable Clock logging.  ** 1: **Enable Clock Logging
651
652 (% style="color:#037691" %)**b:**(%%)** **Specify First sampling start second: range **(0 ~~ 3599, 65535)   ** ~/~/ (% style="color:red" %)**Note:**(%%)** **If parameter b is set to 65535, the log period starts after the node accesses the network and sends packets.
653
654 (% style="color:#037691" %)**c:**(%%)** **Specify the sampling interval: range **(0 ~~ 255 minutes)**
655
656 (% style="color:#037691" %)**d:**(%%)** **How many entries should be uplink on every TDC **(max 32)**
657
658 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SPH01-NB_NB-IoT_Soil_pH_Sensor_User_Manual/WebHome/image-20240315141254-1.png?rev=1.1||alt="image-20240315141254-1.png"]]
659
660 **Example:**
661
662 **AT+CLOCKLOG=1,65535,1,5**
663
664 After the node sends the first packet, data is recorded to the memory at intervals of 1 minute. For each TDC uplink, the uplink load will include: battery information + the last 5 memory records (payload + timestamp).
665
666 (% class="wikigeneratedid" %)
667 [[image:image-20240316112756-1.png||height="559" width="1218"]]
668
669 (% class="wikigeneratedid" %)
670 (% style="color:red" %)**Note: Users need to synchronize the server time before configuring this command. If the server time is not synchronized before this command is configured, the command takes effect only after the node is reset.**
671
672
673 == 2.8 Example Query saved historical records ==
674
675
676 * (% style="color:blue" %)**AT command:**(%%)** (% style="color:#037691" %)AT+CDP(%%)**
677
678 This command can be used to search the saved history, recording up to 32 groups of data, each group of historical data contains a maximum of 100 bytes.
679
680 (% class="wikigeneratedid" %)
681 [[image:image-20240316112902-2.png||height="699" width="905"]]
682
683
684
685 == 2.9 Uplink log query ==
686
687
688 * (% style="color:blue" %)**AT command:**(%%)** (% style="color:#037691" %)AT+GETLOG(%%)**
689
690 This command can be used to query upstream logs of data packets.
691
692 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/PS-NB-NA_NB-IoT_Analog_Sensor_User_Manual/WebHome/image-20240407191922-2.png?width=903&height=631&rev=1.1||alt="image-20240407191922-2.png"]]
693
694
695
696 = 3. Configure DDS20-NB =
697
698 == 3.1 Configure Methods ==
699
700
701 DDS20-NB supports below configure method:
702
703 * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
704
705 * 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]].
706
707 == 3.2 AT Commands Set ==
708
709
710 AT+<CMD>?        : Help on <CMD>
711
712 AT+<CMD>         : Run <CMD>
713
714 AT+<CMD>=<value> : Set the value
715
716 AT+<CMD>=?       : Get the value
717
718
719 (% style="color:blue" %)**General Commands**      
720
721 AT                    : Attention       
722
723 AT?  : Short Help     
724
725 ATZ  : MCU Reset    
726
727 AT+TDC  : Application Data Transmission Interval
728
729 AT+CFG  : Print all configurations
730
731 AT+CFGMOD           : Working mode selection
732
733 AT+DEUI  : Get or set the Device ID
734
735 AT+INTMOD            : Set the trigger interrupt mode
736
737 AT+5VT           : Set extend the time of 5V power  
738
739 AT+PRO          : Choose agreement
740
741 AT+RXDL  : Extend the sending and receiving time
742
743 AT+DNSCFG  : Get or Set DNS Server
744
745 AT+GETSENSORVALUE   : Returns the current sensor measurement
746
747 AT+NOUD  : Get or Set the number of data to be uploaded
748
749 AT+CDP     : Read or Clear cached data
750
751 AT+SHTEMP:  Get or Set alarm of temp
752
753 AT+SHHUM:  Get or Set alarm of moisture
754
755 AT+SERVADDR :  Server Address
756
757
758
759 (% style="color:blue" %)**MQTT Management**
760
761 AT+CLIENT               : Get or Set MQTT client
762
763 AT+UNAME              : Get or Set MQTT Username
764
765 AT+PWD                  : Get or Set MQTT password
766
767 AT+PUBTOPIC  : Get or Set MQTT publish topic
768
769 AT+SUBTOPIC  : Get or Set MQTT subscription topic
770
771
772 (% style="color:blue" %)**Information**          
773
774 AT+FDR  : Factory Data Reset
775
776 AT+PWORD  : Serial Access Password
777
778 AT+LDATA  : Get the last upload data
779
780 AT+CDP  : Read or Clear cached data
781
782
783 = 4. Battery & Power Consumption =
784
785
786 DDS20-NB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
787
788 [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
789
790
791 = 5. Firmware update =
792
793
794 User can change device firmware to::
795
796 * Update with new features.
797
798 * Fix bugs.
799
800 Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/nyzeu0lf0amcaek/AAC6UZrqyTcAyJgXOH7l9F9Ka?dl=0]]**
801
802 Methods to Update Firmware:
803
804 * (Recommended way) OTA firmware update via BLE: [[**Instruction**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/BLE_Firmware_Update_NB_Sensors_BC660K-GL/]].
805
806 * Update through UART TTL interface : **[[Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/UART_Access_for_NB_ST_BC660K-GL/#H4.2UpdateFirmware28Assumethedevicealreadyhaveabootloader29]]**.
807
808 = 6. FAQ =
809
810 == 6.1 How can I access t BC660K-GL AT Commands? ==
811
812
813 User can access to BC660K-GL directly and send AT Commands.
814
815 [[See BC660K-GL AT Command set>>url:https://www.dropbox.com/sh/5f6ssda5fum8rvs/AABT68l8ZzWOvZ5eg2qwOoFda?dl=0]]
816
817
818 = 7.  Trouble Shooting =
819
820 == 7.1  Why i always see 0x0000 or 0 for the distance value? ==
821
822
823 (((
824 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.
825
826 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.
827
828
829 )))
830
831 = 8. Order Info =
832
833
834 Part Number: (% style="color:blue" %)**DDS20-NB-XX**
835
836 (% style="color:red" %)**XX**(%%):
837
838 * (% style="color:#037691" %)**GE**(%%): General version ( Exclude SIM card)
839
840 * (% style="color:#037691" %)**1D**(%%): with 1NCE* 10 years 500MB SIM card and Pre-configure to DataCake server
841
842 (% 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
843
844
845 = 9. ​Packing Info =
846
847
848 (% style="color:#037691" %)**Package Includes**:
849
850 * DDS20-NB NB-IoT Ultrasonic liquid level sensor x 1
851
852 * External antenna x 1
853
854 (% style="color:#037691" %)**Dimension and weight**:
855
856 * Device Size: 13.0 x 5 x 4.5 cm
857
858 * Device Weight: 150g
859
860 * Package Size / pcs : 14.0 x 8x 5 cm
861
862 * Weight / pcs : 180g
863
864 = 10. Support =
865
866
867 * 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.
868
869 * 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]].
870
871 (% style="display:none" %) (%%)

Applications

Navigation

Copyright ©2010-2022 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0