Wiki source code of DDS04-NB -- NB-IoT 4-Channels Distance Detection Sensor User Manual
Version 114.1 by Mengting Qiu on 2023/11/08 15:10
Show last authors
author | version | line-number | content |
---|---|---|---|
1 | |||
2 | |||
3 | (% style="text-align:center" %) | ||
4 | [[image:image-20231018150414-1.png||height="553" width="814"]] | ||
5 | |||
6 | |||
7 | |||
8 | |||
9 | |||
10 | |||
11 | |||
12 | **Table of Contents:** | ||
13 | |||
14 | {{toc/}} | ||
15 | |||
16 | |||
17 | |||
18 | |||
19 | |||
20 | |||
21 | = 1. Introduction = | ||
22 | |||
23 | == 1.1 What is NB-IoT 4-Channels Distance Sensor == | ||
24 | |||
25 | |||
26 | The Dragino DDS04-NB is a (% style="color:blue" %)**NB-IoT 4-Channels Distance Sensor** (%%)for Internet of Things solution. It is capable to add up to four Ultrasonic Sensors to measure four distances at the same time. | ||
27 | |||
28 | The DDS04-NB can be applied to scenarios such as horizontal distance measurement, parking management system, object proximity and presence detection, intelligent trash can management system, robot obstacle avoidance, automatic control, sewer, etc. | ||
29 | |||
30 | It detects the distance between the measured object and the sensor, and uploads the value via wireless to NB-IoT IoT Server. | ||
31 | |||
32 | DDS04-NB supports different uplink methods including (% style="color:blue" %)**MQTT, MQTTs, UDP & TCP**(%%) for different application requirement, and support uplinks to various IoT Servers. | ||
33 | |||
34 | DDS04-NB (% style="color:blue" %)**supports BLE configure **(%%)and(% style="color:blue" %)** OTA update**(%%) which make user easy to use. | ||
35 | |||
36 | DDS04-NB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long-term use up to several years. | ||
37 | |||
38 | DDS04-NB has optional built-in SIM card and default IoT server connection version. Which makes it works with simple configuration. | ||
39 | |||
40 | [[image:image-20231018151321-2.png||height="306" width="881"]] | ||
41 | |||
42 | |||
43 | == 1.2 Features == | ||
44 | |||
45 | |||
46 | * NB-IoT Bands: B1/B2/B3/B4/B5/B8/B12/B13/B17/B18/B19/B20/B25/B28/B66/B70/B85 @H-FDD | ||
47 | * Ultra-low power consumption | ||
48 | * max: 4 x Distance Detect Channels | ||
49 | * Different types of probes can be used together | ||
50 | * Detect Range: Base on External Probe | ||
51 | * Multiply Sampling and one uplink | ||
52 | * Support Bluetooth v5.1 remote configure and update firmware | ||
53 | * Uplink on periodically | ||
54 | * Downlink to change configure | ||
55 | * 8500mAh Battery for long term use | ||
56 | * Nano SIM card slot for NB-IoT SIM | ||
57 | |||
58 | |||
59 | == 1.3 Specification == | ||
60 | |||
61 | |||
62 | (% style="color:blue" %)**Common DC Characteristics:** | ||
63 | |||
64 | * Supply Voltage: 2.5v ~~ 3.6v | ||
65 | * Operating Temperature: -40 ~~ 85°C | ||
66 | |||
67 | (% style="color:blue" %)**NB-IoT Spec:** | ||
68 | |||
69 | (% style="color:#037691" %)**NB-IoT Module: BC660K-GL** | ||
70 | |||
71 | (% style="color:#037691" %)**Support Bands:** | ||
72 | |||
73 | * B1 @H-FDD: 2100MHz | ||
74 | * B2 @H-FDD: 1900MHz | ||
75 | * B3 @H-FDD: 1800MHz | ||
76 | * B4 @H-FDD: 2100MHz | ||
77 | * B5 @H-FDD: 860MHz | ||
78 | * B8 @H-FDD: 900MHz | ||
79 | * B12 @H-FDD: 720MHz | ||
80 | * B13 @H-FDD: 740MHz | ||
81 | * B17 @H-FDD: 730MHz | ||
82 | * B18 @H-FDD: 870MHz | ||
83 | * B19 @H-FDD: 870MHz | ||
84 | * B20 @H-FDD: 790MHz | ||
85 | * B25 @H-FDD: 1900MHz | ||
86 | * B28 @H-FDD: 750MHz | ||
87 | * B66 @H-FDD: 2000MHz | ||
88 | * B70 @H-FDD: 2000MHz | ||
89 | * B85 @H-FDD: 700MHz | ||
90 | |||
91 | (% style="color:blue" %)**Battery:** | ||
92 | |||
93 | * Li/SOCI2 un-chargeable battery | ||
94 | * Capacity: 8500mAh | ||
95 | * Self Discharge: <1% / Year @ 25°C | ||
96 | * Max continuously current: 130mA | ||
97 | * Max boost current: 2A, 1 second | ||
98 | |||
99 | (% style="color:blue" %)**Power Consumption** | ||
100 | |||
101 | * STOP Mode: 10uA @ 3.3v | ||
102 | * Max transmit power: 350mA@3.3v | ||
103 | |||
104 | |||
105 | == 1.4 Probe Options == | ||
106 | |||
107 | === 1.4.1 Probes Comparation === | ||
108 | |||
109 | |||
110 | (% border="1" cellspacing="5" style="width:505px" %) | ||
111 | |=(% style="width: 80px;background-color:#4F81BD;color:white" %)**Model**|=(% style="width: 147px;background-color:#4F81BD;color:white" %)**Photo**|=(% style="width: 278px;background-color:#4F81BD;color:white" %)**Description** | ||
112 | |(% style="width:78px" %)**A01A-15**|(% style="width:145px" %)((( | ||
113 | [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS04%20-%20LoRaWAN%204-Channels%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654931296150-422.png?width=180&height=180&rev=1.1||alt="1654931296150-422.png"]] | ||
114 | )))|(% style="width:277px" %)((( | ||
115 | ((( | ||
116 | Detect Distance: 28 cm ~~ 750 cm | ||
117 | ))) | ||
118 | |||
119 | ((( | ||
120 | Bling Spot Distance: 0 ~~ 28cm | ||
121 | ))) | ||
122 | |||
123 | ((( | ||
124 | Accuracy: ±(1cm+S*0.3%) (S: Distance) | ||
125 | ))) | ||
126 | |||
127 | ((( | ||
128 | Measure Angle: ~~ 40° | ||
129 | ))) | ||
130 | |||
131 | ((( | ||
132 | Cable Length: 1.5 meter | ||
133 | ))) | ||
134 | |||
135 | ((( | ||
136 | Temperature Compensation | ||
137 | ))) | ||
138 | |||
139 | ((( | ||
140 | Suitable for Flat Object Detect | ||
141 | ))) | ||
142 | |||
143 | ((( | ||
144 | IP67 Water Proof | ||
145 | ))) | ||
146 | ))) | ||
147 | |(% style="width:78px" %)**A02-15**|(% style="width:145px" %)((( | ||
148 | [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS04%20-%20LoRaWAN%204-Channels%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/image-20220611150955-2.png?width=180&height=180&rev=1.1||alt="image-20220611150955-2.png"]] | ||
149 | )))|(% style="width:277px" %)((( | ||
150 | ((( | ||
151 | Detect Distance: 3cm ~~ 450cm | ||
152 | ))) | ||
153 | |||
154 | ((( | ||
155 | Bling Spot Distance: 0 ~~ 3cm | ||
156 | ))) | ||
157 | |||
158 | ((( | ||
159 | Accuracy: ±(1cm+S*0.3%) (S: Distance) | ||
160 | ))) | ||
161 | |||
162 | ((( | ||
163 | Measure Angle: ~~ 60° | ||
164 | ))) | ||
165 | |||
166 | ((( | ||
167 | Cable Length: 1.5 meter | ||
168 | ))) | ||
169 | |||
170 | ((( | ||
171 | Temperature Compensation | ||
172 | ))) | ||
173 | |||
174 | ((( | ||
175 | Suitable for Flat Object Detect, Rubbish Bin | ||
176 | ))) | ||
177 | |||
178 | ((( | ||
179 | IP67 Water Proof | ||
180 | ))) | ||
181 | ))) | ||
182 | |(% style="width:78px" %)**A13-15**|(% style="width:145px" %)((( | ||
183 | [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS04%20-%20LoRaWAN%204-Channels%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654931353123-552.png?width=180&height=180&rev=1.1||alt="1654931353123-552.png"]] | ||
184 | )))|(% style="width:277px" %)((( | ||
185 | ((( | ||
186 | Detect Distance: 25cm ~~ 200cm | ||
187 | ))) | ||
188 | |||
189 | ((( | ||
190 | Bling Spot Distance: 0 ~~ 25cm | ||
191 | ))) | ||
192 | |||
193 | ((( | ||
194 | Accuracy: ±(1cm+S*0.3%) (S: Distance) | ||
195 | ))) | ||
196 | |||
197 | ((( | ||
198 | Measure Angle: ~~ 20° | ||
199 | ))) | ||
200 | |||
201 | ((( | ||
202 | Cable Length: 1.5 meter | ||
203 | ))) | ||
204 | |||
205 | ((( | ||
206 | Temperature Compensation | ||
207 | ))) | ||
208 | |||
209 | ((( | ||
210 | Suitable for Flat Object Detect, Rubbish Bin | ||
211 | ))) | ||
212 | |||
213 | ((( | ||
214 | IP67 Water Proof | ||
215 | ))) | ||
216 | ))) | ||
217 | |(% style="width:78px" %)**A16-15**|(% style="width:145px" %)((( | ||
218 | [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS04%20-%20LoRaWAN%204-Channels%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654931363281-306.png?width=180&height=180&rev=1.1||alt="1654931363281-306.png"]] | ||
219 | )))|(% style="width:277px" %)((( | ||
220 | ((( | ||
221 | Detect Distance: 50cm ~~ 1500cm | ||
222 | ))) | ||
223 | |||
224 | ((( | ||
225 | Bling Spot Distance: 0 ~~ 50cm | ||
226 | ))) | ||
227 | |||
228 | ((( | ||
229 | Accuracy: ±(1cm+S*0.3%) (S: Distance) | ||
230 | ))) | ||
231 | |||
232 | ((( | ||
233 | Measure Angle: ~~ 40° | ||
234 | ))) | ||
235 | |||
236 | ((( | ||
237 | Cable Length: 1.5 meter | ||
238 | ))) | ||
239 | |||
240 | ((( | ||
241 | Temperature Compensation | ||
242 | ))) | ||
243 | |||
244 | ((( | ||
245 | Suitable for Long Distance Detect | ||
246 | ))) | ||
247 | |||
248 | ((( | ||
249 | IP67 Water Proof | ||
250 | ))) | ||
251 | ))) | ||
252 | |||
253 | |||
254 | === 1.4.2 P01A-15 probe === | ||
255 | |||
256 | |||
257 | ((( | ||
258 | A01A-15 is mainly used for plane distance measurement; it can carry out targeted measurement on plane objects and can measure long distances and high accuracy. | ||
259 | ))) | ||
260 | |||
261 | |||
262 | ((( | ||
263 | (% style="color:blue" %)**Beam Chart:** | ||
264 | ))) | ||
265 | |||
266 | ((( | ||
267 | **(1) The tested object is a white cylindrical tube made of PVC, with a height of 100cm and a diameter of 7.5cm.** | ||
268 | ))) | ||
269 | |||
270 | (% style="background-image:url(http://wiki1.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" %)[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS04%20-%20LoRaWAN%204-Channels%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654852253176-749.png?rev=1.1||alt="1654852253176-749.png"]] | ||
271 | |||
272 | |||
273 | ((( | ||
274 | **(2)** **The object to be tested is a "corrugated cardboard box" perpendicular to the central axis of 0 °, and the length * width is 60cm * 50cm.** | ||
275 | ))) | ||
276 | |||
277 | (% style="background-image:url(http://wiki1.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" %)[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS04%20-%20LoRaWAN%204-Channels%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654852175653-550.png?rev=1.1||alt="1654852175653-550.png"]] | ||
278 | |||
279 | |||
280 | (% style="color:blue" %)**Mechanical:** | ||
281 | |||
282 | (% style="background-image:url(http://wiki1.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" %)[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS04%20-%20LoRaWAN%204-Channels%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/image-20220611152848-11.png?rev=1.1||alt="image-20220611152848-11.png"]] | ||
283 | |||
284 | [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS04%20-%20LoRaWAN%204-Channels%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654932546845-829.png?rev=1.1||alt="1654932546845-829.png"]] | ||
285 | |||
286 | [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS04%20-%20LoRaWAN%204-Channels%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/image-20220611152934-12.png?rev=1.1||alt="image-20220611152934-12.png"]] | ||
287 | |||
288 | |||
289 | (% style="color:blue" %)**Application:** | ||
290 | |||
291 | (% style="background-image:url(http://wiki1.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" %)[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS04%20-%20LoRaWAN%204-Channels%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/image-20220613093246-3.png?rev=1.1||alt="image-20220613093246-3.png"]] | ||
292 | |||
293 | |||
294 | === 1.4.3 A02-15 probe === | ||
295 | |||
296 | (% id="cke_bm_620491S" style="color:blue; display:none" %)** ** | ||
297 | |||
298 | |||
299 | ((( | ||
300 | (% style="color:blue" %)**Beam Chart:** | ||
301 | ))) | ||
302 | |||
303 | ((( | ||
304 | **(1) The tested object is a white cylindrical tube made of PVC, with a height of 100cm and a diameter of 7.5cm.** | ||
305 | ))) | ||
306 | |||
307 | (% style="background-image:url(http://wiki1.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" %)[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS04%20-%20LoRaWAN%204-Channels%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654934329751-424.png?rev=1.1||alt="1654934329751-424.png"]] | ||
308 | |||
309 | |||
310 | ((( | ||
311 | **(2)** **The object to be tested is a "corrugated cardboard box" perpendicular to the central axis of 0 °, and the length * width is 60cm * 50cm.** | ||
312 | ))) | ||
313 | |||
314 | (% style="background-image:url(http://wiki1.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" %)[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS04%20-%20LoRaWAN%204-Channels%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654934343649-264.png?rev=1.1||alt="1654934343649-264.png"]] | ||
315 | |||
316 | |||
317 | (% style="color:blue" %)**Mechanical:**(% style="background-image:url(http://wiki1.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" %) | ||
318 | |||
319 | [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS04%20-%20LoRaWAN%204-Channels%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654932923252-110.png?rev=1.1||alt="1654932923252-110.png"]] | ||
320 | |||
321 | |||
322 | (% style="color:blue" %)**Application:** | ||
323 | |||
324 | (% style="background-image:url(http://wiki1.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" %)[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS04%20-%20LoRaWAN%204-Channels%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/image-20220611153001-13.png?rev=1.1||alt="image-20220611153001-13.png"]] | ||
325 | |||
326 | |||
327 | === 1.4.4 A13-15 probe === | ||
328 | |||
329 | (% id="cke_bm_695100S" style="color:blue; display:none" %)** ** | ||
330 | |||
331 | |||
332 | ((( | ||
333 | (% style="color:blue" %)**Beam Chart:** | ||
334 | ))) | ||
335 | |||
336 | ((( | ||
337 | **(1) The tested object is a white cylindrical tube made of PVC, with a height of 100cm and a diameter of 7.5cm.** | ||
338 | ))) | ||
339 | |||
340 | (% style="background-image:url(http://wiki1.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" %)[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS04%20-%20LoRaWAN%204-Channels%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654934363730-880.png?rev=1.1||alt="1654934363730-880.png"]] | ||
341 | |||
342 | |||
343 | |||
344 | ((( | ||
345 | **(2)** **The object to be tested is a "corrugated cardboard box" perpendicular to the central axis of 0 °, and the length * width is 60cm * 50cm.** | ||
346 | ))) | ||
347 | |||
348 | |||
349 | ((( | ||
350 | (% style="color:blue" %)**Mechanical:** | ||
351 | ))) | ||
352 | |||
353 | [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS04%20-%20LoRaWAN%204-Channels%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/image-20220611154330-16.png?rev=1.1||alt="image-20220611154330-16.png"]] | ||
354 | |||
355 | (% style="background-image:url(http://wiki1.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" %) | ||
356 | |||
357 | (% style="color:blue" %)**Installation Requirement:** | ||
358 | |||
359 | (% style="background-image:url(http://wiki1.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" %)[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS04%20-%20LoRaWAN%204-Channels%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654933425011-311.png?width=747&height=649&rev=1.1||alt="1654933425011-311.png"]] | ||
360 | |||
361 | |||
362 | (% style="color:blue" %)**Application:** | ||
363 | |||
364 | (% style="background-image:url(http://wiki1.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" %)[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS04%20-%20LoRaWAN%204-Channels%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/image-20220613093149-2.png?rev=1.1||alt="image-20220613093149-2.png"]] | ||
365 | |||
366 | |||
367 | === 1.4.5 A13-16 probe === | ||
368 | |||
369 | (% id="cke_bm_695100S" style="color:blue; display:none" %)** ** | ||
370 | |||
371 | |||
372 | ((( | ||
373 | (% style="color:blue" %)**Beam Chart:** | ||
374 | ))) | ||
375 | |||
376 | ((( | ||
377 | **(1) The tested object is a white cylindrical tube made of PVC, with a height of 100cm and a diameter of 7.5cm.** | ||
378 | ))) | ||
379 | |||
380 | (% style="background-image:url(http://wiki1.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" %)[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS04%20-%20LoRaWAN%204-Channels%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654934415156-713.png?rev=1.1||alt="1654934415156-713.png"]] | ||
381 | |||
382 | |||
383 | ((( | ||
384 | **(2)** **The object to be tested is a "corrugated cardboard box" perpendicular to the central axis of 0 °, and the length * width is 60cm * 50cm.** | ||
385 | ))) | ||
386 | |||
387 | (% style="background-image:url(http://wiki1.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" %)[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS04%20-%20LoRaWAN%204-Channels%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654934424571-232.png?rev=1.1||alt="1654934424571-232.png"]] | ||
388 | |||
389 | |||
390 | |||
391 | (% style="color:blue" %)**Mechanical:** | ||
392 | |||
393 | (% style="background-image:url(http://wiki1.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" %)[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS04%20-%20LoRaWAN%204-Channels%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/image-20220611160117-1.png?rev=1.1||alt="image-20220611160117-1.png"]] | ||
394 | |||
395 | |||
396 | (% style="color:blue" %)**Application:** | ||
397 | |||
398 | (% style="background-image:url(http://wiki1.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" %)[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS04%20-%20LoRaWAN%204-Channels%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/image-20220613093102-1.png?rev=1.1||alt="image-20220613093102-1.png"]] | ||
399 | |||
400 | |||
401 | == 1.5 Applications == | ||
402 | |||
403 | |||
404 | * Horizontal distance measurement | ||
405 | * Parking management system | ||
406 | * Object proximity and presence detection | ||
407 | * Intelligent trash can management system | ||
408 | * Robot obstacle avoidance | ||
409 | * Automatic control | ||
410 | * Sewer | ||
411 | |||
412 | |||
413 | == 1.6 Sleep mode and working mode == | ||
414 | |||
415 | |||
416 | (% 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. | ||
417 | |||
418 | (% 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. | ||
419 | |||
420 | |||
421 | == 1.7 Button & LEDs == | ||
422 | |||
423 | |||
424 | [[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675071855856-879.png]] | ||
425 | |||
426 | |||
427 | (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) | ||
428 | |=(% 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** | ||
429 | |(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:117px" %)Send an uplink|(% style="width:225px" %)((( | ||
430 | If sensor has already attached to NB-IoT network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once. | ||
431 | Meanwhile, BLE module will be active and user can connect via BLE to configure device. | ||
432 | ))) | ||
433 | |(% style="width:167px" %)Pressing ACT for more than 3s|(% style="width:117px" %)Active Device|(% style="width:225px" %)((( | ||
434 | (% 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. | ||
435 | (% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network. | ||
436 | 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. | ||
437 | ))) | ||
438 | |(% 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. | ||
439 | |||
440 | (% 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.** | ||
441 | |||
442 | |||
443 | == 1.8 BLE connection == | ||
444 | |||
445 | |||
446 | DDS04-NB support BLE remote configure and firmware update. | ||
447 | |||
448 | |||
449 | 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: | ||
450 | |||
451 | * Press button to send an uplink | ||
452 | * Press button to active device. | ||
453 | * Device Power on or reset. | ||
454 | |||
455 | If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode. | ||
456 | |||
457 | |||
458 | == 1.9 Pin Definitions & Switch == | ||
459 | |||
460 | |||
461 | [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS12-LB_LoRaWAN_LiDAR_ToF_Distance_Sensor_User_Manual/WebHome/image-20230805144259-1.png?width=741&height=413&rev=1.1||alt="image-20230805144259-1.png"]] | ||
462 | |||
463 | |||
464 | === 1.9.1 Jumper JP2 === | ||
465 | |||
466 | |||
467 | Power on Device when put this jumper. | ||
468 | |||
469 | |||
470 | === 1.9.2 BOOT MODE / SW1 === | ||
471 | |||
472 | |||
473 | **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. | ||
474 | |||
475 | **2)** (% style="color:blue" %)**Flash**(%%): work mode, device starts to work and send out console output for further debug | ||
476 | |||
477 | |||
478 | === 1.9.3 Reset Button === | ||
479 | |||
480 | |||
481 | Press to reboot the device. | ||
482 | |||
483 | |||
484 | == 1.10 Mechanical == | ||
485 | |||
486 | [[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"]] | ||
487 | |||
488 | [[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"]] | ||
489 | |||
490 | [[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"]] | ||
491 | |||
492 | |||
493 | = 2. Use DDS04-NB to communicate with IoT Server = | ||
494 | |||
495 | == 2.1 Send data to IoT server via NB-IoT network == | ||
496 | |||
497 | |||
498 | The DDS04-NB is equipped with a NB-IoT module, the pre-loaded firmware in DDS04-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 DDS04-NB. | ||
499 | |||
500 | Below shows the network structure: | ||
501 | |||
502 | [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/DDS04-NB_NB-IoT_4-Channels_Distance_Detection_Sensor_User_Manual/WebHome/image-20231018151321-2.png?width=881&height=306&rev=1.1||alt="image-20231018151321-2.png"]] | ||
503 | |||
504 | |||
505 | There are two version: (% style="color:blue" %)**-GE**(%%) and (% style="color:blue" %)**-1D**(%%) version of DDS04-NB. | ||
506 | |||
507 | |||
508 | (% 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 LDS12-NB send data to IoT server. | ||
509 | |||
510 | * 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]]. | ||
511 | |||
512 | * 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]]. | ||
513 | |||
514 | Below shows result of different server as a glance. | ||
515 | |||
516 | (% border="1" cellspacing="4" style="width:515px" %) | ||
517 | |(% 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** | ||
518 | |(% 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" %)((( | ||
519 | (% style="text-align:center" %) | ||
520 | [[image:image-20230819113244-8.png||height="183" width="367"]] | ||
521 | )))|(% style="width:170px" %) | ||
522 | |(% 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" %)((( | ||
523 | (% style="text-align:center" %) | ||
524 | [[image:image-20230819113244-9.png||height="119" width="367"]] | ||
525 | )))|(% style="width:170px" %) | ||
526 | |(% 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" %) | ||
527 | |(% 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" %) | ||
528 | |(% 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" %) | ||
529 | |(% 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" %)((( | ||
530 | (% style="text-align:center" %) | ||
531 | [[image:image-20230819113244-10.png||height="104" width="367"]] | ||
532 | )))|(% style="width:170px" %) | ||
533 | |(% 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" %)((( | ||
534 | (% style="text-align:center" %) | ||
535 | [[image:image-20230819113244-11.png||height="141" width="367"]] | ||
536 | )))|(% style="width:170px" %) | ||
537 | |||
538 | (% 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 DDS04-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]]. | ||
539 | |||
540 | |||
541 | == 2.2 Payload Types == | ||
542 | |||
543 | |||
544 | To meet different server requirement, DDS04-NB supports different payload type. | ||
545 | |||
546 | **Includes:** | ||
547 | |||
548 | * [[General JSON format payload>>||anchor="H2.2.1GeneralJsonFormat28Type3D529"]]. (Type=5) | ||
549 | |||
550 | * [[HEX format Payload>>||anchor="H2.2.2HEXformatPayload28Type3D029"]]. (Type=0) | ||
551 | |||
552 | * [[ThingSpeak Format>>||anchor="H2.2.4ThingSpeakPayload28Type3D129"]]. (Type=1) | ||
553 | |||
554 | * [[ThingsBoard Format>>||anchor="H2.2.3ThingsBoardPayload28Type3D329"]]. (Type=3) | ||
555 | |||
556 | User can specify the payload type when choose the connection protocol. Example: | ||
557 | |||
558 | (% style="color:#037691" %)**AT+PRO=2,0** (%%) ~/~/ Use UDP Connection & hex Payload | ||
559 | |||
560 | (% style="color:#037691" %)**AT+PRO=2,5** (%%) ~/~/ Use UDP Connection & Json Payload | ||
561 | |||
562 | (% style="color:#037691" %)**AT+PRO=3,5 ** (%%) ~/~/ Use MQTT Connection & Json Payload | ||
563 | |||
564 | |||
565 | === 2.2.1 General Json Format(Type~=5) === | ||
566 | |||
567 | |||
568 | This is the General Json Format. As below: | ||
569 | |||
570 | (% style="color:#4472c4" %)**{"IMEI":"866207052559857","Model":"DDS04-NB","ds18b20_temperature":-0.1,"distance1":90,"distance2":775,"distance3":656,"distance4":793,"battery":3.51,"signal":20,"1":{5,4923,0,29,2023/11/07 01:59:43},"2":{4,4900,0,29,2023/11/07 01:56:43},"3":{10,1475,0,29,2023/11/07 01:53:43},"4":{364,1280,0,29,2023/11/07 01:50:43},"5":{356,1281,0,29,2023/11/07 01:47:43},"6":{359,1280,0,29,2023/11/07 01:37:22},"7":{358,1301,0,27,2023/11/06 10:01:07},"8":{357,1293,0,27,2023/11/06 09:46:07}}** | ||
571 | |||
572 | [[image:image-20231107103319-1.png||height="750" width="1004"]] | ||
573 | |||
574 | |||
575 | (% style="color:red" %)**Notice, from above payload:** | ||
576 | |||
577 | * DS18B20_temperature, Distance1, Distance2, Distance3, Distance4, Battery & Signal are the value at uplink time. | ||
578 | |||
579 | * 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): Distance1, Distance2, Distance3, Distance4, Sampling time. | ||
580 | |||
581 | |||
582 | === 2.2.2 HEX format Payload(Type~=0) === | ||
583 | |||
584 | |||
585 | This is the HEX Format. As below: | ||
586 | |||
587 | (% style="color:#4472c4" %)**f8662070525598570c640db217010000000351000002890db96549a3bf034104c40289031c6549a1a40005133b0000001d65499a0f000413240000001d6549995b000a05c30000001d654998a7016c05000000001d654997f3016405010000001d6549973f016705000000001d654994d2016605150000001b6548b963** | ||
588 | |||
589 | [[image:image-20231107103940-2.png||height="195" width="1205"]] | ||
590 | |||
591 | |||
592 | If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NB sensor uplink data. | ||
593 | |||
594 | [[image:image-20231107104445-3.png||height="750" width="1000"]] | ||
595 | |||
596 | |||
597 | (% style="color:blue" %)**Version:** | ||
598 | |||
599 | These bytes include the hardware and software version. | ||
600 | |||
601 | (% style="color:#037691" %)**Higher byte:**(%%) Specify Sensor Model: 0x0c for DDS04-NB | ||
602 | |||
603 | (% style="color:#037691" %)**Lower byte:**(%%) Specify the software version: 0x64=100, means firmware version 1.0.0 | ||
604 | |||
605 | |||
606 | (% style="color:blue" %)**BAT (Battery Info):** | ||
607 | |||
608 | Ex1: 0x0DB4 = 3508mV | ||
609 | |||
610 | |||
611 | (% style="color:blue" %)**Interrupt flag & Interrupt level** | ||
612 | |||
613 | ((( | ||
614 | This data field shows if this packet is generated by interrupt or not. | ||
615 | ))) | ||
616 | |||
617 | ((( | ||
618 | (% style="color:red" %)**Note: **(%%)The Internet Pin is a separate pin in the screw terminal. | ||
619 | ))) | ||
620 | |||
621 | |||
622 | ((( | ||
623 | **Example:** | ||
624 | ))) | ||
625 | |||
626 | ((( | ||
627 | (0x0D4A & 0x4000) >>14 = 0: Normal uplink packet. | ||
628 | ))) | ||
629 | |||
630 | ((( | ||
631 | (0x4D41 & (% title="Click and drag to resize" %)0x4000)(%%) >>14 = 1: Interrupt Uplink Packet. | ||
632 | ))) | ||
633 | |||
634 | |||
635 | ((( | ||
636 | (0x0D4A & 0x8000) >>15 = 0: Pin of GPIO_EXTI is low level. | ||
637 | ))) | ||
638 | |||
639 | ((( | ||
640 | (0x8D41 & (% title="Click and drag to resize" %)0x8000)(%%) >>15 = 1: Pin of GPIO_EXTI is high level. | ||
641 | ))) | ||
642 | |||
643 | |||
644 | (% style="color:blue" %)**Distance** | ||
645 | |||
646 | ((( | ||
647 | ((( | ||
648 | The measuring distance of the four distance measuring modules, the default unit is cm.(% style="display:none" %) | ||
649 | ))) | ||
650 | |||
651 | ((( | ||
652 | **Example**: | ||
653 | ))) | ||
654 | |||
655 | ((( | ||
656 | Uplink Payload: 0D 4A 03 16 03 18 03 1A 03 15 01 | ||
657 | ))) | ||
658 | |||
659 | ((( | ||
660 | (% title="Click and drag to resize" %)**Data analysis:** | ||
661 | ))) | ||
662 | |||
663 | ((( | ||
664 | Distance of UT sensor1 : 0316(H) = 790 (D)/10 = 79cm. | ||
665 | ))) | ||
666 | |||
667 | ((( | ||
668 | Distance of UT sensor2 : 0318(H) = 792 (D)/10 = 79.2cm. | ||
669 | ))) | ||
670 | |||
671 | ((( | ||
672 | Distance of UT sensor3 : 031A(H) = 794 (D)/10 = 79.4cm. | ||
673 | ))) | ||
674 | |||
675 | ((( | ||
676 | Distance of UT sensor4 : 0315(H) = 789 (D)/10 = 78.9cm. | ||
677 | ))) | ||
678 | ))) | ||
679 | |||
680 | |||
681 | (% style="color:blue" %)**TimeStamp: ** | ||
682 | |||
683 | Unit TimeStamp Example: 64e2d74f(H) = 1692587855(D) | ||
684 | |||
685 | Put the decimal value into this link([[https:~~/~~/www.epochconverter.com)>>https://www.epochconverter.com]])to get the time. | ||
686 | |||
687 | |||
688 | === 2.2.3 ThingsBoard Payload(Type~=3) === | ||
689 | |||
690 | |||
691 | Type3 payload special design for ThingsBoard, it will also configure other default server to ThingsBoard. | ||
692 | |||
693 | (% style="color:#4472c4" %)** {"IMEI": "866207052559857", | ||
694 | "Model": "DDS04-NB", | ||
695 | "ds18b20_temperature": -0.1, | ||
696 | "distance1": 697, | ||
697 | "distance2": 702, | ||
698 | "distance3": 698, | ||
699 | "distance4": 709, | ||
700 | "battery": 3.49, | ||
701 | "signal": 23 | ||
702 | }** | ||
703 | |||
704 | [[image:image-20231107113808-4.png||height="598" width="1060"]] | ||
705 | |||
706 | |||
707 | === 2.2.4 ThingSpeak Payload(Type~=1) === | ||
708 | |||
709 | |||
710 | This payload meets ThingSpeak platform requirement. It includes only four fields. Form 1~~3 are: | ||
711 | |||
712 | Distance, Battery & Signal. This payload type only valid for ThingsSpeak Platform | ||
713 | |||
714 | As below: | ||
715 | |||
716 | (% style="color:#4472c4" %)**field1=Distance value&field2=Battery value&field3=Singal value** | ||
717 | |||
718 | [[image:image-20231107120047-5.png||height="701" width="971"]] | ||
719 | |||
720 | [[image:image-20231107120055-6.png||height="579" width="904"]] | ||
721 | |||
722 | |||
723 | === === | ||
724 | |||
725 | == 2.3 Test Uplink and Change Update Interval == | ||
726 | |||
727 | |||
728 | By default, Sensor will send uplinks (% style="color:blue" %)**every 2 hours**(%%) & AT+NOUD=8 | ||
729 | |||
730 | User can use below commands to change the (% style="color:blue" %)**uplink interval**. | ||
731 | |||
732 | (% style="color:#037691" %)**AT+TDC=600 ** (%%) ~/~/ Set Update Interval to 600s | ||
733 | |||
734 | User can also push the button for more than 1 seconds to activate an uplink. | ||
735 | |||
736 | |||
737 | == 2.4 Multi-Samplings and One uplink == | ||
738 | |||
739 | |||
740 | To save battery life, DDS04-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: | ||
741 | |||
742 | * (% 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) | ||
743 | |||
744 | * (% 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. | ||
745 | |||
746 | The diagram below explains the relationship between TR, NOUD, and TDC more clearly: | ||
747 | |||
748 | [[image:1692424376354-959.png]] | ||
749 | |||
750 | |||
751 | == 2.5 Trggier an uplink by external interrupt == | ||
752 | |||
753 | |||
754 | DDS04-NB has an external trigger interrupt function. Users can use the PB15 pin to trigger the upload of data packets. | ||
755 | |||
756 | (% style="color:blue" %)**AT command:** | ||
757 | |||
758 | * (% style="color:#037691" %)**AT+INTMOD **(%%) ~/~/ Set the trigger interrupt mode | ||
759 | |||
760 | * (% style="color:#037691" %)**AT+INTMOD=0 **(%%) ~/~/ Disable Interrupt | ||
761 | |||
762 | * (% style="color:#037691" %)**AT+INTMOD=1 **(%%) ~/~/ Trigger by rising and falling edge | ||
763 | |||
764 | * (% style="color:#037691" %)**AT+INTMOD=2 **(%%) ~/~/ Trigger by falling edge | ||
765 | |||
766 | * (% style="color:#037691" %)**AT+INTMOD=3 **(%%) ~/~/ Trigger by rising edge | ||
767 | |||
768 | |||
769 | == 2.6 Connect Probe == | ||
770 | |||
771 | |||
772 | DDS04-NB has a converter, User need to connect the Ultrasonic Probes to the convert as below. Different probes are supported, please see this link for the probe options. | ||
773 | |||
774 | [[image:image-20231018160750-3.jpeg]] | ||
775 | |||
776 | | ||
777 | |||
778 | **Probe mapping as below.** | ||
779 | |||
780 | [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS04%20-%20LoRaWAN%204-Channels%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/image-20220611160853-3.png?width=746&height=463&rev=1.1||alt="image-20220611160853-3.png" height="463" width="746"]] | ||
781 | |||
782 | |||
783 | == 2.7 Set Transmit Interval Time == | ||
784 | |||
785 | |||
786 | ((( | ||
787 | Feature: Change NB-IoT End Node Transmit Interval. | ||
788 | ))) | ||
789 | |||
790 | ((( | ||
791 | (% style="color:blue" %)**AT Command: AT+TDC** | ||
792 | ))) | ||
793 | |||
794 | (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) | ||
795 | |=(% style="width: 156px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 137px;background-color:#4F81BD;color:white" %)**Function**|=(% style="background-color:#4F81BD;color:white" %)**Response** | ||
796 | |(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|((( | ||
797 | 30000 | ||
798 | OK | ||
799 | the interval is 30000ms = 30s | ||
800 | ))) | ||
801 | |(% style="width:156px" %)AT+TDC=60000|(% style="width:137px" %)Set Transmit Interval|((( | ||
802 | OK | ||
803 | Set transmit interval to 60000ms = 60 seconds | ||
804 | ))) | ||
805 | |||
806 | ((( | ||
807 | (% style="color:blue" %)**Downlink Command: 0x01** | ||
808 | ))) | ||
809 | |||
810 | ((( | ||
811 | Format: Command Code (0x01) followed by 3 bytes time value. | ||
812 | ))) | ||
813 | |||
814 | ((( | ||
815 | If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01. | ||
816 | ))) | ||
817 | |||
818 | * ((( | ||
819 | Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds | ||
820 | ))) | ||
821 | * ((( | ||
822 | Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds | ||
823 | |||
824 | |||
825 | |||
826 | ))) | ||
827 | |||
828 | == 2.8 Set enable or disable of the measurement channel == | ||
829 | |||
830 | |||
831 | This command can be used when user connects **less than four distance sensors**. This command can turn off unused measurement channels to **save battery life**. | ||
832 | |||
833 | (% style="color:blue" %)**AT Command: AT+ENCHANNEL** | ||
834 | |||
835 | (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %) | ||
836 | |=(% style="width: 185px; background-color: #4F81BD; color: white;" %)**Command Example**|=(% style="width: 193px; background-color: #4F81BD; color: white;" %)**Function**|=(% style="width: 122px; background-color: #4F81BD; color: white;" %)**Response** | ||
837 | |(% style="width:183px" %)AT+ENCHANNEL=?|(% style="width:191px" %)Get enabled channels.|(% style="width:120px" %)1,1,1,1 (default) | ||
838 | OK | ||
839 | |(% style="width:183px" %)AT+ENCHANNEL=1,1,1,0|(% style="width:191px" %)Channel 4 disabled.|(% style="width:120px" %)OK | ||
840 | |(% style="width:183px" %)AT+ENCHANNEL=1,1,0,0|(% style="width:191px" %)Channel 3 and 4 disabled.|(% style="width:120px" %)OK | ||
841 | |||
842 | (% style="color:blue" %)**Downlink Command: 0x08** | ||
843 | |||
844 | Format: Command Code (0x08) followed by 4 bytes. | ||
845 | |||
846 | The first byte means the first channel, the second byte means the second channel, the third byte means the third channel, and the fourth byte means the fourth channel.And 1 means enable channel, 0 means disable channel. | ||
847 | |||
848 | * Example 1: Downlink Payload: 08 01 01 01 01 **~-~-->** AT+ENCHANNEL=1,1,1,1 ~/~/ All channels are enabled | ||
849 | |||
850 | * Example 2: Downlink Payload: 08 01 01 01 00 **~-~-->** AT+ENCHANNEL=1,1,1,0 ~/~/ Channel 4 disabled | ||
851 | |||
852 | * Example 3: Downlink Payload: 08 01 01 00 00 **~-~-->** AT+ENCHANNEL=1,1,0,0 ~/~/ Channel 3 and 4 disabled | ||
853 | |||
854 | |||
855 | = 3. Configure DDS04-NB = | ||
856 | |||
857 | == 3.1 Configure Methods == | ||
858 | |||
859 | |||
860 | DDS04-NB supports below configure method: | ||
861 | |||
862 | * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]]. | ||
863 | |||
864 | * 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]]. | ||
865 | |||
866 | |||
867 | == 3.2 AT Commands Set == | ||
868 | |||
869 | |||
870 | AT+<CMD>? : Help on <CMD> | ||
871 | |||
872 | AT+<CMD> : Run <CMD> | ||
873 | |||
874 | AT+<CMD>=<value> : Set the value | ||
875 | |||
876 | AT+<CMD>=? : Get the value | ||
877 | |||
878 | |||
879 | (% style="color:blue" %)**General Commands** | ||
880 | |||
881 | AT : Attention | ||
882 | |||
883 | AT? : Short Help | ||
884 | |||
885 | ATZ : MCU Reset | ||
886 | |||
887 | AT+TDC : Application Data Transmission Interval | ||
888 | |||
889 | AT+CFG : Print all configurations | ||
890 | |||
891 | AT+CFGMOD : Working mode selection | ||
892 | |||
893 | AT+DEUI : Get or set the Device ID | ||
894 | |||
895 | AT+INTMOD : Set the trigger interrupt mode | ||
896 | |||
897 | AT+5VT : Set extend the time of 5V power | ||
898 | |||
899 | AT+PRO : Choose agreement | ||
900 | |||
901 | AT+RXDL : Extend the sending and receiving time | ||
902 | |||
903 | AT+DNSCFG : Get or Set DNS Server | ||
904 | |||
905 | AT+GETSENSORVALUE : Returns the current sensor measurement | ||
906 | |||
907 | AT+NOUD : Get or Set the number of data to be uploaded | ||
908 | |||
909 | AT+CDP : Read or Clear cached data | ||
910 | |||
911 | AT+SHTEMP: Get or Set alarm of temp | ||
912 | |||
913 | AT+SHHUM: Get or Set alarm of moisture | ||
914 | |||
915 | AT+SERVADDR : Server Address | ||
916 | |||
917 | |||
918 | (% style="color:blue" %)**UDP Management** | ||
919 | |||
920 | AT+CFM : Upload confirmation mode (only valid for UDP) | ||
921 | |||
922 | |||
923 | (% style="color:blue" %)**MQTT Management** | ||
924 | |||
925 | AT+CLIENT : Get or Set MQTT client | ||
926 | |||
927 | AT+UNAME : Get or Set MQTT Username | ||
928 | |||
929 | AT+PWD : Get or Set MQTT password | ||
930 | |||
931 | AT+PUBTOPIC : Get or Set MQTT publish topic | ||
932 | |||
933 | AT+SUBTOPIC : Get or Set MQTT subscription topic | ||
934 | |||
935 | |||
936 | (% style="color:blue" %)**Information** | ||
937 | |||
938 | AT+FDR : Factory Data Reset | ||
939 | |||
940 | AT+PWORD : Serial Access Password | ||
941 | |||
942 | AT+LDATA : Get the last upload data | ||
943 | |||
944 | AT+CDP : Read or Clear cached data | ||
945 | |||
946 | |||
947 | = 4. Battery & Power Consumption = | ||
948 | |||
949 | |||
950 | DDS04-NB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace. | ||
951 | |||
952 | [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] . | ||
953 | |||
954 | |||
955 | = 5. Firmware update = | ||
956 | |||
957 | |||
958 | User can change device firmware to:: | ||
959 | |||
960 | * Update with new features. | ||
961 | |||
962 | * Fix bugs. | ||
963 | |||
964 | Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/82y41qxxaypn6n4/AACuN8dxt1gIqZ8iOX2wCGZga?dl=0]]** | ||
965 | |||
966 | Methods to Update Firmware: | ||
967 | |||
968 | * (Recommended way) OTA firmware update via BLE: [[**Instruction**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/BLE_Firmware_Update_NB_Sensors_BC660K-GL/]]. | ||
969 | |||
970 | * Update through UART TTL interface : **[[Instruction>>url:http://8.211.40.43/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/#H4.2.FirmwareupgradeusingSTM32Cubeprogramer]]**. | ||
971 | |||
972 | |||
973 | = 6. FAQ = | ||
974 | |||
975 | == 6.1 How can I access t BC660K-GL AT Commands? == | ||
976 | |||
977 | |||
978 | User can access to BC660K-GL directly and send AT Commands. | ||
979 | |||
980 | [[See BC660K-GL AT Command set>>url:https://www.dropbox.com/sh/5f6ssda5fum8rvs/AABT68l8ZzWOvZ5eg2qwOoFda?dl=0]] | ||
981 | |||
982 | |||
983 | = 7. Trouble Shooting = | ||
984 | |||
985 | == 7.1 Why does the sensor reading show 0 or "No sensor" == | ||
986 | |||
987 | |||
988 | ~1. The measurement object is very close to the sensor, but in the blind spot of the sensor. | ||
989 | |||
990 | 2. Sensor wiring is disconnected | ||
991 | |||
992 | 3. Not using the correct decoder | ||
993 | |||
994 | |||
995 | = 8. Order Info = | ||
996 | |||
997 | == 8.1 Main Device DDS04-NB == | ||
998 | |||
999 | |||
1000 | Part Number: (% style="color:blue" %)**DDS04-NB-XX** | ||
1001 | |||
1002 | (% style="color:red" %)**XX**(%%): | ||
1003 | |||
1004 | * (% style="color:#037691" %)**GE**(%%): General version ( Exclude SIM card) | ||
1005 | |||
1006 | * (% style="color:#037691" %)**1D**(%%): with 1NCE* 10 years 500MB SIM card and Pre-configure to DataCake server | ||
1007 | |||
1008 | (% 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 | ||
1009 | |||
1010 | |||
1011 | == 8.2 Probe Model == | ||
1012 | |||
1013 | |||
1014 | Detail See [[Probe Option>>||anchor="H1.4ProbeOptions"]] Section | ||
1015 | |||
1016 | * A01A-15 | ||
1017 | * A02-15 | ||
1018 | * A13-15 | ||
1019 | * A16-15 | ||
1020 | |||
1021 | |||
1022 | = 9. Packing Info = | ||
1023 | |||
1024 | |||
1025 | (% style="color:#037691" %)**Package Includes**: | ||
1026 | |||
1027 | * DDS04-NB NB-IoT 4-Channels Distance Detection sensor x 1 | ||
1028 | |||
1029 | * External antenna x 1 | ||
1030 | |||
1031 | (% style="color:#037691" %)**Dimension and weight**: | ||
1032 | |||
1033 | * Device Size: 13.0 x 5 x 4.5 cm | ||
1034 | |||
1035 | * Device Weight: 150g | ||
1036 | |||
1037 | * Package Size / pcs : 14.0 x 8x 5 cm | ||
1038 | |||
1039 | * Weight / pcs : 180g | ||
1040 | |||
1041 | |||
1042 | = 10. Support = | ||
1043 | |||
1044 | |||
1045 | * 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. | ||
1046 | |||
1047 | * 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]]. | ||
1048 | |||
1049 | (% style="display:none" %) (%%) |