Skip to Content
Last modified by Mengting Qiu on 2024/04/02 16:44
From version 115.2
edited by Xiaoling
on 2022/07/09 16:18
Change comment: There is no comment for this version
To version 90.1
edited by Xiaoling
on 2022/07/09 09:43
Change comment: Uploaded new attachment "1657331036973-987.png", version {1}

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -N95S31B NB-IoT Temperature & Humidity Sensor User Manual
1 +NDDS75 NB-IoT Distance Detect Sensor User Manual
Content
... ... @@ -1,12 +1,10 @@
1 1  (% style="text-align:center" %)
2 -[[image:1657348034241-728.png||height="470" width="470"]]
2 +[[image:image-20220709085040-1.png||height="542" width="524"]]
3 3  
4 4  
5 5  
6 6  
7 7  
8 -
9 -
10 10  **Table of Contents:**
11 11  
12 12  
... ... @@ -14,42 +14,46 @@
14 14  
15 15  
16 16  
15 +
17 17  = 1.  Introduction =
18 18  
19 -== 1.1 ​ What is N95S31B NB-IoT Sensor Node ==
18 +== 1.1 ​ What is NDDS75 Distance Detection Sensor ==
20 20  
21 21  (((
22 22  
23 23  
24 -The Dragino N95S31B is a (% style="color:blue" %)**NB-IoT Temperature and Humidity Sensor**(%%) for Internet of Things solution. It is used to measure the (% style="color:blue" %)**surrounding environment temperature and relative air humidity precisely**(%%), and then upload to IoT server via NB-IoT network*.
23 +(((
24 +The Dragino NDDS75 is a (% style="color:blue" %)**NB-IoT Distance Detection Sensor**(%%) for Internet of Things solution. It is designed to measure the distance between the sensor and a flat object. The distance detection sensor is a module that uses ultrasonic sensing technology for distance measurement, and temperature compensation is performed internally to improve the reliability of data.
25 +\\The NDDS75 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. It detects the distance between the measured object and the sensor, and uploads the value via wireless to IoT Server via NB-IoT Network.
26 +\\NarrowBand-Internet of Things (NB-IoT) is a standards-based low power wide area (LPWA) technology developed to enable a wide range of new IoT devices and services. NB-IoT significantly improves the power consumption of user devices, system capacity and spectrum efficiency, especially in deep coverage.
27 +\\NDDS75 supports different uplink methods include (% style="color:blue" %)**TCP, MQTT, UDP and CoAP** (%%)for different application requirement.
28 +\\NDDS75 is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), It is designed for long term use up to 5 years. (Actually Battery life depends on the use environment, update period & uplink method)
29 +\\To use NDDS75, user needs to check if there is NB-IoT coverage in local area and with the bands NDDS75 supports. If the local operate support it, user needs to get a NB-IoT SIM card from local operator and install NDDS75 to get NB-IoT network connection.
30 +)))
25 25  
26 -The temperature & humidity sensor used in N95S31B is SHT31, which is fully calibrated, linearized, and temperature compensated digital output from Sensirion, it provides a strong reliability and long-term stability. The SHT31 is fixed in a (% style="color:blue" %)**waterproof anti-condensation casing **(%%)for long term use.
27 -
28 -N95S31B supports different uplink methods include (% style="color:blue" %)**TCP, MQTT, UDP and CoAP**(%%) for different application requirement.
29 -
30 -N95S31B is powered by(% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), It is designed for long term use up to several years. (Real-world battery life depends on the use environment, update period. Please check related Power Analyze report).
31 -
32 -
33 -~* make sure you have NB-IoT coverage locally.
34 -
35 35  
36 36  )))
37 37  
38 -[[image:1657348284168-431.png]]
35 +[[image:1654503236291-817.png]]
39 39  
40 40  
38 +[[image:1657327959271-447.png]]
41 41  
40 +
41 +
42 42  == 1.2 ​ Features ==
43 43  
44 44  
45 45  * NB-IoT Bands: B1/B3/B8/B5/B20/B28 @H-FDD
46 -* Monitor Temperature & Humidity via SHT31
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
47 47  * AT Commands to change parameters
48 48  * Uplink on periodically
49 49  * Downlink to change configure
50 50  * IP66 Waterproof Enclosure
51 -* Ultra-Low Power consumption
52 -* AT Commands to change parameters
53 53  * Micro SIM card slot for NB-IoT SIM
54 54  * 8500mAh Battery for long term use
55 55  
... ... @@ -73,7 +73,6 @@
73 73  
74 74  (% style="color:#037691" %)**Battery:**
75 75  
76 -
77 77  * Li/SOCI2 un-chargeable battery
78 78  * Capacity: 8500mAh
79 79  * Self Discharge: <1% / Year @ 25°C
... ... @@ -80,7 +80,13 @@
80 80  * Max continuously current: 130mA
81 81  * Max boost current: 2A, 1 second
82 82  
84 +(% style="color:#037691" %)**Power Consumption**
83 83  
86 +* STOP Mode: 10uA @ 3.3v
87 +* Max transmit power: 350mA@3.3v
88 +
89 +
90 +
84 84  == ​1.4  Applications ==
85 85  
86 86  * Smart Buildings & Home Automation
... ... @@ -94,54 +94,25 @@
94 94  ​
95 95  
96 96  
104 +
97 97  == 1.5  Pin Definitions ==
98 98  
99 -N95S31B use the mother board from NBSN95 which as below.
100 100  
101 -[[image:image-20220709144723-1.png]]
108 +[[image:1657328609906-564.png]]
102 102  
103 103  
104 -=== 1.5.1 Jumper JP2 ===
105 105  
106 -Power on Device when put this jumper.
112 += 2.  Use NDDS75 to communicate with IoT Server =
107 107  
108 -
109 -
110 -=== 1.5.2 BOOT MODE / SW1 ===
111 -
112 -1) 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.
113 -
114 -2) Flash: work mode, device starts to work and send out console output for further debug
115 -
116 -
117 -
118 -=== 1.5.3 Reset Button ===
119 -
120 -Press to reboot the device.
121 -
122 -
123 -
124 -=== 1.5.4 LED ===
125 -
126 -It will flash:
127 -
128 -1. When boot the device in flash mode
129 -1. Send an uplink packet
130 -
131 -
132 -
133 -= 2.  Use N95S31B to communicate with IoT Server =
134 -
135 135  == 2.1  How it works ==
136 136  
137 -
138 138  (((
139 -The N95S31B is equipped with a NB-IoT module, the pre-loaded firmware in N95S31B 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 N95S31B.
117 +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.
140 140  )))
141 141  
142 142  
143 143  (((
144 -The diagram below shows the working flow in default firmware of N95S31B:
122 +The diagram below shows the working flow in default firmware of NDDS75:
145 145  )))
146 146  
147 147  (((
... ... @@ -148,7 +148,7 @@
148 148  
149 149  )))
150 150  
151 -[[image:1657350248151-650.png]]
129 +[[image:1657328659945-416.png]]
152 152  
153 153  (((
154 154  
... ... @@ -155,45 +155,30 @@
155 155  )))
156 156  
157 157  
158 -== 2.2 ​ Configure the N95S31B ==
136 +== 2.2 ​ Configure the NDDS75 ==
159 159  
160 160  
161 -=== 2.2.1  Power On N95S31B ===
162 -
163 -
164 -[[image:image-20220709150546-2.png]]
165 -
166 -
167 167  === 2.2.1 Test Requirement ===
168 168  
141 +(((
142 +To use NDDS75 in your city, make sure meet below requirements:
143 +)))
169 169  
170 -To use N95S31B in your city, make sure meet below requirements:
171 -
172 172  * Your local operator has already distributed a NB-IoT Network there.
173 -* The local NB-IoT network used the band that N95S31B supports.
146 +* The local NB-IoT network used the band that NSE01 supports.
174 174  * Your operator is able to distribute the data received in their NB-IoT network to your IoT server.
175 175  
176 -Below figure shows our testing structure. Here we have NB-IoT network coverage by China Mobile, the band they use is B8.
177 -
178 -N95S31B supports different communication protocol such as :
179 -
180 180  (((
181 -* CoAP  ((% style="color:red" %)120.24.4.116:5683(%%))
182 -* raw UDP  ((% style="color:red" %)120.24.4.116:5601(%%))
183 -* MQTT  ((% style="color:red" %)120.24.4.116:1883(%%))
184 -* TCP  ((% style="color:red" %)120.24.4.116:5600(%%))
185 -
186 -We will show how to use with each protocol. The IP addresses above are our test server. User need to change to point their corresponding server.
187 -
188 -
150 +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
189 189  )))
190 190  
191 -[[image:1657350625843-586.png]]
192 192  
154 +[[image:1657328756309-230.png]]
193 193  
194 194  
195 -=== 2.2.3  Insert SIM card ===
196 196  
158 +=== 2.2.2 Insert SIM card ===
159 +
197 197  (((
198 198  Insert the NB-IoT Card get from your provider.
199 199  )))
... ... @@ -203,19 +203,19 @@
203 203  )))
204 204  
205 205  
206 -[[image:1657351240556-536.png]]
169 +[[image:1657328884227-504.png]]
207 207  
208 208  
209 209  
210 -=== 2.2.4  Connect USB – TTL to N95S31B to configure it ===
173 +=== 2.2.3 Connect USB – TTL to NDDS75 to configure it ===
211 211  
212 212  (((
213 213  (((
214 -User need to configure N95S31B via serial port to set the (% style="color:blue" %)**Server Address** / **Uplink Topic** (%%)to define where and how-to uplink packets. N95S31B support AT Commands, user can use a USB to TTL adapter to connect to N95S31B and use AT Commands to configure it, as below.
177 +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.
215 215  )))
216 216  )))
217 217  
218 -[[image:1657351312545-300.png]]
181 +[[image:image-20220709092052-2.png]]
219 219  
220 220  **Connection:**
221 221  
... ... @@ -235,310 +235,355 @@
235 235  * Flow Control: (% style="color:green" %)**None**
236 236  
237 237  (((
238 -Make sure the switch is in FLASH position, then power on device by connecting the jumper on N95S31B. N95S31B will output system info once power on as below, we can enter the (% style="color:green" %)**password: 12345678**(%%) to access AT Command input.
201 +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.
239 239  )))
240 240  
241 241  [[image:1657329814315-101.png]]
242 242  
243 243  (((
244 -(% style="color:red" %)Note: the valid AT Commands can be found at:  (%%)[[https:~~/~~/www.dragino.com/downloads/index.php?dir=NB-IoT/N95S31B/>>url:https://www.dragino.com/downloads/index.php?dir=NB-IoT/N95S31B/]]
207 +(% 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/]]
245 245  )))
246 246  
247 247  
248 248  
249 -=== 2.2.5  Use CoAP protocol to uplink data ===
212 +=== 2.2.4 Use CoAP protocol to uplink data ===
250 250  
251 251  (% style="color:red" %)Note: if you don't have CoAP server, you can refer this link to set up one: (%%)[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Set%20up%20CoAP%20Server/>>http://wiki.dragino.com/xwiki/bin/view/Main/Set%20up%20CoAP%20Server/]]
252 252  
253 253  
254 -(((
255 255  **Use below commands:**
256 -)))
257 257  
258 -* (((
259 -(% style="color:blue" %)**AT+PRO=1**  (%%) ~/~/ Set to use CoAP protocol to uplink
260 -)))
261 -* (((
262 -(% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5683   ** (%%)~/~/ to set CoAP server address and port
263 -)))
264 -* (((
265 -(% style="color:blue" %)**AT+URI=5,11,"mqtt",11,"coap",12,"0",15,"c=text1",23,"0" ** (%%) ~/~/Set COAP resource path
266 -)))
219 +* (% style="color:blue" %)**AT+PRO=1**  (%%) ~/~/ Set to use CoAP protocol to uplink
220 +* (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5683   ** (%%)~/~/ to set CoAP server address and port
221 +* (% style="color:blue" %)**AT+URI=5,11,"mqtt",11,"coap",12,"0",15,"c=text1",23,"0" ** (%%) ~/~/Set COAP resource path
267 267  
268 -(((
269 -
270 -
271 271  For parameter description, please refer to AT command set
272 -)))
273 273  
274 -[[image:1657352146020-183.png]]
225 +[[image:1657330452568-615.png]]
275 275  
276 276  
277 -(((
278 278  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.
279 -)))
280 280  
281 -[[image:1657352185396-303.png]]
230 +[[image:1657330472797-498.png]]
282 282  
283 283  
284 284  
285 -=== 2.2.6  Use UDP protocol to uplink data(Default protocol) ===
234 +=== 2.2.5 Use UDP protocol to uplink data(Default protocol) ===
286 286  
287 287  
288 -* (% style="color:blue" %)**AT+PRO=2   ** (%%) ~/~/ Set to use UDP protocol to uplink
237 +* (% style="color:blue" %)**AT+PRO=2   ** (%%) ~/~/ Set to use UDP protocol to uplink
289 289  * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5601   ** (%%) ~/~/ to set UDP server address and port
290 -* (% style="color:blue" %)**AT+CFM=1       ** (%%) ~/~/ If the server does not respond, this command is unnecessary
239 +* (% style="color:blue" %)**AT+CFM=1       ** (%%) ~/~/If the server does not respond, this command is unnecessary
291 291  
292 -[[image:1657352391268-297.png]]
293 293  
242 +[[image:1657330501006-241.png]]
294 294  
295 -[[image:1657352403317-397.png]]
296 296  
245 +[[image:1657330533775-472.png]]
297 297  
298 298  
299 -=== 2.2.7  Use MQTT protocol to uplink data ===
300 300  
301 -N95S31B supports only plain MQTT now it doesn't support TLS and other related encryption.
249 +=== 2.2.6 Use MQTT protocol to uplink data ===
302 302  
303 -* (% style="color:blue" %)**AT+PRO=3   ** (%%) ~/~/Set to use MQTT protocol to uplink
304 -* (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,1883   ** (%%) ~/~/Set MQTT server address and port
305 -* (% style="color:blue" %)**AT+CLIENT=CLIENT       ** (%%)~/~/Set up the CLIENT of MQTT
306 -* (% style="color:blue" %)**AT+UNAME=UNAME                                **(%%)~/~/Set the username of MQTT
307 -* (% style="color:blue" %)**AT+PWD=PWD                                         **(%%)~/~/Set the password of MQTT
308 -* (% style="color:blue" %)**AT+PUBTOPIC=f9527                               **(%%)~/~/Set the sending topic of MQTT
309 -* (% style="color:blue" %)**AT+SUBTOPIC=Ns9527          **(%%) ~/~/Set the subscription topic of MQTT
310 310  
311 -[[image:1657352634421-276.png]]
252 +* (% style="color:blue" %)**AT+PRO=3   ** (%%) ~/~/Set to use MQTT protocol to uplink
253 +* (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,1883   ** (%%) ~/~/Set MQTT server address and port
254 +* (% style="color:blue" %)**AT+CLIENT=CLIENT       ** (%%)~/~/Set up the CLIENT of MQTT
255 +* (% style="color:blue" %)**AT+UNAME=UNAME                               **(%%)~/~/Set the username of MQTT
256 +* (% style="color:blue" %)**AT+PWD=PWD                                        **(%%)~/~/Set the password of MQTT
257 +* (% style="color:blue" %)**AT+PUBTOPIC=NDDS75_PUB                 **(%%)~/~/Set the sending topic of MQTT
258 +* (% style="color:blue" %)**AT+SUBTOPIC=NDDS75_SUB          **(%%) ~/~/Set the subscription topic of MQTT
312 312  
260 +[[image:1657249978444-674.png]]
313 313  
314 -[[image:1657352645687-385.png]]
315 315  
316 -(((
317 -To save battery life, N95S31B will establish a subscription before each uplink and close the subscription 3 seconds after uplink successful. Any downlink commands from server will only arrive during the subscription period.
318 -)))
263 +[[image:1657330723006-866.png]]
319 319  
320 320  
321 321  (((
322 -MQTT protocol has a much high-power consumption compare vs UDP / CoAP protocol. Please check the power analyze document and adjust the uplink period to a suitable interval.
267 +MQTT protocol has a much higher power consumption compare vs UDP / CoAP protocol. Please check the power analyze document and adjust the uplink period to a suitable interval.
323 323  )))
324 324  
325 325  
326 326  
327 -=== 2.2.8  Use TCP protocol to uplink data ===
272 +=== 2.2.7 Use TCP protocol to uplink data ===
328 328  
329 -This feature is supported since firmware version v110
330 330  
331 331  * (% style="color:blue" %)**AT+PRO=4   ** (%%) ~/~/ Set to use TCP protocol to uplink
332 332  * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5600   **(%%) ~/~/ to set TCP server address and port
333 333  
334 -[[image:1657352898400-901.png]]
335 335  
279 +[[image:image-20220709093918-1.png]]
336 336  
337 -[[image:1657352914475-252.png]]
338 338  
282 +[[image:image-20220709093918-2.png]]
339 339  
340 340  
341 -=== 2.2.9  Change Update Interval ===
342 342  
286 +
287 +
288 +
289 +=== 2.2.8 Change Update Interval ===
290 +
343 343  User can use below command to change the (% style="color:green" %)**uplink interval**.
344 344  
345 345  * (% style="color:blue" %)**AT+TDC=600      ** (%%)~/~/ Set Update Interval to 600s
346 346  
347 347  (((
348 -
296 +(% style="color:red" %)**NOTE:**
349 349  )))
350 350  
299 +(((
300 +(% style="color:red" %)1. By default, the device will send an uplink message every 1 hour.
301 +)))
351 351  
352 352  
304 +
353 353  == 2.3  Uplink Payload ==
354 354  
307 +In this mode, uplink payload includes in total 18 bytes
355 355  
356 -NBSN95 has different working mode for the connections of different type of sensors. This section describes these modes. User can use the AT Command (% style="color:blue" %)**AT+MOD**(%%) to set NBSN95 to different working modes.
309 +(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %)
310 +|=(% style="width: 60px;" %)(((
311 +**Size(bytes)**
312 +)))|=(% 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**
313 +|(% 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"]]
357 357  
315 +(((
316 +If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NSE01 uplink data.
317 +)))
358 358  
359 -For example:
360 360  
361 - (% style="color:blue" %)**AT+CFGMOD=2 ** (%%)~/~/will set the NBSN95 to work in MOD=2 distance mode which target to measure distance via Ultrasonic Sensor.
320 +[[image:image-20220708111918-4.png]]
362 362  
363 363  
364 -The uplink payloads are composed in  ASCII String. For example:
323 +The payload is ASCII string, representative same HEX:
365 365  
366 -0a cd 00 ed 0a cc 00 00 ef 02 d2 1d (total 24 ASCII Chars) . Representative the actually payload:
325 +0x72403155615900640c7817075e0a8c02f900 where:
367 367  
368 -0x 0a cd 00 ed 0a cc 00 00 ef 02 d2 1d Total 12 bytes
327 +* Device ID: 0x 724031556159 = 724031556159
328 +* Version: 0x0064=100=1.0.0
369 369  
330 +* BAT: 0x0c78 = 3192 mV = 3.192V
331 +* Singal: 0x17 = 23
332 +* Soil Moisture: 0x075e= 1886 = 18.86  %
333 +* Soil Temperature:0x0a8c =2700=27 °C
334 +* Soil Conductivity(EC) = 0x02f9 =761 uS /cm
335 +* Interrupt: 0x00 = 0
370 370  
371 -(% style="color:red" %)**NOTE:**
337 +== 2.4  Payload Explanation and Sensor Interface ==
372 372  
373 -(% style="color:red" %)
374 -1. All modes share the same Payload Explanation from [[HERE>>path:#Payload_Explain]].
375 -1. By default, the device will send an uplink message every 1 hour.
376 376  
340 +=== 2.4.1  Device ID ===
377 377  
342 +(((
343 +By default, the Device ID equal to the last 6 bytes of IMEI.
344 +)))
378 378  
346 +(((
347 +User can use (% style="color:blue" %)**AT+DEUI**(%%) to set Device ID
348 +)))
379 379  
380 -=== 2.3.1  Payload Analyze ===
350 +(((
351 +**Example:**
352 +)))
381 381  
382 -N95S31B uplink payload includes in total 21 bytes
354 +(((
355 +AT+DEUI=A84041F15612
356 +)))
383 383  
358 +(((
359 +The Device ID is stored in a none-erase area, Upgrade the firmware or run AT+FDR won't erase Device ID.
360 +)))
384 384  
385 -(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:440px" %)
386 -|=(% style="width: 60px;" %)(((
387 -**Size(bytes)**
388 -)))|=(% style="width: 60px;" %)**6**|=(% style="width: 35px;" %)2|=(% style="width: 35px;" %)**2**|=(% style="width: 80px;" %)**1**|=(% style="width: 80px;" %) |=(% style="width: 99px;" %) |=(% style="width: 77px;" %)**2**|=(% style="width: 60px;" %)**1**
389 -|(% 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:123px" %)MOD 0X01|(% style="width:99px" %)(((
390 -Reserve/ Same as NBSN95 CFGMOD=1
391 391  
392 -No function here.
393 -)))|(% style="width:77px" %)(((
394 -[[Temperature >>||anchor="H2.4.5A0Distance"]]
395 395  
396 -By SHT31
397 -)))|(% style="width:80px" %)(((
398 -[[Humidity>>||anchor="H2.4.6A0DigitalInterrupt"]]
364 +=== 2.4.2  Version Info ===
399 399  
400 -By SHT31
366 +(((
367 +Specify the software version: 0x64=100, means firmware version 1.00.
401 401  )))
402 402  
403 403  (((
404 -(((
405 -If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NB sensor uplink data.
371 +For example: 0x00 64 : this device is NSE01 with firmware version 1.0.0.
406 406  )))
407 -)))
408 408  
409 409  
410 -[[image:1657354294009-643.png]]
411 411  
376 +=== 2.4.3  Battery Info ===
412 412  
413 -The payload is ASCII string, representative same HEX: 0x724031607457006e0ccd1b0100dc000ccc00e10186 where:
378 +(((
379 +Check the battery voltage for LSE01.
380 +)))
414 414  
415 -* Device ID: 0x724031607457 = 724031607457
416 -* Version: 0x006e=110=1.1.0
417 -
418 -* BAT: 0x0ccd = 3277 mV = 3.277V
419 -* Signal: 0x1b = 27
420 -* Model: 0x01 = 1
421 -* 0x00dc000ccc= reserve, ignore in N95S31B
422 -* Temperature by SHT31: 0x00e1 = 225 = 22.5 °C
423 -* Humidity by SHT31: 0x0186 = 390 = 39.0 %rh
424 -
425 425  (((
426 -
383 +Ex1: 0x0B45 = 2885mV
427 427  )))
428 428  
429 429  (((
430 -
387 +Ex2: 0x0B49 = 2889mV
431 431  )))
432 432  
433 433  
434 -=== 2.3.2  Device ID ===
435 435  
392 +=== 2.4.4  Signal Strength ===
393 +
436 436  (((
437 -By default, the Device ID equal to the last 6 bytes of IMEI.
395 +NB-IoT Network signal Strength.
438 438  )))
439 439  
440 440  (((
441 -User can use (% style="color:blue" %)**AT+DEUI**(%%) to set Device ID
399 +**Ex1: 0x1d = 29**
442 442  )))
443 443  
444 444  (((
445 -**Example:**
403 +(% style="color:blue" %)**0**(%%)  -113dBm or less
446 446  )))
447 447  
448 448  (((
449 -AT+DEUI=A84041F15612
407 +(% style="color:blue" %)**1**(%%)  -111dBm
450 450  )))
451 451  
452 452  (((
453 -The Device ID is stored in a none-erase area, Upgrade the firmware or run **AT+FDR** won't erase Device ID.
411 +(% style="color:blue" %)**2...30**(%%) -109dBm... -53dBm
454 454  )))
455 455  
414 +(((
415 +(% style="color:blue" %)**31**  (%%) -51dBm or greater
416 +)))
456 456  
418 +(((
419 +(% style="color:blue" %)**99**   (%%) Not known or not detectable
420 +)))
457 457  
458 -=== 2.3.3  Version Info ===
459 459  
460 460  
461 -These bytes include the hardware and software version.
424 +=== 2.4.5  Soil Moisture ===
462 462  
463 -Higher byte: Specify hardware version: always 0x00 for N95S31B
426 +(((
427 +(((
428 +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.
429 +)))
430 +)))
464 464  
465 -Lower byte: Specify the software version: 0x6E=110, means firmware version 110
432 +(((
433 +(((
434 +For example, if the data you get from the register is **__0x05 0xDC__**, the moisture content in the soil is
435 +)))
436 +)))
466 466  
467 -
468 -For example: 0x00 6E: this device is N95S31B with firmware version 110.
469 -
470 470  (((
471 471  
472 472  )))
473 473  
442 +(((
443 +(% style="color:#4f81bd" %)**05DC(H) = 1500(D) /100 = 15%.**
444 +)))
474 474  
475 -=== 2.3.4  Battery Info ===
476 476  
447 +
448 +=== 2.4.6  Soil Temperature ===
449 +
477 477  (((
478 -Ex1: 0x0B45 = 2885mV
451 +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
479 479  )))
480 480  
481 481  (((
482 -Ex2: 0x0B49 = 2889mV
455 +**Example**:
483 483  )))
484 484  
458 +(((
459 +If payload is 0105H: ((0x0105 & 0x8000)>>15 === 0),temp = 0105(H)/100 = 2.61 °C
460 +)))
485 485  
462 +(((
463 +If payload is FF7EH: ((FF7E & 0x8000)>>15 ===1),temp = (FF7E(H)-FFFF(H))/100 = -1.29 °C
464 +)))
486 486  
487 -=== 2.3.5  Signal Strength ===
488 488  
467 +
468 +=== 2.4.7  Soil Conductivity (EC) ===
469 +
489 489  (((
490 -NB-IoT Network signal Strength.
471 +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).
491 491  )))
492 492  
493 493  (((
494 -**Ex1: 0x1d = 29**
475 +For example, if the data you get from the register is __**0x00 0xC8**__, the soil conductivity is 00C8(H) = 200(D) = 200 uS/cm.
495 495  )))
496 496  
497 497  (((
498 -(% style="color:blue" %)**0**(%%)  -113dBm or less
479 +Generally, the EC value of irrigation water is less than 800uS / cm.
499 499  )))
500 500  
501 501  (((
502 -(% style="color:blue" %)**1**(%%)  -111dBm
483 +
503 503  )))
504 504  
505 505  (((
506 -(% style="color:blue" %)**2...30**(%%) -109dBm... -53dBm
487 +
507 507  )))
508 508  
490 +=== 2.4.8  Digital Interrupt ===
491 +
509 509  (((
510 -(% style="color:blue" %)**31**  (%%) -51dBm or greater
493 +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.
511 511  )))
512 512  
513 513  (((
514 -(% style="color:blue" %)**99**   (%%) Not known or not detectable
497 +The command is:
515 515  )))
516 516  
500 +(((
501 +(% style="color:blue" %)**AT+INTMOD=3 **(%%) ~/~/(more info about INMOD please refer [[**AT Command Manual**>>url:https://www.dragino.com/downloads/downloads/NB-IoT/NBSN95/DRAGINO_NBSN95-NB_AT%20Commands_v1.1.0.pdf]])**.**
502 +)))
517 517  
518 518  
519 -=== 2.3.6  Temperature & Humidity ===
505 +(((
506 +The lower four bits of this data field shows if this packet is generated by interrupt or not. Click here for the hardware and software set up.
507 +)))
520 520  
521 -The device will be able to get the SHT31 temperature and humidity data now and upload to IoT Server.
522 522  
523 -[[image:image-20220709161741-3.png]]
510 +(((
511 +Example:
512 +)))
524 524  
514 +(((
515 +0x(00): Normal uplink packet.
516 +)))
525 525  
526 -Convert the read byte to decimal and divide it by ten.
518 +(((
519 +0x(01): Interrupt Uplink Packet.
520 +)))
527 527  
528 528  
529 -**Example:**
530 530  
531 -Temperature:  Read:00ec (H) = 236(D)  Value:  236 /10=23.6℃
524 +=== 2.4.9  ​+5V Output ===
532 532  
533 -Humidity:    Read:0295(H)=661(D)    Value:  661 / 10=66.1, So 66.1%
526 +(((
527 +NSE01 will enable +5V output before all sampling and disable the +5v after all sampling. 
528 +)))
534 534  
535 535  
531 +(((
532 +The 5V output time can be controlled by AT Command.
533 +)))
536 536  
535 +(((
536 +(% style="color:blue" %)**AT+5VT=1000**
537 +)))
538 +
539 +(((
540 +Means set 5V valid time to have 1000ms. So the real 5V output will actually have 1000ms + sampling time for other sensors.
541 +)))
542 +
543 +
544 +
537 537  == 2.5  Downlink Payload ==
538 538  
539 -By default, NDDS75 prints the downlink payload to console port.
547 +By default, NSE01 prints the downlink payload to console port.
540 540  
541 -[[image:image-20220709100028-1.png]]
549 +[[image:image-20220708133731-5.png]]
542 542  
543 543  
544 544  (((
... ... @@ -574,7 +574,7 @@
574 574  )))
575 575  
576 576  (((
577 -If payload = 0x04FF, it will reset the NDDS75
585 +If payload = 0x04FF, it will reset the NSE01
578 578  )))
579 579  
580 580  
... ... @@ -588,52 +588,76 @@
588 588  
589 589  == 2.6  ​LED Indicator ==
590 590  
599 +(((
600 +The NSE01 has an internal LED which is to show the status of different state.
591 591  
592 -The NDDS75 has an internal LED which is to show the status of different state.
593 593  
594 -
595 -* When power on, NDDS75 will detect if sensor probe is connected, if probe detected, LED will blink four times. (no blinks in this step is no probe)
603 +* When power on, NSE01 will detect if sensor probe is connected, if probe detected, LED will blink four times. (no blinks in this step is no probe)
596 596  * Then the LED will be on for 1 second means device is boot normally.
597 -* After NDDS75 join NB-IoT network. The LED will be ON for 3 seconds.
605 +* After NSE01 join NB-IoT network. The LED will be ON for 3 seconds.
598 598  * For each uplink probe, LED will be on for 500ms.
607 +)))
599 599  
609 +
610 +
611 +
612 +== 2.7  Installation in Soil ==
613 +
614 +__**Measurement the soil surface**__
615 +
600 600  (((
601 -
617 +Choose the proper measuring position. Avoid the probe to touch rocks or hard things. Split the surface soil according to the measured deep. Keep the measured as original density. Vertical insert the probe into the soil to be measured. Make sure not shake when inserting. [[https:~~/~~/img.alicdn.com/imgextra/i3/2005165265/O1CN010rj9Oh1olPsQxrdUK_!!2005165265.jpg>>url:https://img.alicdn.com/imgextra/i3/2005165265/O1CN010rj9Oh1olPsQxrdUK_!!2005165265.jpg]]
602 602  )))
603 603  
620 +[[image:1657259653666-883.png]] ​
604 604  
605 605  
606 -== 2.7  ​Firmware Change Log ==
623 +(((
624 +
607 607  
608 -
609 609  (((
610 -Download URL & Firmware Change log
627 +Dig a hole with diameter > 20CM.
611 611  )))
612 612  
613 613  (((
614 -[[https:~~/~~/www.dragino.com/downloads/index.php?dir=NB-IoT/NDDS75/Firmware/>>url:https://www.dragino.com/downloads/index.php?dir=NB-IoT/NDDS75/Firmware/]]
631 +Horizontal insert the probe to the soil and fill the hole for long term measurement.
615 615  )))
633 +)))
616 616  
635 +[[image:1654506665940-119.png]]
617 617  
618 618  (((
619 -Upgrade Instruction: [[Upgrade_Firmware>>||anchor="H5.1200BHowtoUpgradeFirmware"]]
638 +
620 620  )))
621 621  
622 622  
642 +== 2.8  ​Firmware Change Log ==
623 623  
624 -== 2.8  ​Battery Analysis ==
625 625  
626 -=== 2.8.1  ​Battery Type ===
645 +Download URL & Firmware Change log
627 627  
647 +[[www.dragino.com/downloads/index.php?dir=NB-IoT/NSE01/Firmware/>>url:http://www.dragino.com/downloads/index.php?dir=NB-IoT/NBSN50/Firmware/]]
628 628  
649 +
650 +Upgrade Instruction: [[Upgrade_Firmware>>||anchor="H5.1200BHowtoUpgradeFirmware"]]
651 +
652 +
653 +
654 +== 2.9  ​Battery Analysis ==
655 +
656 +=== 2.9.1  ​Battery Type ===
657 +
658 +
629 629  (((
630 -The NDDS75 battery is a combination of an 8500mAh Li/SOCI2 Battery and a Super Capacitor. The battery is none-rechargeable battery type with a low discharge rate (<2% per year). This type of battery is commonly used in IoT devices such as water meter.
660 +The NSE01 battery is a combination of an 8500mAh Li/SOCI2 Battery and a Super Capacitor. The battery is none-rechargeable battery type with a low discharge rate (<2% per year). This type of battery is commonly used in IoT devices such as water meter.
631 631  )))
632 632  
663 +
633 633  (((
634 634  The battery is designed to last for several years depends on the actually use environment and update interval. 
635 635  )))
636 636  
668 +
637 637  (((
638 638  The battery related documents as below:
639 639  )))
... ... @@ -643,12 +643,12 @@
643 643  * [[Lithium-ion Battery-Capacitor datasheet>>http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
644 644  
645 645  (((
646 -[[image:image-20220709101450-2.png]]
678 +[[image:image-20220708140453-6.png]]
647 647  )))
648 648  
649 649  
650 650  
651 -=== 2.8.2  Power consumption Analyze ===
683 +=== 2.9.2  Power consumption Analyze ===
652 652  
653 653  (((
654 654  Dragino battery powered product are all runs in Low Power mode. We have an update battery calculator which base on the measurement of the real device. User can use this calculator to check the battery life and calculate the battery life if want to use different transmit interval.
... ... @@ -682,11 +682,11 @@
682 682  And the Life expectation in difference case will be shown on the right.
683 683  )))
684 684  
685 -[[image:image-20220709110451-3.png]]
717 +[[image:image-20220708141352-7.jpeg]]
686 686  
687 687  
688 688  
689 -=== 2.8.3  ​Battery Note ===
721 +=== 2.9.3  ​Battery Note ===
690 690  
691 691  (((
692 692  The Li-SICO battery is designed for small current / long period application. It is not good to use a high current, short period transmit method. The recommended minimum period for use of this battery is 5 minutes. If you use a shorter period time to transmit LoRa, then the battery life may be decreased.
... ... @@ -694,10 +694,10 @@
694 694  
695 695  
696 696  
697 -=== 2.8.4  Replace the battery ===
729 +=== 2.9.4  Replace the battery ===
698 698  
699 699  (((
700 -The default battery pack of NDDS75 includes a ER26500 plus super capacitor. If user can't find this pack locally, they can find ER26500 or equivalence without the SPC1520 capacitor, which will also work in most case. The SPC can enlarge the battery life for high frequency use (update period below 5 minutes).
732 +The default battery pack of NSE01 includes a ER26500 plus super capacitor. If user can't find this pack locally, they can find ER26500 or equivalence without the SPC1520 capacitor, which will also work in most case. The SPC can enlarge the battery life for high frequency use (update period below 5 minutes).
701 701  )))
702 702  
703 703  
... ... @@ -712,7 +712,7 @@
712 712  The AT Command set can refer the BC35-G NB-IoT Module AT Command: [[https:~~/~~/www.dragino.com/downloads/index.php?dir=datasheet/other_vendors/BC35-G/>>url:https://www.dragino.com/downloads/index.php?dir=datasheet/other_vendors/BC35-G/]] 
713 713  )))
714 714  
715 -[[image:1657333200519-600.png]]
747 +[[image:1657261278785-153.png]]
716 716  
717 717  
718 718  
... ... @@ -720,7 +720,7 @@
720 720  
721 721  == 4.1  Access AT Commands ==
722 722  
723 -See this link for detail: [[https:~~/~~/www.dragino.com/downloads/index.php?dir=NB-IoT/NDDS75/>>url:http://www.dragino.com/downloads/index.php?dir=NB-IoT/NBSN50/]]
755 +See this link for detail: [[http:~~/~~/www.dragino.com/downloads/index.php?dir=NB-IoT/NSE01/>>url:http://www.dragino.com/downloads/index.php?dir=NB-IoT/NBSN50/]]
724 724  
725 725  
726 726  AT+<CMD>?  : Help on <CMD>
... ... @@ -808,11 +808,18 @@
808 808  )))
809 809  
810 810  (((
811 -(% style="color:red" %)Notice, NDDS75 and LDDS75 share the same mother board. They use the same connection and method to update.
843 +(% style="color:red" %)Notice, NSE01 and LSE01 share the same mother board. They use the same connection and method to update.
812 812  )))
813 813  
814 814  
815 815  
848 +== 5.2  Can I calibrate NSE01 to different soil types? ==
849 +
850 +(((
851 +NSE01 is calibrated for saline-alkali soil and loamy soil. If users want to use it for other soil, they can calibrate the value in the IoT platform base on the value measured by saline-alkali soil and loamy soil. The formula can be found at [[this link>>https://www.dragino.com/downloads/downloads/LoRa_End_Node/LSE01/Calibrate_to_other_Soil_20220605.pdf]].
852 +)))
853 +
854 +
816 816  = 6.  Trouble Shooting =
817 817  
818 818  == 6.1  ​Connection problem when uploading firmware ==
... ... @@ -840,7 +840,7 @@
840 840  = 7. ​ Order Info =
841 841  
842 842  
843 -Part Number**:** (% style="color:#4f81bd" %)**NSDDS75**
882 +Part Number**:** (% style="color:#4f81bd" %)**NSE01**
844 844  
845 845  
846 846  (% class="wikigeneratedid" %)
... ... @@ -855,7 +855,7 @@
855 855  
856 856  (% style="color:#037691" %)**Package Includes**:
857 857  
858 -* NSE01 NB-IoT Distance Detect Sensor Node x 1
897 +* NSE01 NB-IoT Soil Moisture & EC Sensor x 1
859 859  * External antenna x 1
860 860  )))
861 861  
... ... @@ -864,11 +864,8 @@
864 864  
865 865  (% style="color:#037691" %)**Dimension and weight**:
866 866  
867 -
868 -* Device Size: 13.0 x 5 x 4.5 cm
869 -* Device Weight: 150g
870 -* Package Size / pcs : 15 x 12x 5.5 cm
871 -* Weight / pcs : 220g
906 +* Size: 195 x 125 x 55 mm
907 +* Weight:   420g
872 872  )))
873 873  
874 874  (((
1657332990863-496.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -138.2 KB
Content
1657333200519-600.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -126.1 KB
Content
1657348034241-728.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -127.8 KB
Content
1657348284168-431.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -93.5 KB
Content
1657350248151-650.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -126.1 KB
Content
1657350625843-586.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -93.3 KB
Content
1657351240556-536.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -483.6 KB
Content
1657351312545-300.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -675.8 KB
Content
1657352146020-183.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -264.0 KB
Content
1657352185396-303.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -98.3 KB
Content
1657352391268-297.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -238.0 KB
Content
1657352403317-397.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -547.7 KB
Content
1657352634421-276.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -163.6 KB
Content
1657352645687-385.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -214.7 KB
Content
1657352898400-901.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -144.8 KB
Content
1657352914475-252.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -157.0 KB
Content
1657354294009-643.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -214.7 KB
Content
image-20220709100028-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -8.8 KB
Content
image-20220709101450-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -138.5 KB
Content
image-20220709110451-3.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -611.5 KB
Content
image-20220709144723-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -413.1 KB
Content
image-20220709150546-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -333.5 KB
Content
image-20220709161741-3.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -111.2 KB
Content