<
From version < 115.27 >
edited by Xiaoling
on 2022/07/11 08:36
To version < 130.9 >
edited by Xiaoling
on 2023/04/28 14:02
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -19,8 +19,6 @@
19 19  
20 20  == 1.1 ​ What is N95S31B NB-IoT Sensor Node ==
21 21  
22 -(((
23 -
24 24  
25 25  (((
26 26  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*.
... ... @@ -39,22 +39,16 @@
39 39  )))
40 40  
41 41  (((
42 -
43 -)))
44 -
45 -(((
46 46  ~* make sure you have NB-IoT coverage locally.
47 47  )))
48 48  
49 -
50 -)))
51 51  
52 52  [[image:1657348284168-431.png]]
53 53  
54 54  
55 -
56 56  == 1.2 ​ Features ==
57 57  
49 +
58 58  * NB-IoT Bands: B1/B3/B8/B5/B20/B28 @H-FDD
59 59  * Monitor Temperature & Humidity via SHT31
60 60  * AT Commands to change parameters
... ... @@ -66,9 +66,6 @@
66 66  * Micro SIM card slot for NB-IoT SIM
67 67  * 8500mAh Battery for long term use
68 68  
69 -
70 -
71 -
72 72  == 1.3  Specification ==
73 73  
74 74  
... ... @@ -79,16 +79,15 @@
79 79  
80 80  (% style="color:#037691" %)**NB-IoT Spec:**
81 81  
82 -* - B1 @H-FDD: 2100MHz
83 -* - B3 @H-FDD: 1800MHz
84 -* - B8 @H-FDD: 900MHz
85 -* - B5 @H-FDD: 850MHz
86 -* - B20 @H-FDD: 800MHz
87 -* - B28 @H-FDD: 700MHz
71 +* B1 @H-FDD: 2100MHz
72 +* B3 @H-FDD: 1800MHz
73 +* B8 @H-FDD: 900MHz
74 +* B5 @H-FDD: 850MHz
75 +* B20 @H-FDD: 800MHz
76 +* B28 @H-FDD: 700MHz
88 88  
89 89  (% style="color:#037691" %)**Battery:**
90 90  
91 -
92 92  * Li/SOCI2 un-chargeable battery
93 93  * Capacity: 8500mAh
94 94  * Self Discharge: <1% / Year @ 25°C
... ... @@ -97,6 +97,7 @@
97 97  
98 98  == ​1.4  Applications ==
99 99  
88 +
100 100  * Smart Buildings & Home Automation
101 101  * Logistics and Supply Chain Management
102 102  * Smart Metering
... ... @@ -108,40 +108,49 @@
108 108  ​
109 109  
110 110  
111 -== 1.5  Pin Definitions ==
100 +== 1.5  Pin Definitions & Switch ==
112 112  
102 +
113 113  N95S31B use the mother board from NBSN95 which as below.
114 114  
105 +
115 115  [[image:image-20220709144723-1.png]]
116 116  
117 117  
118 118  === 1.5.1 Jumper JP2 ===
119 119  
111 +
120 120  Power on Device when put this jumper.
121 121  
122 122  
123 -
124 124  === 1.5.2 BOOT MODE / SW1 ===
125 125  
126 -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.
127 127  
128 -2) Flash: work mode, device starts to work and send out console output for further debug
118 +(((
119 +**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.
120 +)))
129 129  
122 +(((
123 +**2) Flash:**  work mode, device starts to work and send out console output for further debug
124 +)))
130 130  
131 131  
132 132  === 1.5.3 Reset Button ===
133 133  
129 +
134 134  Press to reboot the device.
135 135  
136 136  
137 -
138 138  === 1.5.4 LED ===
139 139  
135 +
140 140  It will flash:
141 141  
142 -1. When boot the device in flash mode
143 -1. Send an uplink packet
138 +1.  When boot the device in flash mode
144 144  
140 +2.  Send an uplink packet
141 +
142 +
145 145  = 2.  Use N95S31B to communicate with IoT Server =
146 146  
147 147  == 2.1  How it works ==
... ... @@ -160,16 +160,14 @@
160 160  
161 161  )))
162 162  
163 -[[image:1657350248151-650.png]]
161 +[[image:1657520100595-569.png]]
164 164  
165 165  (((
166 166  
167 167  )))
168 168  
169 -
170 170  == 2.2 ​ Configure the N95S31B ==
171 171  
172 -
173 173  === 2.2.1  Power On N95S31B ===
174 174  
175 175  
... ... @@ -176,26 +176,48 @@
176 176  [[image:image-20220709150546-2.png]]
177 177  
178 178  
179 -=== 2.2.1 Test Requirement ===
175 +=== 2.2.2 Test Requirement ===
180 180  
181 181  
178 +(((
182 182  To use N95S31B in your city, make sure meet below requirements:
180 +)))
183 183  
184 -* Your local operator has already distributed a NB-IoT Network there.
185 -* The local NB-IoT network used the band that N95S31B supports.
186 -* Your operator is able to distribute the data received in their NB-IoT network to your IoT server.
182 +* (((
183 +Your local operator has already distributed a NB-IoT Network there.
184 +)))
185 +* (((
186 +The local NB-IoT network used the band that N95S31B supports.
187 +)))
188 +* (((
189 +Your operator is able to distribute the data received in their NB-IoT network to your IoT server.
190 +)))
187 187  
192 +(((
188 188  Below figure shows our testing structure. Here we have NB-IoT network coverage by China Mobile, the band they use is B8.
194 +)))
189 189  
196 +(((
190 190  N95S31B supports different communication protocol such as :
198 +)))
191 191  
192 192  (((
193 -* CoAP  ((% style="color:red" %)120.24.4.116:5683(%%))
194 -* raw UDP  ((% style="color:red" %)120.24.4.116:5601(%%))
195 -* MQTT  ((% style="color:red" %)120.24.4.116:1883(%%))
196 -* TCP  ((% style="color:red" %)120.24.4.116:5600(%%))
201 +* (((
202 +CoAP  ((% style="color:red" %)120.24.4.116:5683(%%))
203 +)))
204 +* (((
205 +raw UDP  ((% style="color:red" %)120.24.4.116:5601(%%))
206 +)))
207 +* (((
208 +MQTT  ((% style="color:red" %)120.24.4.116:1883(%%))
209 +)))
210 +* (((
211 +TCP  ((% style="color:red" %)120.24.4.116:5600(%%))
212 +)))
197 197  
214 +(((
198 198  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.
216 +)))
199 199  
200 200  
201 201  )))
... ... @@ -203,9 +203,9 @@
203 203  [[image:1657350625843-586.png]]
204 204  
205 205  
206 -
207 207  === 2.2.3  Insert SIM card ===
208 208  
226 +
209 209  (((
210 210  Insert the NB-IoT Card get from your provider.
211 211  )))
... ... @@ -218,26 +218,29 @@
218 218  [[image:1657351240556-536.png]]
219 219  
220 220  
221 -
222 222  === 2.2.4  Connect USB – TTL to N95S31B to configure it ===
223 223  
241 +
224 224  (((
225 225  (((
226 226  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.
245 +
246 +
227 227  )))
228 228  )))
229 229  
230 230  [[image:1657351312545-300.png]]
231 231  
232 -**Connection:**
233 233  
234 - (% style="background-color:yellow" %)USB TTL GND <~-~-~-~-> GND
253 +(% style="color:blue" %)**Connection:**
235 235  
236 - (% style="background-color:yellow" %)USB TTL TXD <~-~-~-~-> UART_RXD
255 + (% style="background-color:yellow" %)**USB TTL GND <~-~-~-~-> GND**
237 237  
238 - (% style="background-color:yellow" %)USB TTL RXD <~-~-~-~-> UART_TXD
257 +**~ (% style="background-color:yellow" %)USB TTL TXD <~-~-~-~-> UART_RXD(%%)**
239 239  
259 +**~ (% style="background-color:yellow" %)USB TTL RXD <~-~-~-~-> UART_TXD(%%)**
240 240  
261 +
241 241  In the PC, use below serial tool settings:
242 242  
243 243  * Baud:  (% style="color:green" %)**9600**
... ... @@ -252,17 +252,18 @@
252 252  
253 253  [[image:1657329814315-101.png]]
254 254  
276 +
255 255  (((
256 -(% 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/]]
278 +(% style="color:red" %)**Note: the valid AT Commands can be found at:  **(%%)**[[https:~~/~~/www.dropbox.com/sh/mlpd6l05bogvaf6/AABwAJLMttqG7i~~-~~-AyZcQkoua?dl=0>>https://www.dropbox.com/sh/mlpd6l05bogvaf6/AABwAJLMttqG7i--AyZcQkoua?dl=0]]**
257 257  )))
258 258  
259 259  
260 -
261 261  === 2.2.5  Use CoAP protocol to uplink data ===
262 262  
263 -(% 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/]]
264 264  
285 +(% 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/]]**
265 265  
287 +
266 266  (((
267 267  **Use below commands:**
268 268  )))
... ... @@ -271,10 +271,10 @@
271 271  (% style="color:blue" %)**AT+PRO=1**  (%%) ~/~/ Set to use CoAP protocol to uplink
272 272  )))
273 273  * (((
274 -(% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5683   ** (%%)~/~/ to set CoAP server address and port
296 +(% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5683   ** (%%)~/~/ to set CoAP server address and port
275 275  )))
276 276  * (((
277 -(% style="color:blue" %)**AT+URI=5,11,"mqtt",11,"coap",12,"0",15,"c=text1",23,"0" ** (%%) ~/~/Set COAP resource path
299 +(% style="color:blue" %)**AT+URI=5,11,"mqtt",11,"coap",12,"0",15,"c=text1",23,"0" ** (%%) ~/~/  Set COAP resource path
278 278  )))
279 279  
280 280  (((
... ... @@ -293,7 +293,6 @@
293 293  [[image:1657352185396-303.png]]
294 294  
295 295  
296 -
297 297  === 2.2.6  Use UDP protocol to uplink data(Default protocol) ===
298 298  
299 299  
... ... @@ -307,18 +307,18 @@
307 307  [[image:1657352403317-397.png]]
308 308  
309 309  
310 -
311 311  === 2.2.7  Use MQTT protocol to uplink data ===
312 312  
333 +
313 313  N95S31B supports only plain MQTT now it doesn't support TLS and other related encryption.
314 314  
315 -* (% style="color:blue" %)**AT+PRO=3   ** (%%) ~/~/Set to use MQTT protocol to uplink
316 -* (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,1883   ** (%%) ~/~/Set MQTT server address and port
317 -* (% style="color:blue" %)**AT+CLIENT=CLIENT       ** (%%)~/~/Set up the CLIENT of MQTT
318 -* (% style="color:blue" %)**AT+UNAME=UNAME                                **(%%)~/~/Set the username of MQTT
319 -* (% style="color:blue" %)**AT+PWD=PWD                                         **(%%)~/~/Set the password of MQTT
320 -* (% style="color:blue" %)**AT+PUBTOPIC=f9527                               **(%%)~/~/Set the sending topic of MQTT
321 -* (% style="color:blue" %)**AT+SUBTOPIC=Ns9527          **(%%) ~/~/Set the subscription topic of MQTT
336 +* (% style="color:blue" %)**AT+PRO=3   ** (%%) ~/~/  Set to use MQTT protocol to uplink
337 +* (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,1883   ** (%%) ~/~/  Set MQTT server address and port
338 +* (% style="color:blue" %)**AT+CLIENT=CLIENT       ** (%%)~/~/  Set up the CLIENT of MQTT
339 +* (% style="color:blue" %)**AT+UNAME=UNAME                                **(%%)~/~/  Set the username of MQTT
340 +* (% style="color:blue" %)**AT+PWD=PWD                                         **(%%)~/~/  Set the password of MQTT
341 +* (% style="color:blue" %)**AT+PUBTOPIC=f9527                               **(%%)~/~/  Set the sending topic of MQTT
342 +* (% style="color:blue" %)**AT+SUBTOPIC=Ns9527          **(%%) ~/~/  Set the subscription topic of MQTT
322 322  
323 323  [[image:1657352634421-276.png]]
324 324  
... ... @@ -325,19 +325,19 @@
325 325  
326 326  [[image:1657352645687-385.png]]
327 327  
349 +
328 328  (((
329 329  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.
330 330  )))
331 331  
332 -
333 333  (((
334 334  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.
335 335  )))
336 336  
337 337  
338 -
339 339  === 2.2.8  Use TCP protocol to uplink data ===
340 340  
361 +
341 341  This feature is supported since firmware version v110
342 342  
343 343  * (% style="color:blue" %)**AT+PRO=4   ** (%%) ~/~/ Set to use TCP protocol to uplink
... ... @@ -349,9 +349,9 @@
349 349  [[image:1657352914475-252.png]]
350 350  
351 351  
352 -
353 353  === 2.2.9  Change Update Interval ===
354 354  
375 +
355 355  User can use below command to change the (% style="color:green" %)**uplink interval**.
356 356  
357 357  * (% style="color:blue" %)**AT+TDC=600      ** (%%)~/~/ Set Update Interval to 600s
... ... @@ -360,43 +360,71 @@
360 360  
361 361  )))
362 362  
384 +(((
385 +(% style="color:red" %)**NOTE: Since firmware version is v1.2:**
386 +)))
363 363  
388 +(((
389 +(% style="color:red" %)**By default, the device will send an uplink message every 2 hours. Each Uplink Include 8 set of records in this 2 hour (15 minute interval / record).**
390 +)))
364 364  
392 +
365 365  == 2.3  Uplink Payload ==
366 366  
367 367  
368 -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.
396 +(((
397 +N95S31B has different working modes for the connections of different types 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.
398 +)))
369 369  
370 370  
401 +(((
371 371  For example:
403 +)))
372 372  
373 - (% 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.
405 +(((
406 + (% style="color:blue" %)**AT+CFGMOD=2 ** (%%)~/~/  will set the N95S31B to work in MOD=2 distance mode which target to measure distance via Ultrasonic Sensor.
407 +)))
374 374  
375 375  
410 +(((
376 376  The uplink payloads are composed in  ASCII String. For example:
412 +)))
377 377  
414 +(((
378 378  0a cd 00 ed 0a cc 00 00 ef 02 d2 1d (total 24 ASCII Chars) . Representative the actually payload:
416 +)))
379 379  
418 +(((
380 380  0x 0a cd 00 ed 0a cc 00 00 ef 02 d2 1d Total 12 bytes
420 +)))
381 381  
382 382  
423 +(((
383 383  (% style="color:red" %)**NOTE:**
425 +)))
384 384  
385 385  (% style="color:red" %)
386 -1. All modes share the same Payload Explanation from [[HERE>>||anchor="H2.3A0UplinkPayload"]].
387 -1. By default, the device will send an uplink message every 1 hour.
428 +1. (((
429 +**All modes share the same Payload Explanation from [[HERE>>||anchor="H2.3A0UplinkPayload"]].**
430 +)))
431 +1. (((
432 +**By default, the device will send an uplink message every 1 hour.**
388 388  
389 389  
435 +
436 +)))
437 +
390 390  === 2.3.1  Payload Analyze ===
391 391  
440 +==== 2.3.1.1  Before Firmware v1.2 ====
441 +
442 +
392 392  N95S31B uplink payload includes in total 21 bytes
393 393  
394 394  
395 -(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:520px" %)
396 -|=(% style="width: 60px;" %)(((
397 -**Size(bytes)**
398 -)))|=(% style="width: 50px;" %)**6**|=(% style="width: 25px;" %)2|=(% style="width: 25px;" %)**2**|=(% style="width: 70px;" %)**1**|=(% style="width: 55px;" %)1|=(% style="width: 115px;" %)5|=(% style="width: 60px;" %)**2**|=(% style="width: 60px;" %)**2**
399 -|(% style="width:97px" %)**Value**|(% style="width:83px" %)[[Device ID>>||anchor="H2.3.2A0DeviceID"]]|(% style="width:41px" %)[[Ver>>||anchor="H2.3.3A0VersionInfo"]]|(% style="width:46px" %)[[BAT>>||anchor="H2.3.4A0BatteryInfo"]]|(% style="width:123px" %)[[Signal Strength>>||anchor="H2.3.5A0SignalStrength"]]|(% style="width:123px" %)MOD 0X01|(% style="width:99px" %)(((
446 +(% border="1" style="background-color:#f2f2f2; width:520px" %)
447 +|=(% style="width: 50px;background-color:#D9E2F3" %)**Size(bytes)**|=(% style="width: 45px;background-color:#D9E2F3" %)**6**|=(% style="width: 25px;background-color:#D9E2F3" %)2|=(% style="width: 25px;background-color:#D9E2F3" %)**2**|=(% style="width: 65px;background-color:#D9E2F3" %)**1**|=(% style="width: 50px;background-color:#D9E2F3" %)1|=(% style="width: 120px;background-color:#D9E2F3" %)5|=(% style="width: 70px;background-color:#D9E2F3" %)**2**|=(% style="width: 70px;background-color:#D9E2F3" %)**2**
448 +|(% style="width:97px" %)**Value**|(% style="width:65px" %)[[Device ID>>||anchor="H2.3.2A0DeviceID"]]|(% style="width:50px" %)[[Ver>>||anchor="H2.3.3A0VersionInfo"]]|(% style="width:46px" %)[[BAT>>||anchor="H2.3.4A0BatteryInfo"]]|(% style="width:75px" %)[[Signal Strength>>||anchor="H2.3.5A0SignalStrength"]]|(% style="width:59px" %)MOD 0X01|(% style="width:162px" %)(((
400 400  (((
401 401  Reserve/ Same as NBSN95 CFGMOD=1
402 402  )))
... ... @@ -404,7 +404,7 @@
404 404  (((
405 405  No function here.
406 406  )))
407 -)))|(% style="width:77px" %)(((
456 +)))|(% style="width:102px" %)(((
408 408  (((
409 409  [[Temperature >>||anchor="H2.3.6A0Temperature26Humidity"]]
410 410  )))
... ... @@ -412,7 +412,7 @@
412 412  (((
413 413  By SHT31
414 414  )))
415 -)))|(% style="width:80px" %)(((
464 +)))|(% style="width:81px" %)(((
416 416  (((
417 417  [[Humidity>>||anchor="H2.3.6A0Temperature26Humidity"]]
418 418  )))
... ... @@ -423,6 +423,8 @@
423 423  )))
424 424  
425 425  (((
475 +
476 +
426 426  (((
427 427  If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NB sensor uplink data.
428 428  )))
... ... @@ -432,29 +432,87 @@
432 432  [[image:1657354294009-643.png]]
433 433  
434 434  
435 -The payload is ASCII string, representative same HEX: 0x724031607457006e0ccd1b0100dc000ccc00e10186 where:
486 +The payload is ASCII string, representative same HEX: (% style="background-color:yellow" %)**0x724031607457 006e 0ccd 1b 01 00dc000ccc 00e1 0186**
436 436  
437 -* Device ID: 0x724031607457 = 724031607457
438 -* Version: 0x006e=110=1.1.0
488 +**where:**
439 439  
440 -* BAT: 0x0ccd = 3277 mV = 3.277V
441 -* Signal: 0x1b = 27
442 -* Model: 0x01 = 1
443 -* 0x00dc000ccc= reserve, ignore in N95S31B
444 -* Temperature by SHT31: 0x00e1 = 225 = 22.5 °C
445 -* Humidity by SHT31: 0x0186 = 390 = 39.0 %rh
490 +* (% style="color:#037691" %)**Device ID:** (%%) 0x724031607457 = 724031607457
446 446  
492 +* (% style="color:#037691" %)**Version: **(%%) 0x006e=110=1.1.0
493 +
494 +* (% style="color:#037691" %)**BAT:**   (%%) 0x0ccd = 3277 mV = 3.277V
495 +
496 +* (% style="color:#037691" %)**Signal:** (%%) 0x1b = 27
497 +
498 +* (% style="color:#037691" %)**Model:** (%%) 0x01 = 1
499 +
500 +* (% style="color:#037691" %)**0x00dc000ccc= reserve, ignore in N95S31B**
501 +
502 +* (% style="color:#037691" %)**Temperature by SHT31:** (%%) 0x00e1 = 225 = 22.5 °C
503 +
504 +* (% style="color:#037691" %)**Humidity by SHT31:**  (%%) 0x0186 = 390 = 39.0 %rh
505 +
447 447  (((
448 448  
449 -)))
450 450  
451 -(((
452 452  
453 453  )))
454 454  
512 +==== 2.3.1.2 Since Firmware v1.2 ====
455 455  
514 +
515 +In this mode, uplink payload includes 91 bytes in total by default.
516 +
517 +Each time the device uploads a data package, 8 sets of recorded data will be attached. Up to 32 sets of recorded data can be uploaded.
518 +
519 +
520 +(% border="1" style="background-color:#f2f2f2; width:520px" %)
521 +|=(% style="width: 50px;background-color:#D9E2F3;color:#0070C0" %)**Size(bytes)**|(% style="background-color:#d9e2f3; color:#0070c0; width:40px" %)**8**|(% style="background-color:#d9e2f3; color:#0070c0; width:20px" %)**2**|(% style="background-color:#d9e2f3; color:#0070c0; width:20px" %)**2**|(% style="background-color:#d9e2f3; color:#0070c0; width:30px" %)**1**|(% style="background-color:#d9e2f3; color:#0070c0; width:20px" %)**1**|(% style="background-color:#d9e2f3; color:#0070c0; width:55px" %)**2**|(% style="background-color:#d9e2f3; color:#0070c0; width:35px" %)**1**|(% style="background-color:#d9e2f3; color:#0070c0; width:20px" %)**2**|(% style="background-color:#d9e2f3; color:#0070c0; width:40px" %)**2**|(% style="background-color:#d9e2f3; color:#0070c0; width:40px" %)**2**|(% style="background-color:#d9e2f3; color:#0070c0; width:30px" %)**4**|(% style="background-color:#d9e2f3; color:#0070c0; width:40px" %)**2**|(% style="background-color:#d9e2f3; color:#0070c0; width:40px" %)**2**|(% style="background-color:#d9e2f3; color:#0070c0; width:35px" %)**4**
522 +|=(% style="width: 95px;" %)**Value**|(% style="width:82px" %)Device ID|(% style="width:43px" %)Ver|(% style="width:47px" %)BAT|(% style="width:124px" %)Signal Strength|(% style="width:56px" %)MOD|(% style="width:109px" %)TemDS18B20|(% style="width:80px" %)Interrupt|(% style="width:51px" %)ADC|(% style="width:79px" %)SHTTEM|(% style="width:84px" %)SHTHUM|(% style="width:100px" %)Time stamp |(% style="width:76px" %)SHTTEM|(% style="width:81px" %)SHTHUM|(% style="width:121px" %)Time stamp .....
523 +
524 +If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the N95S31B uplink data.
525 +
526 +
527 +[[image:image-20220908154949-1.png]]
528 +
529 +
530 +The payload is ASCII string, representative same HEX:
531 +
532 +**0x (% style="color:red" %)__f868411056758782__ (% style="color:blue" %)__000c__ (% style="color:green" %)__0d0f__ (% style="color:#00b0f0" %)__0c__ (% style="color:#7030a0" %)__01__ (% style="color:#d60093" %)__0000__ (% style="color:#a14d07" %)__00__ __0030__ (% style="color:#0020b0" %)__0114__ (% style="color:#420042" %)__0231__ (% style="color:#663300" %)__63199d3c__ (%%)__0113023163199d12__ __0113023163199c5e__// //__0112023763199baa__ __0112023263199af6__// //__0111023b631999a7__ **
533 +
534 +**__0112023b631998f3__// //__011202426319983f__ __01110242631996eb__**
535 +
536 +**where:**
537 +
538 +* (% style="color:#037691" %)**Device ID:**(%%) f868411056758782 = f868411056758782
539 +
540 +* (% style="color:#037691" %)**Version:** (%%)0x000c=120=1.2
541 +
542 +* (% style="color:#037691" %)**BAT:**      (%%)0x0d0f = 3343 mV = 3.343V
543 +
544 +* (% style="color:#037691" %)**Singal:**(%%)  0x0c = 12
545 +
546 +* (% style="color:#037691" %)**Mod:**(%%)  0x01 = 1
547 +
548 +* (% style="color:#037691" %)**TemDS18B20:**(%%)  0x0000= 0 = 0
549 +
550 +* (% style="color:#037691" %)**Interrupt:**  (%%)0x00= 0
551 +
552 +* (% style="color:#037691" %)**adc:**(%%)  0x0030= 48
553 +
554 +* (% style="color:#037691" %)**SHTTEM:**(%%)  0x0114= 276 = 27.6
555 +
556 +* (% style="color:#037691" %)**SHTHUM:**(%%)  0x0231 =561=56.1%
557 +
558 +* (% style="color:#037691" %)**Time stamp :  **(%%)0x63199d3c =1662342011  ([[Unix Epoch Time>>url:http://www.epochconverter.com/]])
559 +
560 +* (% style="color:#037691" %)**SHTTEM,SHTHUM,Time stamp :**(%%)  0113023163199d12
561 +
562 +* (% style="color:#037691" %)**8 sets of recorded data:**(%%)** **SHTTEM,SHTHUM,Time stamp : 0113023163199c5e, .......
563 +
456 456  === 2.3.2  Device ID ===
457 457  
566 +
458 458  (((
459 459  By default, the Device ID equal to the last 6 bytes of IMEI.
460 460  )))
... ... @@ -461,10 +461,12 @@
461 461  
462 462  (((
463 463  User can use (% style="color:blue" %)**AT+DEUI**(%%) to set Device ID
573 +
574 +
464 464  )))
465 465  
466 466  (((
467 -**Example:**
578 +(% style="color:blue" %)**Example:**
468 468  )))
469 469  
470 470  (((
... ... @@ -472,30 +472,54 @@
472 472  )))
473 473  
474 474  (((
475 -The Device ID is stored in a none-erase area, Upgrade the firmware or run **AT+FDR** won't erase Device ID.
586 +The Device ID is stored in a none-erase area, Upgrade the firmware or run (% style="color:blue" %)**AT+FDR**(%%) won't erase Device ID.
587 +
588 +
476 476  )))
477 477  
591 +(% style="color:red" %)**NOTE: When the firmware version is v1.2 and later firmware:**
478 478  
479 479  
594 +By default, the Device ID equal to the last 15 bits of IMEI.
595 +
596 +User can use ** (% style="color:blue" %)AT+DEUI(%%)** to set Device ID
597 +
598 +
599 +(% style="color:blue" %)**Example:**
600 +
601 +AT+DEUI=868411056754138
602 +
603 +
480 480  === 2.3.3  Version Info ===
481 481  
482 482  
607 +(((
483 483  These bytes include the hardware and software version.
609 +)))
484 484  
485 -Higher byte: Specify hardware version: always 0x00 for N95S31B
611 +(((
612 +**Higher byte:** Specify hardware version: always 0x00 for N95S31B
613 +)))
486 486  
487 -Lower byte: Specify the software version: 0x6E=110, means firmware version 110
615 +(((
616 +**Lower byte:** Specify the software version: 0x6E=110, means firmware version 110
617 +)))
488 488  
619 +(((
620 +
621 +)))
489 489  
623 +(((
490 490  For example: 0x00 6E: this device is N95S31B with firmware version 110.
625 +)))
491 491  
492 492  (((
493 493  
494 494  )))
495 495  
496 -
497 497  === 2.3.4  Battery Info ===
498 498  
633 +
499 499  (((
500 500  Ex1: 0x0B45 = 2885mV
501 501  )))
... ... @@ -505,9 +505,9 @@
505 505  )))
506 506  
507 507  
508 -
509 509  === 2.3.5  Signal Strength ===
510 510  
645 +
511 511  (((
512 512  NB-IoT Network signal Strength.
513 513  )))
... ... @@ -537,9 +537,9 @@
537 537  )))
538 538  
539 539  
540 -
541 541  === 2.3.6  Temperature & Humidity ===
542 542  
677 +
543 543  The device will be able to get the SHT31 temperature and humidity data now and upload to IoT Server.
544 544  
545 545  [[image:image-20220709161741-3.png]]
... ... @@ -555,11 +555,17 @@
555 555  Humidity:    Read:0295(H)=661(D)    Value:  661 / 10=66.1, So 66.1%
556 556  
557 557  
558 -
559 559  == 2.4  Downlink Payload ==
560 560  
561 -By default, NDDS75 prints the downlink payload to console port.
562 562  
696 +By default, N95S31B prints the downlink payload to console port.
697 +
698 +(% border="1" style="background-color:#f2f2f2; width:531.818px" %)
699 +|(% style="background-color:#d9e2f3; color:#0070c0; width:204px" %)**Downlink Control Type**|(% style="background-color:#d9e2f3; color:#0070c0; width:80px" %)**FPort**|(% style="background-color:#d9e2f3; color:#0070c0; width:94px" %)**Type Code**|(% style="background-color:#d9e2f3; color:#0070c0; width:150px" %)**Downlink payload size(bytes)**
700 +|(% style="width:204px" %)TDC(Transmit Time Interval)|(% style="width:80px" %)Any|(% style="width:94px" %)01|(% style="width:150px" %)4
701 +|(% style="width:204px" %)RESET|(% style="width:80px" %)Any|(% style="width:94px" %)04|(% style="width:150px" %)2
702 +|(% style="width:204px" %)INTMOD|(% style="width:80px" %)Any|(% style="width:94px" %)06|(% style="width:150px" %)4
703 +
563 563  [[image:image-20220709100028-1.png]]
564 564  
565 565  
... ... @@ -596,7 +596,7 @@
596 596  )))
597 597  
598 598  (((
599 -If payload = 0x04FF, it will reset the NDDS75
740 +If payload = 0x04FF, it will reset the N95S31B
600 600  )))
601 601  
602 602  
... ... @@ -607,69 +607,76 @@
607 607  )))
608 608  
609 609  
751 +== 2.5  Humidity and Temperature alarm function ==
610 610  
611 -== 2.5  ​Battery Analysis ==
612 612  
613 -=== 2.5.1  ​Battery Type ===
754 +**~ (% style="color:blue" %)➢ AT Command:(%%)**
614 614  
615 615  
616 -(((
617 -The N95S31B 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.
618 -)))
757 +(% style="color:#037691" %)**AT+ SHHUM=min,max**
619 619  
620 -(((
621 -The battery is designed to last for several years depends on the actually use environment and update interval. 
622 -)))
623 623  
624 -(((
625 -The battery related documents as below:
626 -)))
760 +² When min=0, and max≠0, Alarm higher than max
627 627  
628 -* [[Battery Dimension>>http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
629 -* [[Lithium-Thionyl Chloride Battery datasheet>>http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
630 -* [[Lithium-ion Battery-Capacitor datasheet>>http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
762 +² When min≠0, and max=0, Alarm lower than min
631 631  
632 -(((
633 -[[image:image-20220709101450-2.png]]
634 -)))
764 +² When min≠0 and max≠0, Alarm higher than max or lower than min
635 635  
636 636  
767 + (% style="color:blue" %)**Example:**
637 637  
638 -=== 2.5.2  Power consumption Analyze ===
769 +AT+ SHHUM=50,80 ~/~/ Alarm when humidity lower than 50.
639 639  
640 -(((
641 -The file **DRAGINO_N95S31B-Power-Analyzer.pdf** from [[https:~~/~~/www.dragino.com/downloads/index.php?dir=NB-IoT/N95S31B/>>url:https://www.dragino.com/downloads/index.php?dir=NB-IoT/N95S31B/]] describes a detail measurement to analyze the power consumption in different case. User can use it for design guideline for their project.
642 -)))
643 643  
644 -(((
645 -
646 -)))
772 +(% style="color:#037691" %)**AT+ SHTEMP=min,max**
647 647  
774 +² When min=0, and max≠0, Alarm higher than max
648 648  
649 -=== 2.5.3  ​Battery Note ===
776 +² When min≠0, and max=0, Alarm lower than min
650 650  
651 -(((
652 -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 uplink data, then the battery life may be decreased.
653 -)))
778 +² When min≠0 and max≠0, Alarm higher than max or lower than min
654 654  
655 655  
781 +**~ (% style="color:blue" %)Example:(%%)**
656 656  
657 -=== 2.5.4  Replace the battery ===
783 +AT+ SHTEMP=20,30 ~/~/ Alarm when temperature lower than 20.
658 658  
659 659  
660 -(((
661 -You can change the battery in the N95S31B.The type of battery is not limited as long as the output is between 3v to 3.6v. On the main board, there is a diode (D1) between the battery and the main circuit. If you need to use a battery with less than 3.3v, please remove the D1 and shortcut the two pads of it so there won't be voltage drop between battery and main board.
662 -)))
786 +== 2.6 Set the number of data to be uploaded and the recording time ==
663 663  
664 664  
665 -(((
666 -The default battery pack of N95S31B 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).
667 -)))
789 +**~ (% style="color:blue" %)➢ AT Command:(%%)**
668 668  
791 +* (% style="color:#037691" %)**AT+TR=900**     (%%)~/~/  The unit is seconds, and the default is to record data once every 900 seconds.( The minimum can be set to 180 seconds)
792 +* (% 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.
669 669  
794 + The diagram below explains the relationship between TR, NOUD, and TDC more clearly**:**
670 670  
796 +[[image:image-20221009001045-1.png||height="726" width="1009"]]
797 +
798 +
799 +== 2.7 Read or Clear cached data ==
800 +
801 +
802 +**~ (% style="color:blue" %)➢ AT Command:(%%)**
803 +
804 +* (% style="color:#037691" %)**AT+CDP**  (%%) ~/~/ Read cached data
805 +* (% style="color:#037691" %)**AT+CDP=0** (%%) ~/~/  Clear cached data
806 +
807 +[[image:image-20220908163102-2.png]]
808 +
809 +
810 +== 2.8 Battery & Power Consumption ==
811 +
812 +
813 +N95S31B uses ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
814 +
815 +[[**Battery Info & Power Consumption Analyze**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
816 +
817 +
671 671  = 3. ​ Access NB-IoT Module =
672 672  
820 +
673 673  (((
674 674  Users can directly access the AT command set of the NB-IoT module.
675 675  )))
... ... @@ -676,19 +676,21 @@
676 676  
677 677  (((
678 678  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/]] 
827 +
828 +
679 679  )))
680 680  
681 681  [[image:1657333200519-600.png]]
682 682  
683 683  
684 -
685 685  = 4.  Using the AT Commands =
686 686  
687 687  == 4.1  Access AT Commands ==
688 688  
689 -See NBSN95 AT Command in this link for detail:  [[https:~~/~~/www.dragino.com/downloads/index.php?dir=NB-IoT/NBSN95/>>url:https://www.dragino.com/downloads/index.php?dir=NB-IoT/NBSN95/]]
690 690  
839 +See NBSN95 AT Command in this link for detail:  [[https:~~/~~/www.dropbox.com/sh/jao1xt9kw5r3yq4/AAAMpJkZzExF2JLbRWxGoQ9Na?dl=0>>https://www.dropbox.com/sh/jao1xt9kw5r3yq4/AAAMpJkZzExF2JLbRWxGoQ9Na?dl=0]]
691 691  
841 +
692 692  AT+<CMD>?  : Help on <CMD>
693 693  
694 694  AT+<CMD>         : Run <CMD>
... ... @@ -728,7 +728,24 @@
728 728  
729 729  AT+SERVADDR  : Server Address
730 730  
881 +AT+TR      : Get or Set record time
731 731  
883 +AT+APN     : Get or set the APN
884 +
885 +AT+FBAND   : Get or Set whether to automatically modify the frequency band
886 +
887 +AT+DNSCFG  : Get or Set DNS Server
888 +
889 +AT+GETSENSORVALUE   : Returns the current sensor measurement
890 +
891 +AT+NOUD      : Get or Set the number of data to be uploaded
892 +
893 +AT+CDP     : Read or Clear cached data
894 +
895 +AT+SHTEMP: Get or Set alarm of temp
896 +
897 +AT+SHHUM: Get or Set alarm of moisture
898 +
732 732  (% style="color:#037691" %)**COAP Management**      
733 733  
734 734  AT+URI            : Resource parameters
... ... @@ -759,7 +759,6 @@
759 759  AT+PWORD  : Serial Access Password
760 760  
761 761  
762 -
763 763  = ​5.  FAQ =
764 764  
765 765  == 5.1 ​ How to Upgrade Firmware ==
... ... @@ -774,13 +774,12 @@
774 774  )))
775 775  
776 776  (((
777 -
943 +Firmware Download:[[https:~~/~~/www.dropbox.com/sh/fr8w23rb951512i/AACSJeGQg-7ZjKhAI_Sn57H6a?dl=0>>https://www.dropbox.com/sh/fr8w23rb951512i/AACSJeGQg-7ZjKhAI_Sn57H6a?dl=0]]
778 778  
779 -(% style="color:red" %)Notice, N95S31B and LSN50v2 share the same mother board. They use the same connection and method to update.
945 +(% style="color:red" %)**Notice, N95S31B and LSN50v2 share the same mother board. They use the same connection and method to update.**
780 780  )))
781 781  
782 782  
783 -
784 784  = 6.  Trouble Shooting =
785 785  
786 786  == 6.1  ​Connection problem when uploading firmware ==
... ... @@ -790,14 +790,10 @@
790 790  **Please see: **[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/#H3.3Troubleshooting>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/#H3.3Troubleshooting]]
791 791  )))
792 792  
793 -(% class="wikigeneratedid" %)
794 -(((
795 -
796 -)))
797 797  
798 -
799 799  == 6.2  AT Command input doesn't work ==
800 800  
961 +
801 801  (((
802 802  In the case if user can see the console output but can't type input to the device. Please check if you already include the (% style="color:green" %)**ENTER**(%%) while sending out the command. Some serial tool doesn't send (% style="color:green" %)**ENTER**(%%) while press the send key, user need to add ENTER in their string.
803 803  
... ... @@ -804,7 +804,12 @@
804 804  
805 805  )))
806 806  
968 +== 6.3 Not able to connect to NB-IoT network and keep showing "Signal Strength:99". ==
807 807  
970 +
971 +This means sensor is trying to join the NB-IoT network but fail. Please see this link for **//[[trouble shooting for signal strenght:99>>doc:Main.CSQ\:99,99.WebHome]]//**.
972 +
973 +
808 808  = 7. ​ Order Info =
809 809  
810 810  
... ... @@ -811,11 +811,6 @@
811 811  Part Number**:** (% style="color:#4f81bd" %)**N95S31B-YY**
812 812  
813 813  
814 -(% class="wikigeneratedid" %)
815 -(((
816 -
817 -)))
818 -
819 819  = 8.  Packing Info =
820 820  
821 821  (((
... ... @@ -838,14 +838,13 @@
838 838  * Weight / pcs : 180g
839 839  )))
840 840  
841 -(((
842 -
843 843  
844 844  
845 -
846 -)))
847 -
848 848  = 9.  Support =
849 849  
1006 +
850 850  * 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.
1008 +
851 851  * 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.com>>url:http://../../../../../../D:%5C%E5%B8%82%E5%9C%BA%E8%B5%84%E6%96%99%5C%E8%AF%B4%E6%98%8E%E4%B9%A6%5CLoRa%5CLT%E7%B3%BB%E5%88%97%5Csupport@dragino.com]]
1010 +
1011 +
1657520100595-569.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +126.1 KB
Content
image-20220908154949-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.David
Size
... ... @@ -1,0 +1,1 @@
1 +58.5 KB
Content
image-20220908163102-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.David
Size
... ... @@ -1,0 +1,1 @@
1 +29.7 KB
Content
image-20221009001045-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Edwin
Size
... ... @@ -1,0 +1,1 @@
1 +282.9 KB
Content
Copyright ©2010-2022 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0