Last modified by Mengting Qiu on 2024/05/09 14:30
Show last authors
1 (% style="text-align:center" %)
2 [[image:image-20230912150026-1.png||height="469" width="663"]]
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 DDS75-NB NB-IoT Distance Detection Sensor ==
23
24
25 The Dragino DDS75-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 DDS75-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 DDS75-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 DDS75-NB (% style="color:blue" %)**supports BLE configure **(%%)and(% style="color:blue" %)** OTA update**(%%) which make user easy to use.
32
33 DDS75-NB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long-term use up to several years.
34
35 DDS75-NB has optional built-in SIM card and default IoT server connection version. Which makes it works with simple configuration.
36
37 [[image:image-20230912153000-2.png||height="309" width="928"]]
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 280mm - 7500mm
47 * Accuracy: ±(1cm+S*0.3%) (S: Distance)
48 * Measure Angle: 40°
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 (% 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.**
178
179
180 == 1.9 BLE connection ==
181
182
183 DDS75-NB support BLE remote configure and firmware update.
184
185
186 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:
187
188 * Press button to send an uplink
189 * Press button to active device.
190 * Device Power on or reset.
191
192 If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode.
193
194
195 == 1.10 Pin Definitions , Switch & SIM Direction ==
196
197
198 [[image:image-20230819104805-5.png]]
199
200
201 === 1.10.1 Jumper JP2 ===
202
203
204 Power on Device when put this jumper.
205
206
207 === 1.10.2 BOOT MODE / SW1 ===
208
209
210 **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.
211
212 **2)** (% style="color:blue" %)**Flash**(%%): work mode, device starts to work and send out console output for further debug
213
214
215 === 1.10.3 Reset Button ===
216
217
218 Press to reboot the device.
219
220 (% style="display:none" %)
221
222
223 === 1.10.4 SIM Card Direction ===
224
225
226 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]].
227
228
229 == 1.11 Mechanical ==
230
231 [[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"]]
232
233 [[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"]]
234
235 [[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"]]
236
237
238 (% style="color:blue" %)**Probe Mechanical:**
239
240
241 [[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-20220610172003-1.png?rev=1.1||alt="image-20220610172003-1.png"]]
242
243
244 [[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-20220610172003-2.png?rev=1.1||alt="image-20220610172003-2.png"]]
245
246
247 = 2. Use DDS75-NB to communicate with IoT Server =
248
249 == 2.1 Send data to IoT server via NB-IoT network ==
250
251
252 The DDS75-NB is equipped with a NB-IoT module, the pre-loaded firmware in DDS75-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 DDS75-NB.
253
254 Below shows the network structure:
255
256 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/DDS75-NB_NB-IoT_Distance_Detection_Sensor_User_Manual/WebHome/image-20230912153000-2.png?width=928&height=309&rev=1.1||alt="image-20230912153000-2.png"]]
257
258
259 There are two version: (% style="color:blue" %)**-GE**(%%) and (% style="color:blue" %)**-1D**(%%) version of DDS75-NB.
260
261
262 (% 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 DDS75-NB send data to IoT server.
263
264 * 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]].
265
266 * 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]]. 
267
268 Below shows result of different server as a glance.
269
270 (% border="1" cellspacing="4" style="width:515px" %)
271 |(% 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**
272 |(% 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" %)(((
273 (% style="text-align:center" %)
274 [[image:image-20230819113244-8.png||height="183" width="367"]]
275 )))|(% style="width:170px" %)
276 |(% 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" %)(((
277 (% style="text-align:center" %)
278 [[image:image-20230819113244-9.png||height="119" width="367"]]
279 )))|(% style="width:170px" %)
280 |(% 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" %)
281 |(% 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" %)
282 |(% 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" %)
283 |(% 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" %)(((
284 (% style="text-align:center" %)
285 [[image:image-20230819113244-10.png||height="104" width="367"]]
286 )))|(% style="width:170px" %)
287 |(% 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" %)(((
288 (% style="text-align:center" %)
289 [[image:image-20230819113244-11.png||height="141" width="367"]]
290 )))|(% style="width:170px" %)
291
292 (% 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 DDS75-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]].
293
294
295 == ==
296
297
298
299 To meet different server requirement, DDS75-NB supports different payload type.
300
301 **Includes:**
302
303 * [[General JSON format payload>>||anchor="H2.2.1GeneralJsonFormat28Type3D529"]]. (Type=5)
304
305 * [[HEX format Payload>>||anchor="H2.2.2HEXformatPayload28Type3D029"]]. (Type=0)
306
307 * [[ThingSpeak Format>>||anchor="H2.2.4ThingSpeakPayload28Type3D129"]]. (Type=1)
308
309 * [[ThingsBoard Format>>||anchor="H2.2.3ThingsBoardPayload28Type3D329"]]. (Type=3)
310
311 User can specify the payload type when choose the connection protocol. Example:
312
313 (% style="color:#037691" %)**AT+PRO=2,0**  (%%) ~/~/ Use UDP Connection & hex Payload
314
315 (% style="color:#037691" %)**AT+PRO=2,5**   (%%) ~/~/ Use UDP Connection & Json Payload
316
317 (% style="color:#037691" %)**AT+PRO=3,5 ** (%%) ~/~/ Use MQTT Connection & Json Payload
318
319
320 === 2.2.1 General Json Format(Type~=5) ===
321
322
323 This is the General Json Format. As below:
324
325 (% style="color:#4472c4" %)**{"IMEI":"866207058378443","Model":"DDS75-NB","distance":396,"battery":3.50,"signal":22,"1":{748,2023/09/21 08:36:55},"2":{911,2023/09/21 07:44:35},"3":{702,2023/09/21 07:07:19},"4":{705,2023/09/21 06:52:19},"5":{705,2023/09/21 06:37:19},"6":{705,2023/09/21 06:20:49},"7":{256,2023/09/21 02:49:51},"8":{221,2023/09/20 09:47:01}}**
326
327
328 [[image:image-20230921173213-4.png||height="590" width="858"]]
329
330
331 (% style="color:red" %)**Notice, from above payload:**
332
333 * Distance , Battery & Signal are the value at uplink time.
334
335 * Json entry 1 ~~ 8 are the last 1 ~~ 8 sampling data as specify by (% style="color:#037691" %)**AT+NOUD=8 ** (%%)Command. Each entry includes (from left to right): Temperature, Humidity, Sampling time.
336
337 === 2.2.2 HEX format Payload(Type~=0) ===
338
339
340 This is the HEX Format. As below:
341
342 (% style="color:#4472c4" %)**f86620705837844309640db41201000159650c02e702ec650c00a7038f650bf46302be650beba702c1650be82302c1650be49f02c1650be0c10100650baf4f00dd650abf95**
343
344 [[image:image-20230921165015-2.png||height="195" width="965"]]
345
346
347 If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NB sensor uplink data.
348
349
350 [[image:image-20230921165050-3.png||height="621" width="905"]]
351
352 (% style="color:blue" %)**Version:**
353
354 These bytes include the hardware and software version.
355
356 (% style="color:#037691" %)**Higher byte:**(%%) Specify Sensor Model: 0x09 for DDS75-NB
357
358 (% style="color:#037691" %)**Lower byte:**(%%) Specify the software version: 0x64=100, means firmware version 1.0.0
359
360
361 (% style="color:blue" %)**BAT (Battery Info):**
362
363 Ex1: 0x0DB4 = 3508mV
364
365
366 (% style="color:blue" %)**Signal Strength:**
367
368 NB-IoT Network signal Strength.
369
370 **Ex1: 0x12 = 18**
371
372 **0**  -113dBm or less
373
374 **1**  -111dBm
375
376 **2...30** -109dBm... -53dBm
377
378 **31**   -51dBm or greater
379
380 **99**    Not known or not detectable
381
382
383 (% style="color:blue" %)**Distance:   **
384
385 Ex1: 0x00fb = 251mm
386
387
388 (% style="color:blue" %)**Timestamp:   **
389
390 Unit Timestamp Example: 650c0af9(H) = 1695288057(D)
391
392 Put the decimal value into this link([[https:~~/~~/www.epochconverter.com)>>https://www.epochconverter.com]]) to get the time.
393
394
395 === 2.2.3 ThingsBoard Payload(Type~=3) ===
396
397
398 Type3 payload special design for ThingsBoard, it will also configure other default server to ThingsBoard.
399
400 (% style="color:#4472c4" %)** {"IMEI": "866207058378443","Model": "DDS75-NB", "distance": 491,"battery": 3.57,"signal": 22}**
401
402 [[image:image-20230922091736-3.png||height="517" width="845"]]
403
404
405 === 2.2.4 ThingSpeak Payload(Type~=1) ===
406
407
408 This payload meets ThingSpeak platform requirement. It includes only four fields. Form 1~~3 are:
409
410 Distance, Battery & Signal. This payload type only valid for ThingsSpeak Platform.
411
412 As below:
413
414 (% style="color:#4472c4" %)**field1=Distance value&field2=Battery value&field3=Signal value**
415
416 [[image:image-20230921174457-5.png||height="556" width="849"]]
417
418
419 == 2.3  ​Uplink Payload ==
420
421
422 (((
423 DDS75-NB will uplink payload via NB-IoT with below payload format:
424 )))
425
426 (((
427 Uplink payload includes in total 21 bytes.
428 )))
429
430 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %)
431 |=(% style="width: 60px; background-color:#4F81BD;color:white" %)Size(bytes)|=(% style="width: 50px; background-color:#4F81BD;color:white" %)8|=(% style="width: 30px; 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
432 |(% style="width:95px" %)Value|(% style="width:61px" %)f+IMEI|(% style="width:61px" %)Ver|(% style="width:61px" %)[[BAT>>||anchor="H2.3.1A0BatteryInfo"]]|(% style="width:61px" %)(((
433 Signal Strength
434 )))|(% 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
435
436 If the cache upload mechanism is turned on, you will receive the payload shown in the figure below.
437
438 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:512px" %)
439 |(% 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)**
440
441 === 2.3.1  Battery Info ===
442
443
444 Check the battery voltage for DDS75-NB.
445
446 Ex1: 0x0B45 = 2885mV
447
448 Ex2: 0x0B49 = 2889mV
449
450
451 === 2.3.2  Interrupt ===
452
453
454 This data field shows if this packet is generated by interrupt or not.
455
456 **Example:**
457
458 0x00: Normal uplink packet.
459
460 0x01: Interrupt Uplink Packet.
461
462
463 (((
464 === 2.3.3  Distance ===
465
466
467 (((
468 Get the distance. Flat object range 280mm - 7500mm.
469 )))
470
471 (((
472 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" %)** **
473
474 (% style="color:blue" %)**0B05(H) = 2821 (D) = 2821 mm.**
475 )))
476
477 * If the sensor value is 0x0000, it means system doesn't detect ultrasonic sensor.
478
479 * If the sensor value lower than 0x0118 (280mm), the sensor value will be invalid. All value lower than 280mm will be set to 0x0014(20mm) which means the value is invalid.
480 )))
481
482
483 == 2.4 Test Uplink and Change Update Interval ==
484
485
486 By default, Sensor will send uplinks (% style="color:blue" %)**every 2 hours**(%%) & AT+NOUD=8
487
488 User can use below commands to change the (% style="color:blue" %)**uplink interval**.
489
490 (% style="color:#037691" %)**AT+TDC=600 ** (%%) ~/~/ Set Update Interval to 600s
491
492 User can also push the button for more than 1 seconds to activate an uplink.
493
494
495 == 2.5 Multi-Samplings and One uplink ==
496
497 (% style="color:red" %)Notice: The AT+NOUD feature is upgraded to Clock Logging, please refer [[Clock Logging Feature>>||anchor="H2.7Clocklogging28Sincefirmwareversionv1.2.129"]]
498
499 To save battery life, DDS75-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:
500
501 * (% 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)
502
503 * (% 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.
504
505 The diagram below explains the relationship between TR, NOUD, and TDC more clearly:
506
507 [[image:1692424376354-959.png]]
508
509
510 == 2.6 Trggier an uplink by external interrupt ==
511
512
513 DDS75-NB has an external trigger interrupt function. Users can use the PB15 pin to trigger the upload of data packets.
514
515 (% style="color:blue" %)**AT command:**
516
517 * (% style="color:#037691" %)**AT+INTMOD **(%%) ~/~/ Set the trigger interrupt mode
518
519 * (% style="color:#037691" %)**AT+INTMOD=0 **(%%) ~/~/ Disable Interrupt
520
521 * (% style="color:#037691" %)**AT+INTMOD=1 **(%%) ~/~/ Trigger by rising and falling edge
522
523 * (% style="color:#037691" %)**AT+INTMOD=2 **(%%) ~/~/ Trigger by falling edge
524
525 * (% style="color:#037691" %)**AT+INTMOD=3  **(%%) ~/~/ Trigger by rising edge
526
527 == 2.7 Clock logging (Since firmware version v1.2.1) ==
528
529
530 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.
531
532 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.
533
534 * (% style="color:blue" %)**AT command:**(%%)** (% style="color:#037691" %)AT+CLOCKLOG=a,b,c,d(%%)**
535
536 (% style="color:#037691" %)**a:**(%%)** 0:** Disable Clock logging.  ** 1: **Enable Clock Logging
537
538 (% 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.
539
540 (% style="color:#037691" %)**c: **(%%)Specify the sampling interval: range **(0 ~~ 255 minutes)**
541
542 (% style="color:#037691" %)**d:**(%%)** **How many entries should be uplink on every TDC **(max 32)**
543
544 [[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"]]
545
546 **Example:**
547
548 **AT+CLOCKLOG=1,65535,1,5**
549
550 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).
551
552 (% class="wikigeneratedid" %)
553 [[image:image-20240316105457-1.png||height="517" width="1163"]]
554
555 (% class="wikigeneratedid" %)
556 (% 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.**
557
558
559 == 2.8 Example Query saved historical records ==
560
561
562 * (% style="color:blue" %)**AT command:**(%%)** (% style="color:#037691" %)AT+CDP(%%)**
563
564 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.
565
566 (% class="wikigeneratedid" %)
567 [[image:image-20240316105532-2.png||height="626" width="811"]]
568
569
570 == 2.9 Uplink log query ==
571
572
573 * (% style="color:blue" %)**AT command:**(%%)** (% style="color:#037691" %)AT+GETLOG(%%)**
574
575 This command can be used to query upstream logs of data packets.
576
577 [[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"]]
578
579
580
581 = 3. Configure DDS75-NB =
582
583 == 3.1 Configure Methods ==
584
585
586 DDS75-NB supports below configure method:
587
588 * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
589
590 * 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]].
591
592 == 3.2 AT Commands Set ==
593
594
595 AT+<CMD>?        : Help on <CMD>
596
597 AT+<CMD>         : Run <CMD>
598
599 AT+<CMD>=<value> : Set the value
600
601 AT+<CMD>=?       : Get the value
602
603
604 (% style="color:blue" %)**General Commands**      
605
606 AT                    : Attention       
607
608 AT?  : Short Help     
609
610 ATZ  : MCU Reset    
611
612 AT+TDC  : Application Data Transmission Interval
613
614 AT+CFG  : Print all configurations
615
616 AT+CFGMOD           : Working mode selection
617
618 AT+DEUI  : Get or set the Device ID
619
620 AT+INTMOD            : Set the trigger interrupt mode
621
622 AT+5VT           : Set extend the time of 5V power  
623
624 AT+PRO          : Choose agreement
625
626 AT+RXDL  : Extend the sending and receiving time
627
628 AT+DNSCFG  : Get or Set DNS Server
629
630 AT+GETSENSORVALUE   : Returns the current sensor measurement
631
632 AT+NOUD  : Get or Set the number of data to be uploaded
633
634 AT+CDP     : Read or Clear cached data
635
636 AT+SHTEMP:  Get or Set alarm of temp
637
638 AT+SHHUM:  Get or Set alarm of moisture
639
640 AT+SERVADDR :  Server Address
641
642
643
644 (% style="color:blue" %)**MQTT Management**
645
646 AT+CLIENT               : Get or Set MQTT client
647
648 AT+UNAME              : Get or Set MQTT Username
649
650 AT+PWD                  : Get or Set MQTT password
651
652 AT+PUBTOPIC  : Get or Set MQTT publish topic
653
654 AT+SUBTOPIC  : Get or Set MQTT subscription topic
655
656
657 (% style="color:blue" %)**Information**          
658
659 AT+FDR  : Factory Data Reset
660
661 AT+PWORD  : Serial Access Password
662
663 AT+LDATA  : Get the last upload data
664
665 AT+CDP  : Read or Clear cached data
666
667
668 = 4. Battery & Power Consumption =
669
670
671 DDS75-NB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
672
673 [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
674
675
676 = 5. Firmware update =
677
678
679 User can change device firmware to::
680
681 * Update with new features.
682
683 * Fix bugs.
684
685 Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/spr33jrw3x45qnm/AADljOsDG-DesaL2WwTWSV55a?dl=0]]**
686
687 Methods to Update Firmware:
688
689 * (Recommended way) OTA firmware update via BLE: [[**Instruction**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/BLE_Firmware_Update_NB_Sensors_BC660K-GL/]].
690
691 * Update through UART TTL interface : **[[Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/UART_Access_for_NB_ST_BC660K-GL/#H4.2UpdateFirmware28Assumethedevicealreadyhaveabootloader29]]**.
692
693 = 6. FAQ =
694
695 == 6.1 How can I access t BC660K-GL AT Commands? ==
696
697
698 User can access to BC660K-GL directly and send AT Commands.
699
700 [[See BC660K-GL AT Command set>>url:https://www.dropbox.com/sh/5f6ssda5fum8rvs/AABT68l8ZzWOvZ5eg2qwOoFda?dl=0]]
701
702
703 == 6.2 Can I use DDS75-NB in condensation environment? ==
704
705
706 DDS75-NB is not suitable to be used in condensation environment. Condensation on the DDS75-NB probe will affect the reading and always got 0.
707
708
709 = 7. Trouble Shooting =
710
711 == 7.1 Why does the sensor reading show 0 or "No sensor" ==
712
713
714 ~1. The measurement object is very close to the sensor, but in the blind spot of the sensor.
715
716 2. Sensor wiring is disconnected
717
718 3. Not using the correct decoder
719
720
721 == 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 ==
722
723
724 1) Please check if there is something on the probe affecting its measurement (condensed water, volatile oil, etc.)
725
726 2) Does it change with temperature, temperature will affect its measurement
727
728 3) If abnormal data occurs, you can turn on DEBUG mode, Please use downlink or AT COMMAN to enter DEBUG mode.
729
730 downlink command: (% style="color:blue" %)**F1 01**(%%), AT command: (% style="color:blue" %)**AT+DDEBUG=1**
731
732 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
733
734 [[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"]]
735
736
737 Its original payload will be longer than other data. Even though it is being parsed, it can be seen that it is abnormal data.
738
739 Please send the data to us for check.
740
741
742 = 8. Order Info =
743
744
745 Part Number: (% style="color:blue" %)**DDS75-NB-XX**
746
747 (% style="color:red" %)**XX**(%%):
748
749 * (% style="color:#037691" %)**GE**(%%): General version ( Exclude SIM card)
750
751 * (% style="color:#037691" %)**1D**(%%): with 1NCE* 10 years 500MB SIM card and Pre-configure to DataCake server
752
753 (% 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
754
755
756 = 9. ​Packing Info =
757
758
759 (% style="color:#037691" %)**Package Includes**:
760
761 * DDS75-NB NB-IoT Distance Detection sensor x 1
762
763 * External antenna x 1
764
765 (% style="color:#037691" %)**Dimension and weight**:
766
767 * Device Size: 13.0 x 5 x 4.5 cm
768
769 * Device Weight: 150g
770
771 * Package Size / pcs : 14.0 x 8x 5 cm
772
773 * Weight / pcs : 180g
774
775 = 10. Support =
776
777
778 * 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.
779
780 * 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]].
781
782 (% style="display:none" %) (%%)

Applications

Navigation

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