Last modified by Bei Jinggeng on 2024/05/31 09:53
<
From version < 74.1 >
edited by Xiaoling
on 2022/07/09 08:50
To version < 91.2 >
edited by Xiaoling
on 2022/07/09 09:58
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,12 +1,10 @@
1 -
1 +(% style="text-align:center" %)
2 +[[image:image-20220709085040-1.png||height="542" width="524"]]
2 2  
3 -(% style="display:none" %) [[image:image-20220709084458-4.png||height="521" width="487"]]
4 4  
5 5  
6 6  
7 7  
8 -
9 -
10 10  **Table of Contents:**
11 11  
12 12  
... ... @@ -37,25 +37,28 @@
37 37  [[image:1654503236291-817.png]]
38 38  
39 39  
40 -[[image:1657245163077-232.png]]
38 +[[image:1657327959271-447.png]]
41 41  
42 42  
43 43  
44 44  == 1.2 ​ Features ==
45 45  
44 +
46 46  * NB-IoT Bands: B1/B3/B8/B5/B20/B28 @H-FDD
47 -* Monitor Soil Moisture
48 -* Monitor Soil Temperature
49 -* Monitor Soil Conductivity
46 +* Ultra low power consumption
47 +* Distance Detection by Ultrasonic technology
48 +* Flat object range 280mm - 7500mm
49 +* Accuracy: ±(1cm+S*0.3%) (S: Distance)
50 +* Cable Length: 25cm
50 50  * AT Commands to change parameters
51 51  * Uplink on periodically
52 52  * Downlink to change configure
53 53  * IP66 Waterproof Enclosure
54 -* Ultra-Low Power consumption
55 -* AT Commands to change parameters
56 56  * Micro SIM card slot for NB-IoT SIM
57 57  * 8500mAh Battery for long term use
58 58  
58 +
59 +
59 59  == 1.3  Specification ==
60 60  
61 61  
... ... @@ -73,58 +73,71 @@
73 73  * - B20 @H-FDD: 800MHz
74 74  * - B28 @H-FDD: 700MHz
75 75  
76 -Probe(% style="color:#037691" %)** Specification:**
77 +(% style="color:#037691" %)**Battery:**
77 77  
78 -Measure Volume: Base on the centra pin of the probe, a cylinder with 7cm diameter and 10cm height.
79 +* Li/SOCI2 un-chargeable battery
80 +* Capacity: 8500mAh
81 +* Self Discharge: <1% / Year @ 25°C
82 +* Max continuously current: 130mA
83 +* Max boost current: 2A, 1 second
79 79  
80 -[[image:image-20220708101224-1.png]]
85 +(% style="color:#037691" %)**Power Consumption**
81 81  
87 +* STOP Mode: 10uA @ 3.3v
88 +* Max transmit power: 350mA@3.3v
82 82  
83 -
84 84  == ​1.4  Applications ==
85 85  
92 +* Smart Buildings & Home Automation
93 +* Logistics and Supply Chain Management
94 +* Smart Metering
86 86  * Smart Agriculture
96 +* Smart Cities
97 +* Smart Factory
87 87  
88 88  (% class="wikigeneratedid" id="H200B1.5FirmwareChangelog" %)
89 89  ​
90 90  
102 +
103 +
91 91  == 1.5  Pin Definitions ==
92 92  
93 93  
94 -[[image:1657246476176-652.png]]
107 +[[image:1657328609906-564.png]]
95 95  
96 96  
97 97  
98 -= 2.  Use NSE01 to communicate with IoT Server =
111 += 2.  Use NDDS75 to communicate with IoT Server =
99 99  
100 100  == 2.1  How it works ==
101 101  
102 -
103 103  (((
104 -The NSE01 is equipped with a NB-IoT module, the pre-loaded firmware in NSE01 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 NSE01.
116 +The NDDS75 is equipped with a NB-IoT module, the pre-loaded firmware in NDDS75 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 NDDS75.
105 105  )))
106 106  
107 107  
108 108  (((
109 -The diagram below shows the working flow in default firmware of NSE01:
121 +The diagram below shows the working flow in default firmware of NDDS75:
110 110  )))
111 111  
112 -[[image:image-20220708101605-2.png]]
113 -
114 114  (((
115 115  
116 116  )))
117 117  
128 +[[image:1657328659945-416.png]]
118 118  
130 +(((
131 +
132 +)))
119 119  
120 -== 2.2 ​ Configure the NSE01 ==
121 121  
135 +== 2.2 ​ Configure the NDDS75 ==
122 122  
137 +
123 123  === 2.2.1 Test Requirement ===
124 124  
125 -
126 126  (((
127 -To use NSE01 in your city, make sure meet below requirements:
141 +To use NDDS75 in your city, make sure meet below requirements:
128 128  )))
129 129  
130 130  * Your local operator has already distributed a NB-IoT Network there.
... ... @@ -132,11 +132,11 @@
132 132  * Your operator is able to distribute the data received in their NB-IoT network to your IoT server.
133 133  
134 134  (((
135 -Below figure shows our testing structure. Here we have NB-IoT network coverage by China Mobile, the band they use is B8.  The NSE01 will use CoAP((% style="color:red" %)120.24.4.116:5683)(%%) or raw UDP((% style="color:red" %)120.24.4.116:5601)(%%) or MQTT((% style="color:red" %)120.24.4.116:1883)(%%)or TCP((% style="color:red" %)120.24.4.116:5600)(%%)protocol to send data to the test server
149 +Below figure shows our testing structure. Here we have NB-IoT network coverage by China Mobile, the band they use is B8.  The NDDS75 will use CoAP((% style="color:red" %)120.24.4.116:5683)(%%) or raw UDP((% style="color:red" %)120.24.4.116:5601)(%%) or MQTT((% style="color:red" %)120.24.4.116:1883)(%%)or TCP((% style="color:red" %)120.24.4.116:5600)(%%)protocol to send data to the test server
136 136  )))
137 137  
138 138  
139 -[[image:1657249419225-449.png]]
153 +[[image:1657328756309-230.png]]
140 140  
141 141  
142 142  
... ... @@ -151,18 +151,19 @@
151 151  )))
152 152  
153 153  
154 -[[image:1657249468462-536.png]]
168 +[[image:1657328884227-504.png]]
155 155  
156 156  
157 157  
158 -=== 2.2.3 Connect USB – TTL to NSE01 to configure it ===
172 +=== 2.2.3 Connect USB – TTL to NDDS75 to configure it ===
159 159  
160 160  (((
161 161  (((
162 -User need to configure NSE01 via serial port to set the (% style="color:blue" %)**Server Address** / **Uplink Topic** (%%)to define where and how-to uplink packets. NSE01 support AT Commands, user can use a USB to TTL adapter to connect to NSE01 and use AT Commands to configure it, as below.
176 +User need to configure NDDS75 via serial port to set the (% style="color:blue" %)**Server Address** / **Uplink Topic** (%%)to define where and how-to uplink packets. NDDS75 support AT Commands, user can use a USB to TTL adapter to connect to NDDS75 and use AT Commands to configure it, as below.
163 163  )))
164 164  )))
165 165  
180 +[[image:image-20220709092052-2.png]]
166 166  
167 167  **Connection:**
168 168  
... ... @@ -182,13 +182,13 @@
182 182  * Flow Control: (% style="color:green" %)**None**
183 183  
184 184  (((
185 -Make sure the switch is in FLASH position, then power on device by connecting the jumper on NSE01. NSE01 will output system info once power on as below, we can enter the (% style="color:green" %)**password: 12345678**(%%) to access AT Command input.
200 +Make sure the switch is in FLASH position, then power on device by connecting the jumper on NDDS75. NDDS75 will output system info once power on as below, we can enter the (% style="color:green" %)**password: 12345678**(%%) to access AT Command input.
186 186  )))
187 187  
188 -[[image:image-20220708110657-3.png]]
203 +[[image:1657329814315-101.png]]
189 189  
190 190  (((
191 -(% style="color:red" %)Note: the valid AT Commands can be found at: (%%)[[http:~~/~~/www.dragino.com/downloads/index.php?dir=NB-IoT/NSE01/>>url:http://www.dragino.com/downloads/index.php?dir=NB-IoT/NBSN50/]]
206 +(% style="color:red" %)Note: the valid AT Commands can be found at: (%%)[[https:~~/~~/www.dragino.com/downloads/index.php?dir=NB-IoT/NDDS75/>>url:https://www.dragino.com/downloads/index.php?dir=NB-IoT/NDDS75/]]
192 192  )))
193 193  
194 194  
... ... @@ -206,48 +206,44 @@
206 206  
207 207  For parameter description, please refer to AT command set
208 208  
209 -[[image:1657249793983-486.png]]
224 +[[image:1657330452568-615.png]]
210 210  
211 211  
212 -After configure the server address and (% style="color:green" %)**reset the device**(%%) (via AT+ATZ ), NSE01 will start to uplink sensor values to CoAP server.
227 +After configure the server address and (% style="color:green" %)**reset the device**(%%) (via AT+ATZ ), NDDS75 will start to uplink sensor values to CoAP server.
213 213  
214 -[[image:1657249831934-534.png]]
229 +[[image:1657330472797-498.png]]
215 215  
216 216  
217 217  
218 218  === 2.2.5 Use UDP protocol to uplink data(Default protocol) ===
219 219  
220 -This feature is supported since firmware version v1.0.1
221 221  
222 -
223 223  * (% style="color:blue" %)**AT+PRO=2   ** (%%) ~/~/ Set to use UDP protocol to uplink
224 224  * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5601   ** (%%) ~/~/ to set UDP server address and port
225 225  * (% style="color:blue" %)**AT+CFM=1       ** (%%) ~/~/If the server does not respond, this command is unnecessary
226 226  
227 -[[image:1657249864775-321.png]]
240 +[[image:1657330501006-241.png]]
228 228  
229 229  
230 -[[image:1657249930215-289.png]]
243 +[[image:1657330533775-472.png]]
231 231  
232 232  
233 233  
234 234  === 2.2.6 Use MQTT protocol to uplink data ===
235 235  
236 -This feature is supported since firmware version v110
237 237  
238 -
239 239  * (% style="color:blue" %)**AT+PRO=3   ** (%%) ~/~/Set to use MQTT protocol to uplink
240 240  * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,1883   ** (%%) ~/~/Set MQTT server address and port
241 241  * (% style="color:blue" %)**AT+CLIENT=CLIENT       ** (%%)~/~/Set up the CLIENT of MQTT
242 242  * (% style="color:blue" %)**AT+UNAME=UNAME                               **(%%)~/~/Set the username of MQTT
243 243  * (% style="color:blue" %)**AT+PWD=PWD                                        **(%%)~/~/Set the password of MQTT
244 -* (% style="color:blue" %)**AT+PUBTOPIC=NSE01_PUB                    **(%%)~/~/Set the sending topic of MQTT
245 -* (% style="color:blue" %)**AT+SUBTOPIC=NSE01_SUB          **(%%) ~/~/Set the subscription topic of MQTT
255 +* (% style="color:blue" %)**AT+PUBTOPIC=NDDS75_PUB                 **(%%)~/~/Set the sending topic of MQTT
256 +* (% style="color:blue" %)**AT+SUBTOPIC=NDDS75_SUB          **(%%) ~/~/Set the subscription topic of MQTT
246 246  
247 247  [[image:1657249978444-674.png]]
248 248  
249 249  
250 -[[image:1657249990869-686.png]]
261 +[[image:1657330723006-866.png]]
251 251  
252 252  
253 253  (((
... ... @@ -258,16 +258,14 @@
258 258  
259 259  === 2.2.7 Use TCP protocol to uplink data ===
260 260  
261 -This feature is supported since firmware version v110
262 262  
263 -
264 264  * (% style="color:blue" %)**AT+PRO=4   ** (%%) ~/~/ Set to use TCP protocol to uplink
265 265  * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5600   **(%%) ~/~/ to set TCP server address and port
266 266  
267 -[[image:1657250217799-140.png]]
276 +[[image:image-20220709093918-1.png]]
268 268  
269 269  
270 -[[image:1657250255956-604.png]]
279 +[[image:image-20220709093918-2.png]]
271 271  
272 272  
273 273  
... ... @@ -289,36 +289,52 @@
289 289  
290 290  == 2.3  Uplink Payload ==
291 291  
292 -In this mode, uplink payload includes in total 18 bytes
301 +In this mode, uplink payload includes in total 14 bytes
293 293  
303 +
294 294  (% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %)
295 295  |=(% style="width: 60px;" %)(((
296 296  **Size(bytes)**
297 -)))|=(% style="width: 50px;" %)**6**|=(% style="width: 25px;" %)2|=(% style="width: 25px;" %)**2**|=(% style="width: 70px;" %)**1**|=(% style="width: 60px;" %)**2**|=(% style="width: 80px;" %)**2**|=(% style="width: 90px;" %)**2**|=(% style="width: 50px;" %)**1**
298 -|(% style="width:97px" %)**Value**|(% style="width:83px" %)[[Device ID>>||anchor="H2.4.1A0A0DeviceID"]]|(% style="width:41px" %)[[Ver>>||anchor="H2.4.2A0VersionInfo"]]|(% style="width:46px" %)[[BAT>>||anchor="H2.4.3A0BatteryInfo"]]|(% style="width:123px" %)[[Signal Strength>>||anchor="H2.4.4A0SignalStrength"]]|(% style="width:108px" %)[[Soil Moisture>>||anchor="H2.4.5A0SoilMoisture"]]|(% style="width:133px" %)[[Soil Temperature>>||anchor="H2.4.6A0SoilTemperature"]]|(% style="width:159px" %)[[Soil Conductivity(EC)>>||anchor="H2.4.7A0SoilConductivity28EC29"]]|(% style="width:80px" %)[[Interrupt>>||anchor="H2.4.8A0DigitalInterrupt"]]
307 +)))|=(% style="width: 50px;" %)**6**|=(% style="width: 25px;" %)2|=(% style="width: 25px;" %)**2**|=(% style="width: 70px;" %)**1**|=(% style="width: 60px;" %)**2**|=(% style="width: 50px;" %)**1**
308 +|(% style="width:97px" %)**Value**|(% style="width:83px" %)[[Device ID>>||anchor="H2.4.1A0A0DeviceID"]]|(% style="width:41px" %)[[Ver>>||anchor="H2.4.2A0VersionInfo"]]|(% style="width:46px" %)[[BAT>>||anchor="H2.4.3A0BatteryInfo"]]|(% style="width:123px" %)[[Signal Strength>>||anchor="H2.4.4A0SignalStrength"]]|(% style="width:108px" %)[[Distance (unit: mm)>>||anchor="H2.4.5A0SoilMoisture"]]|(% style="width:80px" %)[[Interrupt>>||anchor="H2.4.8A0DigitalInterrupt"]]
299 299  
300 300  (((
301 -If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NSE01 uplink data.
311 +If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NDDS751 uplink data.
302 302  )))
303 303  
304 304  
305 -[[image:image-20220708111918-4.png]]
315 +[[image:1657331036973-987.png]]
306 306  
307 -
317 +(((
308 308  The payload is ASCII string, representative same HEX:
319 +)))
309 309  
310 -0x72403155615900640c7817075e0a8c02f900 where:
321 +(((
322 +0x72403155615900640c6c19029200 where:
323 +)))
311 311  
312 -* Device ID: 0x 724031556159 = 724031556159
313 -* Version: 0x0064=100=1.0.0
325 +* (((
326 +Device ID: 0x724031556159 = 724031556159
327 +)))
328 +* (((
329 +Version: 0x0064=100=1.0.0
330 +)))
314 314  
315 -* BAT: 0x0c78 = 3192 mV = 3.192V
316 -* Singal: 0x17 = 23
317 -* Soil Moisture: 0x075e= 1886 = 18.86  %
318 -* Soil Temperature:0x0a8c =2700=27 °C
319 -* Soil Conductivity(EC) = 0x02f9 =761 uS /cm
320 -* Interrupt: 0x00 = 0
332 +* (((
333 +BAT: 0x0c6c = 3180 mV = 3.180V
334 +)))
335 +* (((
336 +Signal: 0x19 = 25
337 +)))
338 +* (((
339 +Distance: 0x0292= 658 mm
340 +)))
341 +* (((
342 +Interrupt: 0x00 = 0
343 +)))
321 321  
345 +
346 +
322 322  == 2.4  Payload Explanation and Sensor Interface ==
323 323  
324 324  
... ... @@ -341,7 +341,7 @@
341 341  )))
342 342  
343 343  (((
344 -The Device ID is stored in a none-erase area, Upgrade the firmware or run AT+FDR won't erase Device ID.
369 +The Device ID is stored in a none-erase area, Upgrade the firmware or run **AT+FDR** won't erase Device ID.
345 345  )))
346 346  
347 347  
... ... @@ -353,7 +353,7 @@
353 353  )))
354 354  
355 355  (((
356 -For example: 0x00 64 : this device is NSE01 with firmware version 1.0.0.
381 +For example: 0x00 64 : this device is NDDS75 with firmware version 1.0.0.
357 357  )))
358 358  
359 359  
... ... @@ -408,63 +408,17 @@
408 408  
409 409  === 2.4.5  Soil Moisture ===
410 410  
411 -(((
412 -(((
413 -Get the moisture content of the soil. The value range of the register is 0-10000(Decimal), divide this value by 100 to get the percentage of moisture in the soil.
414 -)))
415 -)))
436 +Get the distance. Flat object range 280mm - 7500mm.
416 416  
417 -(((
418 -(((
419 -For example, if the data you get from the register is **__0x05 0xDC__**, the moisture content in the soil is
420 -)))
421 -)))
438 +For example, if the data you get from the register is **__0x0B 0x05__**, the distance between the sensor and the measured object is
422 422  
423 423  (((
424 -
425 -)))
426 -
427 427  (((
428 -(% style="color:#4f81bd" %)**05DC(H) = 1500(D) /100 = 15%.**
442 +(% style="color:#4f81bd" %)** 0B05(H) = 2821(D) = 2821mm.**
429 429  )))
430 -
431 -
432 -
433 -=== 2.4.6  Soil Temperature ===
434 -
435 -(((
436 -Get the temperature in the soil. The value range of the register is -4000 - +800(Decimal), divide this value by 100 to get the temperature in the soil. For example, if the data you get from the register is __**0x09 0xEC**__, the temperature content in the soil is
437 437  )))
438 438  
439 439  (((
440 -**Example**:
441 -)))
442 -
443 -(((
444 -If payload is 0105H: ((0x0105 & 0x8000)>>15 === 0),temp = 0105(H)/100 = 2.61 °C
445 -)))
446 -
447 -(((
448 -If payload is FF7EH: ((FF7E & 0x8000)>>15 ===1),temp = (FF7E(H)-FFFF(H))/100 = -1.29 °C
449 -)))
450 -
451 -
452 -
453 -=== 2.4.7  Soil Conductivity (EC) ===
454 -
455 -(((
456 -Obtain (% style="color:#4f81bd" %)**__soluble salt concentration__**(%%) in soil or (% style="color:#4f81bd" %)**__soluble ion concentration in liquid fertilizer__**(%%) or (% style="color:#4f81bd" %)**__planting medium__**(%%). The value range of the register is 0 - 20000(Decimal)( Can be greater than 20000).
457 -)))
458 -
459 -(((
460 -For example, if the data you get from the register is __**0x00 0xC8**__, the soil conductivity is 00C8(H) = 200(D) = 200 uS/cm.
461 -)))
462 -
463 -(((
464 -Generally, the EC value of irrigation water is less than 800uS / cm.
465 -)))
466 -
467 -(((
468 468  
469 469  )))
470 470  
... ... @@ -472,10 +472,10 @@
472 472  
473 473  )))
474 474  
475 -=== 2.4.8  Digital Interrupt ===
454 +=== 2.4.6  Digital Interrupt ===
476 476  
477 477  (((
478 -Digital Interrupt refers to pin (% style="color:blue" %)**GPIO_EXTI**(%%), and there are different trigger methods. When there is a trigger, the NSE01 will send a packet to the server.
457 +Digital Interrupt refers to pin (% style="color:blue" %)**GPIO_EXTI**(%%), and there are different trigger methods. When there is a trigger, the NDDS75 will send a packet to the server.
479 479  )))
480 480  
481 481  (((
... ... @@ -506,10 +506,10 @@
506 506  
507 507  
508 508  
509 -=== 2.4.9  ​+5V Output ===
488 +=== 2.4.7  ​+5V Output ===
510 510  
511 511  (((
512 -NSE01 will enable +5V output before all sampling and disable the +5v after all sampling. 
491 +NDDS75 will enable +5V output before all sampling and disable the +5v after all sampling. 
513 513  )))
514 514  
515 515  
1657327959271-447.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +78.3 KB
Content
1657328609906-564.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +492.6 KB
Content
1657328659945-416.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +78.8 KB
Content
1657328756309-230.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +78.5 KB
Content
1657328884227-504.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +483.6 KB
Content
1657329814315-101.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +85.3 KB
Content
1657330452568-615.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +71.3 KB
Content
1657330472797-498.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +68.9 KB
Content
1657330501006-241.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +119.2 KB
Content
1657330533775-472.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +74.9 KB
Content
1657330723006-866.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +74.1 KB
Content
1657331036973-987.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +83.8 KB
Content
image-20220709092052-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +247.3 KB
Content
image-20220709093918-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +42.2 KB
Content
image-20220709093918-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +61.9 KB
Content

Applications

Navigation

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