Last modified by Mengting Qiu on 2024/04/02 17:03
<
From version < 52.8 >
edited by Xiaoling
on 2022/11/17 10:52
To version < 48.2 >
edited by Xiaoling
on 2022/10/24 15:43
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -NDS03A - Outdoor NB-IoT Open/Close Door Sensor User Manual
1 +CPN01- NB-IoT Outdoor Open/Close Dry Contact Sensor User Manual
Content
... ... @@ -17,28 +17,18 @@
17 17  == 1.1 ​ What is CPN01 NB-IoT Pulse/Contact Sensor ==
18 18  
19 19  
20 -(((
21 21  The Dragino CPN01 is an (% style="color:blue" %)**NB-IoT Dry Contact Sensor**(%%). It detects open/close status and uplinks the info to IoT server via NB-IoT network. User can see the (% style="color:blue" %)**dry contact status, open time, and open counts**(%%) in the IoT Server.
22 -)))
23 23  
24 -(((
25 25  The CPN01 will send periodically data every day as well as for each dry contact action. It also counts the contact open times and calculates the last open duration. Users can also disable the uplink for each Open/Close event, instead, device can count each open event and uplink periodically.
26 -)))
27 27  
28 -(((
29 29  CPN01 has** (% style="color:blue" %)Open-Alarm feature(%%)**, user can set this feature so CPN01 will send an alarm if the contact has been open exceeds a certain time.
30 -)))
31 31  
32 -(((
33 33  CPN01 is designed for outdoor use. It has a weatherproof enclosure and industrial-level battery to work in low to high temperatures.
34 -)))
35 35  
36 -(((
37 37  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.
38 38  \\CPN01 supports different uplink methods including (% style="color:blue" %)**TCP, MQTT, UDP, and CoAP**(%%) for different application requirements.
39 39  \\CPN01 is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), It is designed for long-term use of up to 5 years. (Actually Battery life depends on the use environment, update period & uplink method)
40 40  \\To use CPN01, user needs to check if there is NB-IoT coverage in the field and with the Nb-IoT bands that CPN01 supports. If local operator support it, user needs to get a (% style="color:blue" %)**NB-IoT SIM card**(%%) from the operator and install into CPN01 to get NB-IoT network connection.
41 -)))
42 42  
43 43  ​
44 44  
... ... @@ -61,8 +61,6 @@
61 61  * Micro SIM card slot for NB-IoT SIM
62 62  * 8500mAh Battery for long-term use
63 63  
64 -
65 -
66 66  == 1.3  Specification ==
67 67  
68 68  
... ... @@ -80,8 +80,6 @@
80 80  * - B20 @H-FDD: 800MHz
81 81  * - B28 @H-FDD: 700MHz
82 82  
83 -
84 -
85 85  == 1.4  Installation ==
86 86  
87 87  
... ... @@ -89,7 +89,6 @@
89 89  
90 90  [[image:image-20221021110329-1.png]]
91 91  
92 -
93 93  [[image:image-20221022234602-2.png||height="288" width="922"]]
94 94  
95 95  
... ... @@ -101,8 +101,6 @@
101 101  * Pulse meter application
102 102  * Dry Contact Detection
103 103  
104 -
105 -
106 106  == 1.6  Mechanical ==
107 107  
108 108  
... ... @@ -112,7 +112,6 @@
112 112  
113 113  == 1.7  Pin Definitions and Switch ==
114 114  
115 -
116 116  [[image:image-20221021110429-4.png]]
117 117  
118 118  
... ... @@ -133,9 +133,9 @@
133 133  === 1.7.3  BOOT MODE / SW1 ===
134 134  
135 135  
136 -1)  ISP:  upgrade mode, device won't have any signal in this mode. but ready for upgrade firmware. LED won't work. The firmware won't run.
118 +1) ISP:  upgrade mode, device won't have any signal in this mode. but ready for upgrade firmware. LED won't work. The firmware won't run.
137 137  
138 -2)  Flash:  working mode, the device starts to work for NB-IoT connection and sends out console output for further debugging.
120 +2) Flash:  working mode, the device starts to work for NB-IoT connection and sends out console output for further debugging.
139 139  
140 140  
141 141  
... ... @@ -246,12 +246,13 @@
246 246  
247 247  (% style="color:blue" %)**Use below commands in CPN01:**
248 248  
249 -* (% style="color:#037691" %)**AT+PRO=1**                (%%) ~/~/ Set to use CoAP protocol to uplink
231 +(% style="color:#037691" %)**AT+PRO=1**                (%%) ~/~/ Set to use CoAP protocol to uplink
250 250  
251 -* (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,5683   ** (%%) ~/~/ Set CoAP server address and port
233 +(% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,5683   ** (%%) ~/~/ Set CoAP server address and port
252 252  
253 -* (% style="color:#037691" %)**AT+URI=0,0,11,2,"mqtt" ** (%%) ~/~/  Set CoAP resource path
235 +(% style="color:#037691" %)**AT+URI=0,0,11,2,"mqtt" ** (%%) ~/~/  Set CoAP resource path
254 254  
237 +
255 255  For parameter description, please refer to AT command set
256 256  
257 257  [[image:image-20221021110948-8.png]]
... ... @@ -268,15 +268,14 @@
268 268  
269 269  (% style="color:blue" %)**AT Commands:**
270 270  
271 -* (% style="color:#037691" %)**AT+PRO=2   ** (%%) ~/~/  Set to use UDP protocol to uplink
254 +* (% style="color:#037691" %)**AT+PRO=2   ** (%%) ~/~/ Set to use UDP protocol to uplink
272 272  
273 -* (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,5601   ** (%%) ~/~/  Set UDP server address and port
256 +* (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,5601   ** (%%) ~/~/ Set UDP server address and port
274 274  
275 -* (% style="color:#037691" %)**AT+CFM=1       ** (%%) ~/~/  If the server does not respond, this command is unnecessary
258 +* (% style="color:#037691" %)**AT+CFM=1       ** (%%) ~/~/If the server does not respond, this command is unnecessary
276 276  
277 277  ​ [[image:image-20221021111025-10.png]]
278 278  
279 -
280 280  [[image:image-20221021111033-11.png||height="241" width="576"]]
281 281  
282 282  ​
... ... @@ -287,23 +287,22 @@
287 287  
288 288  (% style="color:blue" %)**AT Commands:**
289 289  
290 -* (% style="color:#037691" %)**AT+PRO=3   ** (%%) ~/~/  Set to use MQTT protocol to uplink
272 +* (% style="color:#037691" %)**AT+PRO=3   ** (%%) ~/~/Set to use MQTT protocol to uplink
291 291  
292 -* (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,1883   ** (%%) ~/~/  Set MQTT server address and port
274 +* (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,1883   ** (%%) ~/~/Set MQTT server address and port
293 293  
294 -* (% style="color:#037691" %)**AT+CLIENT=CLIENT       ** (%%) ~/~/  Set up the CLIENT of MQTT
276 +* (% style="color:#037691" %)**AT+CLIENT=CLIENT       ** (%%) ~/~/Set up the CLIENT of MQTT
295 295  
296 -* (% style="color:#037691" %)**AT+UNAME=UNAME                     **(%%)** **~/~/  Set the username of MQTT
278 +* (% style="color:#037691" %)**AT+UNAME=UNAME                     **(%%)** **~/~/Set the username of MQTT
297 297  
298 -* (% style="color:#037691" %)**AT+PWD=PWD                         **(%%)** **~/~/  Set the password of MQTT
280 +* (% style="color:#037691" %)**AT+PWD=PWD                         **(%%)** **~/~/Set the password of MQTT
299 299  
300 -* (% style="color:#037691" %)**AT+PUBTOPIC=NSE01_PUB              **(%%)** **~/~/  Set the sending topic of MQTT
282 +* (% style="color:#037691" %)**AT+PUBTOPIC=NSE01_PUB              **(%%)** **~/~/Set the sending topic of MQTT
301 301  
302 -* (% style="color:#037691" %)**AT+SUBTOPIC=NSE01_SUB          ** (%%) ~/~/  Set the subscription topic of MQTT
284 +* (% style="color:#037691" %)**AT+SUBTOPIC=NSE01_SUB          ** (%%) ~/~/Set the subscription topic of MQTT
303 303  
304 304  ​ [[image:image-20221021111058-12.png]]
305 305  
306 -
307 307  [[image:image-20221021111201-16.png||height="472" width="653"]]
308 308  
309 309  ​
... ... @@ -311,15 +311,14 @@
311 311  MQTT protocol has a much higher power consumption compare with UDP / CoAP protocol. Please check the power analyze document and adjust the uplink period to a suitable interval.
312 312  
313 313  
314 -
315 315  === 2.2.7 Use TCP protocol to uplink data ===
316 316  
317 317  
318 -(% style="color:blue" %)**AT Commands:**
298 +(% style="color:blue" %)**AT Commands**
319 319  
320 -* (% style="color:#037691" %)**AT+PRO=4   ** (%%) ~/~/  Set to use TCP protocol to uplink
300 +* (% style="color:#037691" %)**AT+PRO=4   ** (%%) ~/~/ Set to use TCP protocol to uplink
321 321  
322 -* (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,5600   ** (%%) ~/~/  Set TCP server address and port
302 +* (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,5600   ** (%%) ~/~/ Set TCP server address and port
323 323  
324 324  ​ [[image:image-20221021111125-14.png]]
325 325  
... ... @@ -327,7 +327,6 @@
327 327  
328 328  ​
329 329  
330 -
331 331  === 2.2.8 Change Update Interval ===
332 332  
333 333  
... ... @@ -337,10 +337,10 @@
337 337  
338 338  (% style="color:red" %)**NOTE:**
339 339  
340 -1.  By default, the device will send an uplink message every 1 hour.
319 +*
320 +**
321 +**1. By default, the device will send an uplink message every 1 hour.
341 341  
342 -
343 -
344 344  == 2.3  Uplink Payload ==
345 345  
346 346  
... ... @@ -348,53 +348,51 @@
348 348  
349 349  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.
350 350  
330 +|**Size(bytes)**|**8**|**2**|**2**|**1**|**1**|**1**|**1**|**1**|**3**
331 +|**Value**|[[Device ID>>path:#H2.4.1A0A0DeviceID]]|[[Ver>>path:#H2.4.2A0VersionInfo]]|[[BAT>>path:#H2.4.3A0BatteryInfo]]|[[Signal Strength>>path:#H2.4.4A0SignalStrength]]|MOD|[[ Calculate Flag>>path:#H2.4.8A0DigitalInterrupt]]|Contact Status|Alarm|Total pulse
351 351  
352 -(% border="1.5" style="background-color:#ffffcc; color:green; width:510px" %)
353 -|=(% scope="row" style="width: 60px;" %)**Size(bytes)**|(% style="width:40px" %)**8**|(% style="width:20px" %)**2**|(% style="width:20px" %)**2**|(% style="width:80px" %)**1**|(% style="width:40px" %)**1**|(% style="width:80px" %)**1**|(% style="width:80px" %)**1**|(% style="width:40px" %)**1**|(% style="width:60px" %)**3**
354 -|=(% style="width: 96px;" %)**Value**|(% style="width:84px" %)[[Device ID>>||anchor="H2.4.1A0A0DeviceID"]]|(% style="width:40px" %)[[Ver>>||anchor="H2.4.2A0VersionInfo"]]|(% style="width:44px" %)[[BAT>>||anchor="H2.4.3A0BatteryInfo"]]|(% style="width:121px" %)[[Signal Strength>>||anchor="H2.4.4A0SignalStrength"]]|(% style="width:52px" %)MOD|(% style="width:84px" %)[[ Calculate Flag>>||anchor="H2.4.5A0CalculateFlag"]]|(% style="width:116px" %)[[Contact Status>>||anchor="H2.4.7A0ContactStatus"]]|(% style="width:57px" %)[[Alarm>>||anchor="H2.4.6A0Alarm"]]|(% style="width:91px" %)[[Total pulse>>||anchor="H2.4.8A0Totalpulse"]]
333 +(% style="width:1201px" %)
334 +|**3**|**4**|**1**|**3**|**1**|**3**|4|**8 group**|(% style="width:1px" %)
335 +|The last open duration|Time stamp|Contact Status|Total pulse|Calculate Flag|The last open duration|Time stamp|...|(% style="width:1px" %)
355 355  
356 -(% border="1.5" style="background-color:#ffffcc; color:green; width:490px" %)
357 -|(% style="width:100px" %)**3**|(% style="width:50px" %)**4**|(% style="width:70px" %)**1**|(% style="width:50px" %)**3**|(% style="width:100px" %)**3**|(% style="width:80px" %)4|(% style="width:50px" %)**8 group**
358 -|(% style="width:176px" %)[[The last open duration>>||anchor="H2.4.9A0Thelastopenduration"]]|(% style="width:98px" %)[[Time stamp>>||anchor="H2.4.10A0Timestamp"]]|(% style="width:115px" %)Contact Status|(% style="width:92px" %)Total pulse|(% style="width:169px" %)The last open duration|(% style="width:97px" %)Time stamp|(% style="width:74px" %)...
359 -
360 360  If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the CPN01 uplink data.
361 361  
362 362  [[image:image-20221021111201-16.png||height="572" width="792"]]
363 363  
364 -
365 365  The payload is ASCII string, representative same HEX:
366 366  
367 -**0x (% style="color:red" %)__f867787050213317__  (% style="color:blue" %)__0064__ (% style="color:green" %) __0c78__(% style="color:#00b0f0" %) __17__(% style="color:#7030a0" %) __01__(% style="color:#0020b0" %) __00__ (% style="color:#420042" %)__00__ (% style="color:#660066" %)__00__ (% style="color:#aaaa40" %)__000009__(% style="color:#663300" %) __000002__ (% style="color:#d60093" %)__6315537b__ (% style="color:#660066" %)__01 00000b 02 0000026 63510fed__ (%%)__0100000e0200000263510f39__ __010000000000000063510e85__ __010000000000000063510d2e__ __010000000000000063510c7a__ __010000000000000063510bc6__ __010000000000000063510954__ __010000000000000063510882 __**
343 +**0x (% style="color:red" %)f867787050213317  (% style="color:blue" %)0064 (% style="color:green" %) 0c78(% style="color:#00b0f0" %) 17(% style="color:#7030a0" %) 01(% style="color:#0020b0" %) 00 (% style="color:#420042" %)00 (% style="color:#660066" %)00 (% style="color:#aaaa40" %)09(% style="color:#663300" %) 02 (% style="color:#d60093" %)6315537b (% style="color:#660066" %)__01 00000b 02 0000026 63510fed__ (%%)__0100000e0200000263510f39__ __010000000000000063510e85__ __010000000000000063510d2e__ __010000000000000063510c7a__ __010000000000000063510bc6__ __010000000000000063510954__ __010000000000000063510882 __**
368 368  
369 369  **where:**
370 370  
371 -* (% style="color:#037691" %)**Device ID:**(%%) 0x f867787050213317 = f867787050213317
347 +(% style="color:#037691" %) **Device ID:**(%%) 0x f867787050213317 = f867787050213317
372 372  
373 -* (% style="color:#037691" %)**Version:**(%%) 0x0064=100=1.0.0
349 +(% style="color:#037691" %) **Version:**(%%) 0x0064=100=1.0.0
374 374  
375 -* (% style="color:#037691" %)**BAT :**(%%) 0x0c78 = 3192 mV = 3.192V
351 +(% style="color:#037691" %) **BAT:**(%%) 0x0c78 = 3192 mV = 3.192V
376 376  
377 -* (% style="color:#037691" %)**Singal: **(%%)0x17 = 23
353 +(% style="color:#037691" %) **Singal: **(%%)0x17 = 23
378 378  
379 -* (% style="color:#037691" %)**Mod:**(%%) 0x01 = 1
355 +(% style="color:#037691" %) **Mod:**(%%) 0x01 = 1
380 380  
381 -* (% style="color:#037691" %)**Calculate Flag:**(%%) 0x00=0
357 +(% style="color:#037691" %) **Calculate Flag:**(%%) 0x00=0
382 382  
383 -* (% style="color:#037691" %)**Contact Status:**(%%) 0x00=0
359 +(% style="color:#037691" %) **Contact Status:**(%%) 0x00=0
384 384  
385 -* (% style="color:#037691" %)**Alarm: **(%%)0x00 =0
361 +(% style="color:#037691" %) **Alarm: **(%%)0x00 =0
386 386  
387 -* (% style="color:#037691" %)**Total pulse: **(%%)0x000009 =9
363 +(% style="color:#037691" %) **Total pulse: **(%%)0x09 =0
388 388  
389 -* (% style="color:#037691" %)**The last open duration: **(%%)0x000002 =2
365 +(% style="color:#037691" %) **The last open duration: **(%%)0x02 =2
390 390  
391 -* (% style="color:#037691" %)**Timestamp:**(%%) 0x6315537b =1662342011 (Unix Time)
367 +(% style="color:#037691" %)** Time stamp :**(%%) 0x6315537b =1662342011 (Unix Time)
392 392  
393 -* (% style="color:#037691" %)**Contact Status, Total pulse,The last open duration ,Time stamp :**(%%) 01  00000b  000026  63510fed
369 +(% style="color:#037691" %) **Contact Status, Total pulse, Calculate Flag, The last open duration ,Time stamp :**(%%) 01  00000b  02  000026  63510fed
394 394  
395 -* (% style="color:#037691" %)**8 sets of recorded data: Contact Status, Total pulse, The last open duration ,Time stamp :**(%%) 0100000e00002663510f39,.......
371 +(% style="color:#037691" %)**8 sets of recorded data: Contact Status, Total pulse, Calculate Flag, The last open duration ,Time stamp :**(%%) 0100000e0200002663510f39,.......
396 396  
397 397  
374 +
398 398  == 2.4  Payload Explanation and Sensor Interface ==
399 399  
400 400  
... ... @@ -468,7 +468,7 @@
468 468  === 2.4.6  Alarm ===
469 469  
470 470  
471 -See [[Alarm Base on Timeout>>||anchor="H2.7A0AlarmBaseonTimeout"]]
448 +See [[Alarm Base on Timeout>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/CPL01%20LoRaWAN%20Outdoor%20PulseContact%20%20Sensor%20Manual/#H3.5AlarmBaseonTimeout]]
472 472  
473 473  
474 474  
... ... @@ -484,7 +484,7 @@
484 484  === 2.4.8  Total pulse ===
485 485  
486 486  
487 -Total pulse/counting based on dry [[contact trigger event>>||anchor="H2.12Setcountnumber"]]
464 +Total pulse/counting based on dry [[contact trigger event>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/CPL01%20LoRaWAN%20Outdoor%20PulseContact%20%20Sensor%20Manual/#H2.3.2SensorConfiguration2CFPORT3D4]]
488 488  
489 489  Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215
490 490  
... ... @@ -548,7 +548,6 @@
548 548  * After CPN01 join NB-IoT network. The LED will be ON for 3 seconds.
549 549  * For each uplink probe, LED will be on for 500ms.
550 550  
551 -
552 552  == 2.7  Alarm Base on Timeout ==
553 553  
554 554  
... ... @@ -661,9 +661,9 @@
661 661  == 2.15  ​Firmware Change Log ==
662 662  
663 663  
664 -Download URL & Firmware Change log:  [[https:~~/~~/www.dropbox.com/sh/8p5nuvo6gh7je4n/AAAMP7MMusgbXMz9Ik7Ls03Ga?dl=0>>https://www.dropbox.com/sh/8p5nuvo6gh7je4n/AAAMP7MMusgbXMz9Ik7Ls03Ga?dl=0]]
640 +Download URL & Firmware Change log: [[https:~~/~~/www.dropbox.com/sh/1zmcakvbkf24f8x/AACmq2dZ3iRB9F1nVWeEB9Moa?dl=0>>url:https://www.dropbox.com/sh/1zmcakvbkf24f8x/AACmq2dZ3iRB9F1nVWeEB9Moa?dl=0]]
665 665  
666 -Upgrade Instruction: [[Upgrade Firmware>>||anchor="H5.1200BHowtoUpgradeFirmware"]]
642 +Upgrade Instruction: [[Upgrade Firmware>>path:#H5.1200BHowtoUpgradeFirmware]]
667 667  
668 668  
669 669  
... ... @@ -877,8 +877,6 @@
877 877  * Size: 195 x 125 x 55 mm
878 878  * Weight:   420g
879 879  
880 -
881 -
882 882  = 9.  Support =
883 883  
884 884  

Applications

Navigation

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