Last modified by Xiaoling on 2024/01/18 18:04
<
From version < 2.1 >
edited by Xiaoling
on 2022/11/12 11:32
To version < 2.2 >
edited by Xiaoling
on 2022/11/12 11:33
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,0 +1,585 @@
1 +(% style="text-align:center" %)
2 +[[image:image-20221112113258-1.jpeg]]
3 +
4 +
5 +
6 +
7 +
8 +
9 +
10 +
11 +
12 +
13 +
14 +
15 +
16 +
17 +
18 +
19 +
20 +
21 +
22 +
23 +
24 +
25 +
26 +
27 +
28 +
29 +
30 +
31 +
32 +
33 +
34 +1. Introduction
35 +11. ​What is NDS01 NB-IoT Door Sensor
36 +
37 +
38 +The Dragino NDS01 is a NB-IOT Door Sensor for Internet of Things solution. It is used to detect the open/close event for door and uplink the event to IoT server via NB-IoT network.
39 +
40 +
41 +Besides open/close event, NDS01 also has an internal temperature and humidity sensor which can detect the temperature and humidity inside the sensor*.
42 +
43 +
44 +**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.
45 +
46 +
47 +NDS01 is powered by 2 x AAA batteries for long term use.
48 +
49 +
50 +*The measured temperature is 2~~3 degree higher than the actually environment temperature out of NDS01. 
51 +
52 +
53 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image001.png]]
54 +
55 +
56 +
57 +
58 +1.
59 +11. ​Specifications
60 +
61 +**Common DC Characteristics:**
62 +
63 +*
64 +**
65 +***
66 +**** Supply Voltage: 2.1v ~~ 3.6v
67 +**** Operating Temperature: -10 ~~ 50°C
68 +
69 +
70 +
71 +**NB-IoT Spec:**
72 +
73 +* - B1 @H-FDD: 2100MHz
74 +* - B3 @H-FDD: 1800MHz
75 +* - B8 @H-FDD: 900MHz
76 +* - B5 @H-FDD: 850MHz
77 +* - B20 @H-FDD: 800MHz
78 +* - B28 @H-FDD: 700MHz
79 +
80 +
81 +
82 +**Power Consumption**
83 +
84 +* IDEL Mode: 10uA @ 3.3v
85 +* Max transmit power: <500mA@3.3v
86 +
87 +​
88 +
89 +*
90 +*1. ​Features
91 +* NB-IoT Bands: B1/B3/B5/B8/B20/B28 @H-FDD
92 +* Ultra low power consumption
93 +* Door Open / Close Detect
94 +* Device remove alarm
95 +* Uplink Protocol: TCP or UDP
96 +* Uplink on periodically
97 +* Micro SIM card slot for NB-IoT SIM
98 +* 2 x AAA LR03 Batteries
99 +*1. ​Applications
100 +* Smart Buildings & Home Automation
101 +* Logistics and Supply Chain Management
102 +* Smart Cities
103 +* Smart Factory
104 +
105 +
106 +
107 +
108 +
109 +​
110 +
111 +
112 +1. Use NDS01 to communicate with IoT Server
113 +11. How it works
114 +
115 +The NDS01 is equipped with a NB-IoT module, the pre-loaded firmware in NDS01 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 NDS01.
116 +
117 +
118 +The diagram below shows the working flow in default firmware of NDS01:
119 +
120 +
121 +
122 +
123 +
124 +1.
125 +11. Configure the NDS01
126 +111. Test Requirement
127 +
128 +
129 +To use NDS01 in your city, make sure meet below requirements:
130 +
131 +* Your local operator has already distributed a NB-IoT Network there.
132 +* The local NB-IoT network used the band that NDS01 supports.
133 +* Your operator is able to distribute the data received in their NB-IoT network to your IoT server.
134 +
135 +
136 +Below figure shows our testing structure. Here we have NB-IoT network coverage by China Mobile, the band they use is B8.  The NDS01 will use UDP(120.24.4.116:5601) or TCP(120.24.4.116:5600)protocol to send data to IoT server.
137 +
138 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image002.png]]
139 +
140 +
141 +
142 +1.
143 +11.
144 +111. Insert SIM card
145 +
146 +Insert the NB-IoT Card get from your provider.
147 +
148 +
149 +User need to take out the NB-IoT module and insert the SIM card like below:
150 +
151 +
152 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image003.png]]
153 +
154 +
155 +1.
156 +11.
157 +111. Configure NDS01
158 +
159 +
160 +User need to configure NDS01 via serial port to set the **Server Address** / **Uplink Topic** to define where and how-to uplink packets. NDS01 support AT Commands, user can use a USB to TTL adapter to connect to NDS01 and use AT Commands to configure it, NDS01 needs to be in the wake-up state when using AT commands,as below.
161 +
162 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image004.png]]
163 +
164 +
165 +
166 +Connection:
167 +
168 +USB TTL GND <~-~-~-~-> GND
169 +
170 +USB TTL TXD <~-~-~-~-> UART_RXD
171 +
172 +USB TTL RXD <~-~-~-~-> UART_TXD
173 +
174 +
175 +
176 +In the PC, use below serial tool settings:
177 +
178 +* Baud: **115200**
179 +* Data bits:** 8**
180 +* Stop bits: **1**
181 +* Parity: **None**
182 +* Flow Control: **None**
183 +
184 +After powering on the NDS01, the following information will be printed
185 +
186 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image005.png]]
187 +
188 +AT command set
189 +
190 +1. Set and query the communication protocol
191 +
192 + Send:  AT+PRO=<val>  Val: 0:TCP 1:UDP
193 +
194 + Reply: OK
195 +
196 + Send:  AT+PRO? ~/~/Inquire
197 +
198 + Reply: +PRO:0
199 +
200 +OK
201 +
202 +1. Set and query the server address
203 +
204 +Send: AT+SERVADDR=<server>,<port>        
205 +
206 + Reply: OK
207 +
208 +Send: AT+SERVADDR? ~/~/Inquire
209 +
210 +Reply: +SERVADDR:<server>,<port>
211 +
212 +OK
213 +
214 +1. Set and query the TDC
215 +
216 +Send:AT+TDC=<value>~/~/Heartbeat time, in seconds, the default is 86400s,which is 24 hours
217 +
218 +Reply:OK
219 +
220 +Send:AT+TDC?       ~/~/Inquire
221 +
222 +Reply: +TDC:<value>
223 +
224 +OK
225 +
226 +1. Query parameters
227 +
228 +Send:AT+CFG?            
229 +
230 +Reply:+PRO:0
231 +
232 ++SERVADDR:120.27.12.119,2023
233 +
234 ++TDC:86400
235 +
236 ++CSQ:31
237 +
238 ++IMEI:868163049937383
239 +
240 ++ICCID:898604611619C0854626
241 +
242 ++IMSI:460048118204626
243 +
244 +OK
245 +
246 +1. Set and query the APN
247 +
248 +Send: AT+APN="<apn>"             ~/~/Set APN          
249 +
250 + Reply: OK
251 +
252 +Send: AT+APN?     ~/~/Inquire
253 +
254 +Reply: +APN:"cmiot"
255 +
256 +OK
257 +
258 +1. Alarm and Silencer
259 +
260 +Send:AT+ALARM=<value>  ~/~/0~~1,0: mute 1: buzzer alarm (note that no data will be reported, only the buzzer and the red light are on, if it is in silent mode, only the red light is on)
261 +
262 +Reply: OK
263 +
264 +
265 +
266 +
267 +1.
268 +11.
269 +111. Use UDP protocol to uplink data (Default protocol)
270 +
271 +
272 +* **AT+PRO=1   ** ~/~/ Set to use UDP protocol to uplink
273 +* **AT+SERVADDR=119.91.62.30,1999   **~/~/ to set UDP server address and port
274 +
275 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image006.png]]
276 +
277 +
278 +
279 +*
280 +*1.
281 +*11. Use TCP protocol to uplink data
282 +* **AT+PRO=0   ** ~/~/ Set to use TCP protocol to uplink
283 +* **AT+SERVADDR=119.91.62.30,2002   **~/~/ to set TCP server address and port
284 +
285 +
286 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image007.png]]
287 +
288 +
289 +
290 +
291 +
292 +
293 +
294 +
295 +
296 +1.
297 +11.
298 +111. Change Update Interval
299 +
300 +User can use below command to change the **uplink interval**.
301 +
302 +**AT+TDC=86400      **~/~/ Set Update Interval to 86400s
303 +
304 +
305 +**NOTE:**
306 +
307 +1. By default, the device will send an uplink message every 24 hour (86400s).
308 +
309 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image008.png]]
310 +
311 +
312 +
313 +
314 +1.
315 +11. ​ Uplink Payload
316 +
317 +
318 +registration package, uplink payload includes in total 61 bytes
319 +
320 +
321 +|(((
322 +**Size**
323 +
324 +**(bytes)**
325 +)))|**2**|**1**|**1**|**1**|**1**|**15**|**15**|**20**|**1**|**1**|**3**
326 +|**Value**|head|Version|data type|Data length|device type|device ID|IMSI|ICCID|BAT|Signal|tail
327 +
328 +
329 +The payload is ASCII string, representative same HEX: 0x4B5710013401383639393735303334343431303832343630313133313138373433373332
330 +
331 +38393836313132303232343031343339383736321E15494F54 where:
332 +
333 +* Head: 0x4B57(fixed)
334 +* Version: 0x10=”V1.0”
335 +* Data type: 0x01=1(1:register,2:data sending)
336 +* Data length: 0x34=52(Valid data is 52 bytes)
337 +
338 +* Device type: 0x01 = 1(Representative NDS01)
339 +* Device ID:0x383639393735303334343431303832=869975034441082(ASCII)
340 +* IMSI: 0x343630313133313138373433373332 = 460113118743732(ASCII)
341 +* ICCID: 0x3839383631313230323234303134333938373632=89861120224014398762(ASCII)
342 +* Bat: 0x1E = 30/10=3.0V
343 +* Signal: 0x15=21
344 +
345 +**0** -113dBm or less
346 +
347 +**1** -111dBm
348 +
349 +**2...30** -109dBm... -53dBm
350 +
351 +**31** -51dBm or greater
352 +
353 +**99** Not known or not detectable
354 +
355 +* Tail:0x494F54(fixed)
356 +
357 +
358 +data upload, uplink payload includes in total 32 bytes
359 +
360 +|(((
361 +**Size**
362 +
363 +**(bytes)**
364 +)))|**2**|**1**|**1**|**1**|**1**|**15**|**1**|**1**|**1**|**1**|**1**|**1**|**1**|**1**|**3**
365 +|**Value**|head|Version|data type|Data length|device type|device ID|event type|Door magnetic state|BAT|Signal|(((
366 +Temp
367 +
368 +integer
369 +)))|(((
370 +Temp
371 +
372 +decimal
373 +)))|(((
374 +Hum
375 +
376 +integer
377 +)))|(((
378 +Hum
379 +
380 +decimal
381 +)))|tail
382 +
383 +
384 +The payload is ASCII string, representative same HEX: 0x4B5710021401383639393735303334343431303832010020151c552312494F54 where:
385 +
386 +* Head: 0x4B57(fixed)
387 +* Version: 0x10=”V1.0”
388 +* Data type: 0x02=2(1:register,2:data sending)
389 +* Data length: 0x14=20(Valid data is 20 bytes)
390 +
391 +* Device type: 0x01 = 1(Representative NDS01)
392 +* Device ID:0x383639393735303334343431303832=869975034441082(ASCII)
393 +* Event type:0x01
394 +
395 + 01:TDC
396 +
397 + 02:alarm
398 +
399 + 03:remove alarm
400 +
401 + 04:dismantling alarm
402 +
403 + 05:remove demolition alarm
404 +
405 + 06:low voltage
406 +
407 + 07:remove low voltage
408 +
409 +* Door magnetic state: 0x00
410 +
411 + 00:Door sensor is close
412 +
413 + 01:Door sensor is open
414 +
415 +* Bat: 0x20 = 32/10=3.2V
416 +* Signal: 0x15=21
417 +
418 +**0** -113dBm or less
419 +
420 +**1** -111dBm
421 +
422 +**2...30** -109dBm... -53dBm
423 +
424 +**31** -51dBm or greater
425 +
426 +**99** Not known or not detectable
427 +
428 +* Temp integer:0x1c=28
429 +* Temp decimal:0x55=85
430 +
431 + Temp =Temp integer+(Temp decimal)/100=28+85/100=28.85℃
432 +
433 +* Hum integer:0x23=35
434 +* Hum decimal:0x12=18
435 +
436 + Hum =Hum integer+(Hum decimal)/100=35+18/100=35.18**%rh**
437 +
438 +* Tail:0x494F54(fixed)
439 +
440 +
441 +
442 +
443 +1.
444 +11. Node-Red Example
445 +
446 +Please refer to this link for the use of Node-RED:
447 +
448 +[[http:~~/~~/8.211.40.43:8080/xwiki/bin/view/Main/Node-RED/>>url:http://8.211.40.43:8080/xwiki/bin/view/Main/Node-RED/]]
449 +
450 +Please visit this link to download the Node-RED process:
451 +
452 +[[https:~~/~~/github.com/dragino/dragino-end-node-decoder/tree/main/Node-RED>>url:https://github.com/dragino/dragino-end-node-decoder/tree/main/Node-RED]]
453 +
454 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image009.png]]
455 +
456 +
457 +
458 +
459 +
460 +
461 +
462 +
463 +
464 +
465 +
466 +
467 +
468 +
469 +1.
470 +11. Buttons and LED and Mode
471 +
472 +Operating mode
473 +
474 +(1) In the self-check mode (the default is the self-check mode when power on for the first time), the state change of the tamper switch does not trigger an alarm;
475 +
476 +(2) In normal working mode, the state change of the tamper switch triggers an alarm;
477 +
478 +(3) In silent mode (the default is non-silent mode when power on for the first time), the buzzer is silent.
479 +
480 +
481 +led lights
482 +
483 +(1) After the device is powered on, the green light flashes once;
484 +
485 +(2) The device does not set server parameters or cannot connect to the server, and the green light flashes quickly;
486 +
487 +(3) SIM card recognition fails, the green light is always on for 20s;
488 +
489 +(4) The equipment signal is poor, and the green light flashes once every 3 seconds;
490 +
491 +(5) When the device sends data, the green light flashes twice;
492 +
493 +(6) The communication of the equipment is normal, and the green light flashes 3 times continuously;
494 +
495 +(7) Trigger the tamper switch, the red light is always on for 30s, and goes out when the alarm is canceled;
496 +
497 +(8) Trigger the door magnetic alarm, the red light is always on for 30s, and goes out when the alarm is canceled;
498 +
499 +
500 +buzzer
501 +
502 +(1) When the door magnetic alarm is triggered, the buzzer will sound for 30s; after the alarm is restored, the buzzer will be silenced;
503 +
504 +(2) Enter the normal working mode (the tamper switch is closed for more than 5s or the door sensor is locked for more than 5s), the buzzer will sound for 1500ms;
505 +
506 +(3) After entering the normal working mode, the tamper switch does not close, the buzzer sounds for 30s, the tamper switch is closed, and the buzzer sounds 1 time;
507 +
508 +(4) When the door sensor does not alarm, press the button to trigger the alarm, and the buzzer will sound for 30s; when the door sensor alarms, press it once to cancel the alarm, and the buzzer will be silenced.
509 +
510 +
511 +button
512 +
513 +(1) When there is no alarm, press it once to trigger the alarm, and the buzzer will sound; when it alarms, press the buzzer to silence the sound.
514 +
515 +(2) Press twice to silence the buzzer;
516 +
517 +(3) Press the button three times or more, when the mute function is turned off, the mute function is turned on, and the green light flashes once; when the mute function is turned on, the mute function is turned off, and the green light flashes once.
518 +
519 +
520 +data pack
521 +
522 +(1) The device needs to send a registration packet and a heartbeat packet every time it is powered on and registered;
523 +
524 +(2) The heartbeat time is reported once every 24 hours by default.
525 +
526 +1. FAQ
527 +11. How to Upgrade Firmware
528 +
529 +User can upgrade the firmware for 1) bug fix, 2) new feature release.
530 +
531 +Burning software please go to this link to download:
532 +
533 +Note:
534 +
535 +Disconnect one battery before starting the upgrade
536 +
537 +Please use 1.8V USB TO TTL serial port
538 +
539 +Connection:
540 +
541 +USB TTL GND <~-~-~-~-> GND
542 +
543 +USB TTL TXD <~-~-~-~-> UART_RXD
544 +
545 +USB TTL RXD <~-~-~-~-> UART_TXD
546 +
547 +1. Double-click "FlashTool.exe" to start the program
548 +
549 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image010.png]]
550 +
551 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image011.png]]
552 +
553 +1. Select burn serial port and firmware package to complete the upgrade
554 +
555 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image012.png]]
556 +
557 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image013.png]]
558 +
559 +1. Install the battery to the node, and the upgrade will start at this time
560 +
561 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image014.png]]
562 +
563 +1. The following screenshot appears, indicating that the upgrade has been successful
564 +
565 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image015.png]]
566 +
567 +
568 +1. Order Info
569 +
570 +Part Number: **NDS01**
571 +
572 +1. Packing Info
573 +
574 +
575 +**Package Includes**:
576 +
577 +* NDS01 NB-IoT Door Sensor
578 +
579 +
580 +**Dimension and weight**:
581 +
582 +* Device Size:
583 +* Device Weight:
584 +* Package Size / pcs :
585 +* Weight / pcs :

Applications

Navigation

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