Skip to Content
Version 100.2 by Xiaoling on 2023/10/10 09:10
Show last authors
1 (% style="text-align:center" %)
2 [[image:image-20231010090810-1.png||height="518" width="839"]]
3
4
5
6
7
8
9
10
11 **Table of Contents:**
12
13 {{toc/}}
14
15
16
17
18
19
20 = 1. Introduction =
21
22 == 1.1 What is DDS45-NB NB-IoT Distance Detection Sensor ==
23
24
25 The Dragino DDS45-NB is a (% style="color:blue" %)** NB-IoT Distance Detection Sensor**(%%) for Internet of Things solution. It is used to measure the distance between the sensor and a flat object. The distance detection sensor is a module that uses (% style="color:blue" %)** ultrasonic sensing technology**(%%) for distance measurement, and (% style="color:blue" %)** temperature compensation**(%%) is performed internally to improve the reliability of data. The DDS45-NB can be applied to scenarios such as horizontal distance measurement, liquid level measurement, parking management system, object proximity and presence detection, intelligent trash can management system, robot obstacle avoidance, automatic control, sewer, bottom water level monitoring, etc.
26
27 It detects the distance (% style="color:blue" %)** between the measured object and the sensor**(%%), and and send IoT platform via NB-IoT network.
28
29 DDS45-NB supports different uplink methods including (% style="color:blue" %)**MQTT, MQTTs, UDP & TCP**(%%) for different application requirement, and support uplinks to various IoT Servers.
30
31 DDS45-NB (% style="color:blue" %)**supports BLE configure **(%%)and(% style="color:blue" %)** OTA update**(%%) which make user easy to use.
32
33 DDS45-NB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long-term use up to several years.
34
35 DDS45-NB has optional built-in SIM card and default IoT server connection version. Which makes it works with simple configuration.
36
37 [[image:image-20230912102813-2.png||height="320" width="923"]]
38
39
40 == 1.2 ​Features ==
41
42
43 * NB-IoT Bands: B1/B2/B3/B4/B5/B8/B12/B13/B17/B18/B19/B20/B25/B28/B66/B70/B85 @H-FDD
44 * Ultra-low power consumption
45 * Distance Detection by Ultrasonic technology
46 * Flat object range 30mm - 4500mm
47 * Accuracy: ±(1cm+S*0.3%) (S: Distance)
48 * Measure Angle: 60°
49 * Multiply Sampling and one uplink
50 * Support Bluetooth v5.1 remote configure and update firmware
51 * Uplink on periodically
52 * Downlink to change configure
53 * IP66 Waterproof Enclosure
54 * 8500mAh Battery for long term use
55 * Nano SIM card slot for NB-IoT SIM
56
57 == 1.3 Specification ==
58
59
60 (% style="color:blue" %)**Common DC Characteristics:**
61
62 * Supply Voltage: 2.5v ~~ 3.6v
63 * Operating Temperature: -40 ~~ 85°C
64
65 (% style="color:blue" %)**NB-IoT Spec:**
66
67 (% style="color:#037691" %)**NB-IoT Module: BC660K-GL**
68
69 (% style="color:#037691" %)**Support Bands:**
70
71 * B1 @H-FDD: 2100MHz
72 * B2 @H-FDD: 1900MHz
73 * B3 @H-FDD: 1800MHz
74 * B4 @H-FDD: 2100MHz
75 * B5 @H-FDD: 860MHz
76 * B8 @H-FDD: 900MHz
77 * B12 @H-FDD: 720MHz
78 * B13 @H-FDD: 740MHz
79 * B17 @H-FDD: 730MHz
80 * B18 @H-FDD: 870MHz
81 * B19 @H-FDD: 870MHz
82 * B20 @H-FDD: 790MHz
83 * B25 @H-FDD: 1900MHz
84 * B28 @H-FDD: 750MHz
85 * B66 @H-FDD: 2000MHz
86 * B70 @H-FDD: 2000MHz
87 * B85 @H-FDD: 700MHz
88
89 (% style="color:blue" %)**Battery:**
90
91 * Li/SOCI2 un-chargeable battery
92 * Capacity: 8500mAh
93 * Self Discharge: <1% / Year @ 25°C
94 * Max continuously current: 130mA
95 * Max boost current: 2A, 1 second
96
97 (% style="color:blue" %)**Power Consumption**
98
99 * STOP Mode: 10uA @ 3.3v
100 * Max transmit power: 350mA@3.3v
101
102 == 1.4 Rated environmental conditions ==
103
104
105 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:500px" %)
106 |(% style="background-color:#4f81bd; color:white; width:163px" %)**Item**|(% style="background-color:#4f81bd; color:white; width:90px" %)**Minimum value**|(% style="background-color:#4f81bd; color:white; width:70px" %)**Typical value**|(% style="background-color:#4f81bd; color:white; width:87px" %)**Maximum value**|(% style="background-color:#4f81bd; color:white; width:40px" %)**Unit**|(% style="background-color:#4f81bd; color:white; width:50px" %)**Remarks**
107 |(% style="width:174px" %)Storage temperature|(% style="width:86px" %)-25|(% style="width:66px" %)25|(% style="width:90px" %)80|(% style="width:48px" %)℃|(% style="width:203px" %)
108 |(% style="width:174px" %)Storage humidity|(% style="width:86px" %) |(% style="width:66px" %)65%|(% style="width:90px" %)90%|(% style="width:48px" %)RH|(% style="width:203px" %)(1)
109 |(% style="width:174px" %)Operating temperature|(% style="width:86px" %)-15|(% style="width:66px" %)25|(% style="width:90px" %)60|(% style="width:48px" %)℃|(% style="width:203px" %)
110 |(% style="width:174px" %)Working humidity|(% style="width:86px" %)(((
111
112
113
114 )))|(% style="width:66px" %)65%|(% style="width:90px" %)80%|(% style="width:48px" %)RH|(% style="width:203px" %)(1)
115
116 (((
117 (% style="color:red" %)**Remarks: (1) a. When the ambient temperature is 0-39 ℃, the maximum humidity is 90% (non-condensing);       **
118
119 (% style="color:red" %)** b. When the ambient temperature is 40-50 ℃, the highest humidity is the highest humidity in the natural world at the current temperature (no condensation)**
120
121
122 )))
123
124 == 1.5 Effective measurement range Reference beam pattern ==
125
126
127 (% style="color:blue" %)**1. The tested object is a white cylindrical tube made of PVC, with a height of 100cm and a diameter of 7.5cm.**
128
129 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS75%20-%20LoRaWAN%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654852253176-749.png?rev=1.1||alt="1654852253176-749.png"]]
130
131
132 (% style="color:blue" %)**2. The object to be tested is a "corrugated cardboard box" perpendicular to the central axis of 0 °, and the length * width is 60cm * 50cm.**
133
134 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS75%20-%20LoRaWAN%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654852175653-550.png?rev=1.1||alt="1654852175653-550.png"]]
135
136
137 == 1.6 Applications ==
138
139
140 * Horizontal distance measurement
141 * Liquid level measurement
142 * Parking management system
143 * Object proximity and presence detection
144 * Intelligent trash can management system
145 * Robot obstacle avoidance
146 * Automatic control
147 * Sewer
148 * Bottom water level monitoring
149
150 == 1.7 Sleep mode and working mode ==
151
152
153 (% style="color:blue" %)**Deep Sleep Mode: **(%%)Sensor doesn't have any NB-IoT activate. This mode is used for storage and shipping to save battery life.
154
155 (% style="color:blue" %)**Working Mode:** (%%)In this mode, Sensor will work as NB-IoT Sensor to Join NB-IoT network and send out sensor data to server. Between each sampling/tx/rx periodically, sensor will be in IDLE mode), in IDLE mode, sensor has the same power consumption as Deep Sleep mode.
156
157
158 == 1.8 Button & LEDs ==
159
160
161 [[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675071855856-879.png]]
162
163
164 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
165 |=(% 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**
166 |(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:117px" %)Send an uplink|(% style="width:225px" %)(((
167 If sensor has already attached to NB-IoT network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once.
168 Meanwhile, BLE module will be active and user can connect via BLE to configure device.
169 )))
170 |(% style="width:167px" %)Pressing ACT for more than 3s|(% style="width:117px" %)Active Device|(% style="width:225px" %)(((
171 (% 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.
172 (% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network.
173 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.
174 )))
175 |(% style="width:167px" %)Fast press ACT 5 times.|(% style="width:117px" %)Deactivate Device|(% style="width:225px" %)(% style="color:red" %)**Red led**(%%) will solid on for 5 seconds. Means device is in Deep Sleep Mode.
176
177 == 1.9 BLE connection ==
178
179
180 DDS45-NB support BLE remote configure and firmware update.
181
182
183 BLE can be used to configure the parameter of sensor or see the console output from sensor. BLE will be only activate on below case:
184
185 * Press button to send an uplink
186 * Press button to active device.
187 * Device Power on or reset.
188
189 If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode.
190
191
192 == 1.10 Pin Definitions & Switch ==
193
194
195 [[image:image-20230819104805-5.png]]
196
197
198 === 1.10.1 Jumper JP2 ===
199
200
201 Power on Device when put this jumper.
202
203
204 === 1.10.2 BOOT MODE / SW1 ===
205
206
207 **1)** (% style="color:blue" %)**ISP**(%%): upgrade mode, device won't have any signal in this mode. but ready for upgrade firmware. LED won't work. Firmware won't run.
208
209 **2)** (% style="color:blue" %)**Flash**(%%): work mode, device starts to work and send out console output for further debug
210
211
212 === 1.10.3 Reset Button ===
213
214
215 Press to reboot the device.
216
217 (% style="display:none" %)
218
219
220 == 1.11 Mechanical ==
221
222 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual/WebHome/1675143884058-338.png?rev=1.1||alt="1675143884058-338.png"]]
223
224 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual/WebHome/1675143899218-599.png?rev=1.1||alt="1675143899218-599.png"]]
225
226 [[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"]]
227
228
229 (% style="color:blue" %)**Probe Mechanical:**
230
231 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS45%20-%20LoRaWAN%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654915562090-396.png?rev=1.1||alt="1654915562090-396.png"]]
232
233
234
235 = 2. Use DDS45-NB to communicate with IoT Server =
236
237 == 2.1 Send data to IoT server via NB-IoT network ==
238
239
240 The DDS45-NB is equipped with a NB-IoT module, the pre-loaded firmware in DDS45-NB will get environment data from sensors and send the value to local NB-IoT network via the NB-IoT module.  The NB-IoT network will forward this value to IoT server via the protocol defined by DDS45-NB.
241
242
243 Below shows the network structure:
244
245 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/DDS45-NB_NB-IoT_Distance_Detection_Sensor_User_Manual/WebHome/image-20230912102813-2.png?width=923&height=320&rev=1.1||alt="image-20230912102813-2.png"]]
246
247
248 There are two version: (% style="color:blue" %)**-GE**(%%) and (% style="color:blue" %)**-1D**(%%) version of DDS45-NB.
249
250
251 (% style="color:blue" %)**GE Version**(%%): This version doesn't include SIM card or point to any IoT server. User needs to use AT Commands to configure below two steps to set DDS45-NB send data to IoT server.
252
253 * Install NB-IoT SIM card and configure APN. See instruction of [[Attach Network>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H2.AttachNetwork]].
254
255 * 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]]. 
256
257 Below shows result of different server as a glance.
258
259 (% border="1" cellspacing="4" style="width:515px" %)
260 |(% 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**
261 |(% 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" %)(((
262 (% style="text-align:center" %)
263 [[image:image-20230819113244-8.png||height="183" width="367"]]
264 )))|(% style="width:170px" %)
265 |(% 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" %)(((
266 (% style="text-align:center" %)
267 [[image:image-20230819113244-9.png||height="119" width="367"]]
268 )))|(% style="width:170px" %)
269 |(% 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" %)
270 |(% 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" %)
271 |(% 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" %)
272 |(% 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" %)(((
273 (% style="text-align:center" %)
274 [[image:image-20230819113244-10.png||height="104" width="367"]]
275 )))|(% style="width:170px" %)
276 |(% 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" %)(((
277 (% style="text-align:center" %)
278 [[image:image-20230819113244-11.png||height="141" width="367"]]
279 )))|(% style="width:170px" %)
280
281 (% style="color:blue" %)**1D Version**(%%): This version has 1NCE SIM card pre-installed and configure to send value to DataCake. User Just need to select the sensor type in DataCake and Activate DDS45-NB and user will be able to see data in DataCake. See here for [[DataCake Config Instruction>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.4Datacake]].
282
283
284 == 2.2 ​Payload Types ==
285
286
287 To meet different server requirement, DDS45-NB supports different payload type.
288
289 **Includes:**
290
291 * [[General JSON format payload>>||anchor="H2.2.1GeneralJsonFormat28Type3D529"]]. (Type=5)
292
293 * [[HEX format Payload>>||anchor="H2.2.2HEXformatPayload28Type3D029"]]. (Type=0)
294
295 * [[ThingSpeak Format>>||anchor="H2.2.4ThingSpeakPayload28Type3D129"]]. (Type=1)
296
297 * [[ThingsBoard Format>>||anchor="H2.2.3ThingsBoardPayload28Type3D329"]]. (Type=3)
298
299 User can specify the payload type when choose the connection protocol. Example:
300
301 (% style="color:#037691" %)**AT+PRO=2,0**  (%%) ~/~/ Use UDP Connection & hex Payload
302
303 (% style="color:#037691" %)**AT+PRO=2,5**   (%%) ~/~/ Use UDP Connection & Json Payload
304
305 (% style="color:#037691" %)**AT+PRO=3,5 ** (%%) ~/~/ Use MQTT Connection & Json Payload
306
307
308 === 2.2.1 General Json Format(Type~=5) ===
309
310
311 This is the General Json Format. As below:
312
313 (% style="color:#4472c4" %)**{"IMEI":"866207058378443","Model":"DDS45-NB","distance":217,"battery":3.54,"signal":24,"1":{221,2023/09/20 09:47:01},"2":{0,2023/09/20 09:15:04},"3":{0,2023/09/20 09:00:04},"4":{0,2023/09/20 08:45:03},"5":{0,2023/09/20 08:30:03},"6":{0,2023/09/20 08:15:03},"7":{0,2023/09/20 08:00:04},"8":{0,2023/09/20 07:45:04}}**
314
315
316 [[image:image-20230920175015-3.png||height="613" width="890"]]
317
318
319 (% style="color:red" %)**Notice, from above payload:**
320
321 * Distance , Battery & Signal are the value at uplink time.
322
323 * Json entry 1 ~~ 8 are the last 1 ~~ 8 sampling data as specify by (% style="color:#037691" %)**AT+NOUD=8 ** (%%)Command. Each entry includes (from left to right): Distance, Sampling time.
324
325 === 2.2.2 HEX format Payload(Type~=0) ===
326
327
328 This is the HEX Format. As below:
329
330 (% style="color:#4472c4" %)**f8662070583784430b640dda15010003a4650abc400000650ab8180000650ab4940000650ab10f0000650aad8b0000650aaa070000650aa6840000650aa3000000650a9308**
331
332 [[image:image-20230920172200-1.png||height="191" width="1047"]]
333
334
335 If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NB sensor uplink data.
336
337 [[image:image-20230920173352-2.png||height="636" width="919"]]
338
339
340 (% style="color:blue" %)**Version:**
341
342 These bytes include the hardware and software version.
343
344 (% style="color:#037691" %)**Higher byte:**(%%) Specify Sensor Model: 0x0b for DDS45-NB
345
346 (% style="color:#037691" %)**Lower byte:**(%%) Specify the software version: 0x64=100, means firmware version 1.0.0
347
348
349 (% style="color:blue" %)**BAT (Battery Info):**
350
351 Ex1: 0x0dda = 3546mV
352
353
354 (% style="color:blue" %)**Signal Strength:**
355
356 NB-IoT Network signal Strength.
357
358 **Ex1: 0x15 = 21**
359
360 **0**  -113dBm or less
361
362 **1**  -111dBm
363
364 **2...30** -109dBm... -53dBm
365
366 **31**   -51dBm or greater
367
368 **99**    Not known or not detectable
369
370
371 (% style="color:blue" %)**Distance:  **
372
373 Ex1: 0x03a4 = 932 mm
374
375
376 (% style="color:blue" %)**Timestamp:   **
377
378 Unit Timestamp Example: 650abc40(H) = 1695202368(D)
379
380 Put the decimal value into this link([[https:~~/~~/www.epochconverter.com)>>https://www.epochconverter.com]]) to get the time.
381
382
383 === 2.2.3 ThingsBoard Payload(Type~=3) ===
384
385
386 Type3 payload special design for ThingsBoard, it will also configure other default server to ThingsBoard.
387
388 (% style="color:#4472c4" %)** {"IMEI": "866207058378443","Model": "DDS45-NB","distance": 502,"battery": 3.57,"signal": 23}**
389
390 [[image:image-20230922094043-2.png||height="558" width="851"]]
391
392
393 === ===
394
395 === 2.2.4 ThingSpeak Payload(Type~=1) ===
396
397
398 This payload meets ThingSpeak platform requirement. It includes only four fields. Form 1~~3 are:
399
400 Distance, Battery & Signal. This payload type only valid for ThingsSpeak Platform
401
402 As below:
403
404 (% style="color:#4472c4" %)**field1=Distance value&field2=Battery value&field3=Singal value**
405
406 [[image:image-20230921104741-1.png||height="565" width="826"]]
407
408
409 == 2.3  ​Uplink Payload ==
410
411
412 (((
413 DDS45-NB will uplink payload via LoRaWAN with below payload format: 
414 )))
415
416 (((
417 Uplink payload includes in total 21 bytes.
418 )))
419
420 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %)
421 |=(% style="width: 95px; background-color:#4F81BD;color:white" %)Size(bytes)|=(% style="width: 61px; background-color:#4F81BD;color:white" %)8|=(% style="width: 61px; background-color:#4F81BD;color:white" %)2|=(% style="background-color:#4F81BD;color:white" %)2|=(% style="background-color:#4F81BD;color:white" %)1|=(% style="background-color: rgb(79, 129, 189); color: white; width: 49px;" %)1|=(% style="background-color: rgb(79, 129, 189); color: white; width: 79px;" %)1|=(% style="background-color:#4F81BD;color:white" %)2|=(% style="background-color:#4F81BD;color:white" %)4
422 |(% style="width:95px" %)Value|(% style="width:61px" %)f+IMEI|(% style="width:61px" %)Ver|(% style="width:61px" %)[[BAT>>||anchor="H2.3.1A0BatteryInfo"]]|(% style="width:61px" %)(((
423 Singal
424
425 Strength
426 )))|(% style="width:49px" %)Mod|(% style="width:79px" %)[[Digital Interrupt >>||anchor="H2.3.2A0Interrupt"]]|(% style="width:61px" %)[[Distance>>||anchor="H2.3.3A0Distance"]](unit: mm)|(% style="width:61px" %)(((
427 Timestamp
428
429
430 )))
431
432 If the cache upload mechanism is turned on, you will receive the payload shown in the figure below.
433
434 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:512px" %)
435 |(% style="width:115px" %)**Frame header**|(% style="width:118px" %)**Frame data(1)**|(% style="width:116px" %)**Frame data(2)**|(% style="width:39px" %)**F…**|(% style="width:117px" %)**Frame data(X)**
436
437 === ===
438
439 === 2.3.1  Battery Info ===
440
441
442 Check the battery voltage for DDS45-NB.
443
444 Ex1: 0x0B45 = 2885mV
445
446 Ex2: 0x0B49 = 2889mV
447
448
449 === 2.3.2  Interrupt ===
450
451
452 This data field shows if this packet is generated by interrupt or not.
453
454 **Example:**
455
456 0x00: Normal uplink packet.
457
458 0x01: Interrupt Uplink Packet.
459
460
461 === 2.3.3  Distance ===
462
463
464 (((
465 Get the distance. Flat object range 30mm - 4500mm.
466 )))
467
468 (((
469 For example, if the data you get from the register is **0x0B 0x05**, the distance between the sensor and the measured object is(% style="color:#4472c4" %)** **
470
471 (% style="color:blue" %)**0B05(H) = 2821 (D) = 2821 mm.**
472 )))
473
474 * If the sensor value is 0x0000, it means system doesn't detect ultrasonic sensor.
475
476 * If the sensor value lower than 0x001E (30mm), the sensor value will be 0x00.
477
478 (((
479
480 )))
481
482 == 2.4 Test Uplink and Change Update Interval ==
483
484
485 By default, Sensor will send uplinks (% style="color:blue" %)**every 2 hours**(%%) & AT+NOUD=8
486
487 User can use below commands to change the (% style="color:blue" %)**uplink interval**.
488
489 (% style="color:#037691" %)**AT+TDC=600 ** (%%) ~/~/ Set Update Interval to 600s
490
491 User can also push the button for more than 1 seconds to activate an uplink.
492
493
494 == 2.5 Multi-Samplings and One uplink ==
495
496
497 To save battery life, DDS45-NB will sample Distance data every 15 minutes and send one uplink every 2 hours. So each uplink it will include 8 stored data + 1 real-time data. They are defined by:
498
499 * (% style="color:#037691" %)**AT+TR=900**   (%%) ~/~/ The unit is seconds, and the default is to record data once every 900 seconds (15 minutes, the minimum can be set to 180 seconds)
500
501 * (% 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.
502
503 The diagram below explains the relationship between TR, NOUD, and TDC more clearly:
504
505 [[image:1692424376354-959.png]]
506
507
508 == 2.6 Trggier an uplink by external interrupt ==
509
510
511 DDS45-NB has an external trigger interrupt function. Users can use the PB15 pin to trigger the upload of data packets.
512
513 (% style="color:blue" %)**AT command:**
514
515 * (% style="color:#037691" %)**AT+INTMOD **(%%) ~/~/ Set the trigger interrupt mode
516
517 * (% style="color:#037691" %)**AT+INTMOD=0 **(%%) ~/~/ Disable Interrupt
518
519 * (% style="color:#037691" %)**AT+INTMOD=1 **(%%) ~/~/ Trigger by rising and falling edge
520
521 * (% style="color:#037691" %)**AT+INTMOD=2 **(%%) ~/~/ Trigger by falling edge
522
523 * (% style="color:#037691" %)**AT+INTMOD=3  **(%%) ~/~/ Trigger by rising edge
524
525 = 3. Configure DDS45-NB =
526
527 == 3.1 Configure Methods ==
528
529
530 DDS45-NB supports below configure method:
531
532 * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
533
534 * AT Command via UART Connection : See [[UART Connection>>http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H2.3UARTConnectionforSN50v3basemotherboard]].
535
536 == 3.2 AT Commands Set ==
537
538
539 AT+<CMD>?        : Help on <CMD>
540
541 AT+<CMD>         : Run <CMD>
542
543 AT+<CMD>=<value> : Set the value
544
545 AT+<CMD>=?       : Get the value
546
547
548 (% style="color:blue" %)**General Commands**      
549
550 AT                    : Attention       
551
552 AT?  : Short Help     
553
554 ATZ  : MCU Reset    
555
556 AT+TDC  : Application Data Transmission Interval
557
558 AT+CFG  : Print all configurations
559
560 AT+CFGMOD           : Working mode selection
561
562 AT+DEUI  : Get or set the Device ID
563
564 AT+INTMOD            : Set the trigger interrupt mode
565
566 AT+5VT           : Set extend the time of 5V power  
567
568 AT+PRO          : Choose agreement
569
570 AT+RXDL  : Extend the sending and receiving time
571
572 AT+DNSCFG  : Get or Set DNS Server
573
574 AT+GETSENSORVALUE   : Returns the current sensor measurement
575
576 AT+NOUD  : Get or Set the number of data to be uploaded
577
578 AT+CDP     : Read or Clear cached data
579
580 AT+SHTEMP:  Get or Set alarm of temp
581
582 AT+SHHUM:  Get or Set alarm of moisture
583
584 AT+SERVADDR :  Server Address
585
586
587 (% style="color:blue" %)**UDP Management**
588
589 AT+CFM  :  Upload confirmation mode (only valid for UDP)
590
591
592 (% style="color:blue" %)**MQTT Management**
593
594 AT+CLIENT               : Get or Set MQTT client
595
596 AT+UNAME              : Get or Set MQTT Username
597
598 AT+PWD                  : Get or Set MQTT password
599
600 AT+PUBTOPIC  : Get or Set MQTT publish topic
601
602 AT+SUBTOPIC  : Get or Set MQTT subscription topic
603
604
605 (% style="color:blue" %)**Information**          
606
607 AT+FDR  : Factory Data Reset
608
609 AT+PWORD  : Serial Access Password
610
611 AT+LDATA  : Get the last upload data
612
613 AT+CDP  : Read or Clear cached data
614
615
616 = 4. Battery & Power Consumption =
617
618
619 DDS45-NB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
620
621 [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
622
623
624 = 5. Firmware update =
625
626
627 User can change device firmware to::
628
629 * Update with new features.
630
631 * Fix bugs.
632
633 Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/l0bszumyrmil3yv/AAAg8LYGeAgDsD_ycCnweD72a?dl=0]]**
634
635 Methods to Update Firmware:
636
637 * (Recommended way) OTA firmware update via BLE: [[**Instruction**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/BLE_Firmware_Update_NB_Sensors_BC660K-GL/]].
638
639 * Update through UART TTL interface : **[[Instruction>>url:http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H1.LoRaSTv4baseHardware]]**.
640
641 = 6. FAQ =
642
643 == 6.1 How can I access t BC660K-GL AT Commands? ==
644
645
646 User can access to BC660K-GL directly and send AT Commands.
647
648 [[See BC660K-GL AT Command set>>url:https://www.dropbox.com/sh/5f6ssda5fum8rvs/AABT68l8ZzWOvZ5eg2qwOoFda?dl=0]]
649
650
651 == 6.2 Can I use DDS45-NB in condensation environment? ==
652
653
654 DDS45-NB is not suitable to be used in condensation environment. Condensation on the DDS45-NB probe will affect the reading and always got 0.
655
656
657 = 7. Trouble Shooting =
658
659 == 7.1 Why does the sensor reading show 0 or "No sensor" ==
660
661
662 ~1. The measurement object is very close to the sensor, but in the blind spot of the sensor.
663
664 2. Sensor wiring is disconnected
665
666 3. Not using the correct decoder
667
668
669 == 7.2 Abnormal readings The gap between multiple readings is too large or the gap between the readings and the actual value is too large ==
670
671
672 1) Please check if there is something on the probe affecting its measurement (condensed water, volatile oil, etc.)
673
674 2) Does it change with temperature, temperature will affect its measurement
675
676 3) If abnormal data occurs, you can turn on DEBUG mode, Please use downlink or AT COMMAN to enter DEBUG mode.
677
678 downlink command: (% style="color:blue" %)**F1 01**(%%), AT command: (% style="color:blue" %)**AT+DDEBUG=1**
679
680 4) After entering the debug mode, it will send 20 pieces of data at a time, and you can send its uplink to us for analysis
681
682 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS75%20-%20LoRaWAN%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/image-20230113135125-2.png?width=1057&height=136&rev=1.1||alt="image-20230113135125-2.png"]]
683
684
685 Its original payload will be longer than other data. Even though it is being parsed, it can be seen that it is abnormal data.
686
687 Please send the data to us for check.
688
689
690 = 8. Order Info =
691
692
693 Part Number: (% style="color:blue" %)**DDS45-NB-XX**
694
695 (% style="color:red" %)**XX**(%%):
696
697 * (% style="color:#037691" %)**GE**(%%): General version ( Exclude SIM card)
698
699 * (% style="color:#037691" %)**1D**(%%): with 1NCE* 10 years 500MB SIM card and Pre-configure to DataCake server
700
701 (% 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
702
703
704 = 9. ​Packing Info =
705
706
707 (% style="color:#037691" %)**Package Includes**:
708
709 * DDS45-NB NB-IoT Distance Detection sensor x 1
710
711 * External antenna x 1
712
713 (% style="color:#037691" %)**Dimension and weight**:
714
715 * Device Size: 13.0 x 5 x 4.5 cm
716
717 * Device Weight: 150g
718
719 * Package Size / pcs : 14.0 x 8x 5 cm
720
721 * Weight / pcs : 180g
722
723 = 10. Support =
724
725
726 * 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.
727
728 * 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]].
729
730 (% style="display:none" %) (%%)