Version 48.8 by Xiaoling on 2022/10/24 16:12
Show last authors
1 (% style="text-align:center" %)
2 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/CPL01%20LoRaWAN%20Outdoor%20PulseContact%20%20Sensor%20Manual/WebHome/1652856952171-363.png?rev=1.1||alt="1652856952171-363.png" height="578" width="588"]]
3
4
5
6 **Table of Contents：**
7
8 {{toc/}}
9
10
11
12
13
14 = 1.  Introduction =
15
16
17 == 1.1 ​ What is CPN01 NB-IoT Pulse/Contact Sensor ==
18
19
20 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.
21
22 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.
23
24 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.
25
26 CPN01 is designed for outdoor use. It has a weatherproof enclosure and industrial-level battery to work in low to high temperatures.
27
28 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.
29 \\CPN01 supports different uplink methods including (% style="color:blue" %)**TCP, MQTT, UDP, and CoAP**(%%) for different application requirements.
30 \\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)
31 \\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.
32
33 ​
34
35
36 == ​1.2  Features ==
37
38
39 * NB-IoT Bands: B1/B3/B8/B5/B20/B28 @H-FDD
40 * Open/Close detect
41 * Open/Close statistics
42 * Monitor Battery Level
43 * Uplink on periodically and open/close event
44 * Datalog feature
45 * Uplink periodically
46 * Downlink to change configure
47 * Wall Mountable
48 * Outdoor Use
49 * Ultra-Low Power consumption
50 * AT Commands to change parameters
51 * Micro SIM card slot for NB-IoT SIM
52 * 8500mAh Battery for long-term use
53
54
55
56 == 1.3  Specification ==
57
58
59 (% style="color:blue" %)**Common DC Characteristics:**
60
61 * Supply Voltage: 2.1v ~~ 3.6v
62 * Operating Temperature: -40 ~~ 85°C
63
64 (% style="color:blue" %)**NB-IoT Spec:**
65
66 * - B1 @H-FDD: 2100MHz
67 * - B3 @H-FDD: 1800MHz
68 * - B8 @H-FDD: 900MHz
69 * - B5 @H-FDD: 850MHz
70 * - B20 @H-FDD: 800MHz
71 * - B28 @H-FDD: 700MHz
72
73
74
75 == 1.4  Installation ==
76
77
78 Connect CPN01 to an Open Close sensor like below. So it can detect the Open/Close event.
79
80 [[image:image-20221021110329-1.png]]
81
82 [[image:image-20221022234602-2.png||height="288" width="922"]]
83
84
85
86 == 1.5 ​ Applications ==
87
88
89 * Open/Close Detection
90 * Pulse meter application
91 * Dry Contact Detection
92
93
94
95 == 1.6  Mechanical ==
96
97
98 ​[[image:image-20221021110415-3.png]]
99
100
101
102 == 1.7  Pin Definitions and Switch ==
103
104 [[image:image-20221021110429-4.png]]
105
106
107 === 1.7.1  Pin Definition ===
108
109
110 CPN01 is pre-configured to connect to two external wires. The other pins are not used. If user wants to know more about other pins, please refer to the **[[LSN50v2 User Manual>>doc:Main.User Manual for LoRaWAN End Nodes.LSN50 & LSN50-V2 - LoRaWAN Sensor Node User Manual.WebHome]]**.
111
112
113
114 === 1.7.2  Jumper JP2(Power ON/OFF) ===
115
116
117 Power on Device when putting this jumper.
118
119
120
121 === 1.7.3  BOOT MODE / SW1 ===
122
123
124 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.
125
126 2)  Flash:  working mode, the device starts to work for NB-IoT connection and sends out console output for further debugging.
127
128
129
130 === 1.7.4  Reset Button ===
131
132
133 Press to reboot the device.
134
135
136
137 === 1.7.5  LED ===
138
139
140 The LED will blink when :
141
142 1.  Boot the device in flash mode
143
144 2.  Send an uplink packet
145
146
147
148 = 2.  Use CPN01 to communicate with IoT Server =
149
150
151 == 2.1  How it works ==
152
153
154 The CPN01 is equipped with an NB-IoT module, the pre-loaded firmware in CPN01 will get (% style="color:blue" %)**Open/Close Event or Count**(%%) from sensor and send the value to the NB-IoT network. The NB-IoT network will forward this value to IoT server via the protocol defined by CPN01.
155
156 The diagram below shows the working flow in the default firmware of CPN01:
157
158 [[image:image-20221021110615-5.png]]
159
160
161
162 == 2.2 ​ Configure CPN01 ==
163
164
165 === 2.2.1 Test Requirement ===
166
167
168 To use CPN01 in your city, make sure to meet below requirements:
169
170 * Your local operator has already distributed an NB-IoT Network.
171 * The local NB-IoT network used the band that CPN01 supports.
172 * Your operator is able to distribute the data received in their NB-IoT network to your IoT server.
173
174 Below figure shows our testing structure. Here we have NB-IoT network coverage by China Mobile, the band they use is B8.  The CPN01 will use** (% style="color:red" %)CoAP(120.24.4.116:5683)(%%)** or raw (% style="color:red" %)**UDP(120.24.4.116:5601) **(%%)or (% style="color:red" %)**MQTT(120.24.4.116:1883) **(%%)or (% style="color:red" %)**TCP(120.24.4.116:5600)protocol**(%%) to send data to the test server.
175
176 [[image:image-20221023000439-3.png]]
177
178 ​
179
180
181 === 2.2.2 Insert NB-IoT SIM card ===
182
183
184 Insert the NB-IoT Card get from your provider.
185
186 User needs to take out the NB-IoT module and insert the SIM card like below:
187
188 [[image:image-20221021110745-6.png]] ​
189
190
191
192 === 2.2.3 Connect USB – TTL to CPN01 and configure it ===
193
194
195 User need to configure CPN01 via serial port to set the (% style="color:red" %)**Server Address** / **Uplink Topic**(%%) to define where and how-to uplink packets. CPN01 support AT Commands, user can use a USB to TTL adapter to connect to CPN01 and use AT Commands to configure it, as below.
196
197 (% style="color:blue" %)**Connection:**
198
199 (% style="background-color:yellow" %)** USB TTL GND <~-~-~-~-> GND**
200
201 (% style="background-color:yellow" %)** USB TTL TXD <~-~-~-~-> UART_RXD**
202
203 (% style="background-color:yellow" %)** USB TTL RXD <~-~-~-~-> UART_TXD**
204
205
206 In the PC, use below serial tool settings:
207
208 * Baud:  (% style="color:red" %)**9600**
209
210 * Data bits:** (% style="color:red" %)8(%%)**
211
212 * Stop bits: (% style="color:red" %)**1**
213
214 * Parity:  (% style="color:red" %)**None**
215
216 * Flow Control: (% style="color:red" %)**None**
217
218 Make sure the switch is in FLASH position, then power on CPN01 by connecting the (% style="color:orange" %)**Yellow Jumper**(%%).
219
220 ​[[image:image-20221021110817-7.png]]
221
222 CPN01 will output system info once powered on as below, we can enter the **password: 12345678** to access AT Command input.
223
224
225 (% style="color:red" %)**Note: the valid AT Commands can be found at:  **(%%)[[**https:~~/~~/www.dropbox.com/sh/351dwor6joz8nwh/AADn1BQaAAxLF_QMyU8NkW47a?dl=0**>>url:https://www.dropbox.com/sh/351dwor6joz8nwh/AADn1BQaAAxLF_QMyU8NkW47a?dl=0]]
226
227
228
229 === 2.2.4 Use CoAP protocol to uplink data ===
230
231
232 (% style="color:red" %)**Note: if you don't have a CoAP server, you can refer this link to set up a CoAP server: **(%%)[[**http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Set%20up%20CoAP%20Server/**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Set%20up%20CoAP%20Server/]]
233
234
235 (% style="color:blue" %)**Use below commands in CPN01:**
236
237 * (% style="color:#037691" %)**AT+PRO=1**                (%%) ~/~/ Set to use CoAP protocol to uplink
238
239 * (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,5683   ** (%%) ~/~/ Set CoAP server address and port
240
241 * (% style="color:#037691" %)**AT+URI=0,0,11,2,"mqtt" ** (%%) ~/~/  Set CoAP resource path
242
243 For parameter description, please refer to AT command set
244
245 [[image:image-20221021110948-8.png]]
246
247
248 After configuring the server address and (% style="color:green" %)**reset CPN01**(%%) (via AT+ATZ ), CPN01 will start to uplink sensor values to the CoAP server.
249
250 [[image:image-20221021110956-9.png]] ​
251
252
253
254 === 2.2.5 Use UDP protocol to uplink data(Default protocol) ===
255
256
257 (% style="color:blue" %)**AT Commands:**
258
259 * (% style="color:#037691" %)**AT+PRO=2   ** (%%) ~/~/  Set to use UDP protocol to uplink
260
261 * (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,5601   ** (%%) ~/~/  Set UDP server address and port
262
263 * (% style="color:#037691" %)**AT+CFM=1       ** (%%) ~/~/  If the server does not respond, this command is unnecessary
264
265 ​ [[image:image-20221021111025-10.png]]
266
267
268 [[image:image-20221021111033-11.png||height="241" width="576"]]
269
270 ​
271
272
273 === 2.2.6 Use MQTT protocol to uplink data ===
274
275
276 (% style="color:blue" %)**AT Commands:**
277
278 * (% style="color:#037691" %)**AT+PRO=3   ** (%%) ~/~/  Set to use MQTT protocol to uplink
279
280 * (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,1883   ** (%%) ~/~/  Set MQTT server address and port
281
282 * (% style="color:#037691" %)**AT+CLIENT=CLIENT       ** (%%) ~/~/  Set up the CLIENT of MQTT
283
284 * (% style="color:#037691" %)**AT+UNAME=UNAME                     **(%%)** **~/~/  Set the username of MQTT
285
286 * (% style="color:#037691" %)**AT+PWD=PWD                         **(%%)** **~/~/  Set the password of MQTT
287
288 * (% style="color:#037691" %)**AT+PUBTOPIC=NSE01_PUB              **(%%)** **~/~/  Set the sending topic of MQTT
289
290 * (% style="color:#037691" %)**AT+SUBTOPIC=NSE01_SUB          ** (%%) ~/~/  Set the subscription topic of MQTT
291
292 ​ [[image:image-20221021111058-12.png]]
293
294
295 [[image:image-20221021111201-16.png||height="472" width="653"]]
296
297 ​
298
299 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.
300
301
302
303 === 2.2.7 Use TCP protocol to uplink data ===
304
305
306 (% style="color:blue" %)**AT Commands:**
307
308 * (% style="color:#037691" %)**AT+PRO=4   ** (%%) ~/~/  Set to use TCP protocol to uplink
309
310 * (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,5600   ** (%%) ~/~/  Set TCP server address and port
311
312 ​ [[image:image-20221021111125-14.png]]
313
314 [[image:image-20221021111131-15.png]]
315
316 ​
317
318
319 === 2.2.8 Change Update Interval ===
320
321
322 User can use below command to change the (% style="color:blue" %)**uplink interval**.
323
324 * (% style="color:#037691" %)**AT+TDC=7200      ** (%%) ~/~/ Set Update Interval to 7200s (2 hours)
325
326 (% style="color:red" %)**NOTE:**
327
328 1.  By default, the device will send an uplink message every 1 hour.
329
330
331
332 == 2.3  Uplink Payload ==
333
334
335 The uplink payload includes 123 bytes in total by default.
336
337 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.
338
339
340 (% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:510px" %)
341 |=(% scope="row" style="width: 96px;" %)**Size(bytes)**|(% style="width:84px" %)**8**|(% style="width:40px" %)**2**|(% style="width:44px" %)**2**|(% style="width:121px" %)**1**|(% style="width:52px" %)**1**|(% style="width:84px" %)**1**|(% style="width:116px" %)**1**|(% style="width:57px" %)**1**|(% style="width:91px" %)**3**
342 |=(% 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"]]
343
344 (% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:510px" %)
345 |(% style="width:176px" %)**3**|(% style="width:98px" %)**4**|(% style="width:115px" %)**1**|(% style="width:92px" %)**3**|(% style="width:110px" %)**1**|(% style="width:169px" %)**3**|(% style="width:97px" %)4|(% style="width:74px" %)**8 group**
346 |(% 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:110px" %)Calculate Flag|(% style="width:169px" %)The last open duration|(% style="width:97px" %)Time stamp|(% style="width:74px" %)...
347
348 If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the CPN01 uplink data.
349
350 [[image:image-20221021111201-16.png||height="572" width="792"]]
351
352
353 The payload is ASCII string, representative same HEX:
354
355 **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 __**
356
357 **where:**
358
359 (% style="color:#037691" %) **Device ID:**(%%) 0x f867787050213317 = f867787050213317
360
361 (% style="color:#037691" %) **Version:**(%%) 0x0064=100=1.0.0
362
363 (% style="color:#037691" %) **BAT:**(%%) 0x0c78 = 3192 mV = 3.192V
364
365 (% style="color:#037691" %) **Singal: **(%%)0x17 = 23
366
367 (% style="color:#037691" %) **Mod:**(%%) 0x01 = 1
368
369 (% style="color:#037691" %) **Calculate Flag:**(%%) 0x00=0
370
371 (% style="color:#037691" %) **Contact Status:**(%%) 0x00=0
372
373 (% style="color:#037691" %) **Alarm: **(%%)0x00 =0
374
375 (% style="color:#037691" %) **Total pulse: **(%%)0x09 =0
376
377 (% style="color:#037691" %) **The last open duration: **(%%)0x02 =2
378
379 (% style="color:#037691" %)** Time stamp :**(%%) 0x6315537b =1662342011 (Unix Time)
380
381 (% style="color:#037691" %) **Contact Status, Total pulse, Calculate Flag, The last open duration ,Time stamp :**(%%) 01  00000b  02  000026  63510fed
382
383 (% style="color:#037691" %)**8 sets of recorded data: Contact Status, Total pulse, Calculate Flag, The last open duration ,Time stamp :**(%%) 0100000e0200002663510f39,.......
384
385
386
387 == 2.4  Payload Explanation and Sensor Interface ==
388
389
390 === 2.4.1  Device ID ===
391
392
393 By default, the Device ID is equal to the last 15 bits of IMEI.
394
395 User can use (% style="color:blue" %)**AT+DEUI** (%%)to set Device ID
396
397 **Example:**
398
399 AT+DEUI=868411056754138
400
401 The Device ID is stored in a non-erase area, Upgrade the firmware or run AT+FDR won't erase the Device ID.
402
403
404
405 === 2.4.2  Version Info ===
406
407
408 Specify the software version: 0x64=100, which means firmware version 1.00.
409
410 For example 0x00 64 : This device is CPN01 with firmware version 1.0.0.
411
412
413
414 === 2.4.3  Battery Info ===
415
416
417 Check the battery voltage for CPN01.
418
419 Ex1: 0x0B45 = 2885mV
420
421 Ex2: 0x0B49 = 2889mV
422
423
424
425 === 2.4.4  Signal Strength ===
426
427
428 NB-IoT Network signal Strength.
429
430 **Ex1: 0x1d = 29**
431
432 **0**  -113dBm or less
433
434 **1**  -111dBm
435
436 **2...30** -109dBm... -53dBm
437
438 **31**   -51dBm or greater
439
440 **99**    Not known or not detectable
441
442
443
444 === 2.4.5  Calculate Flag ===
445
446
447 The calculate flag is a user defined field, IoT server can use this filed to handle different meters with different pulse factors. For example, if there are 100 water meters, meter 1~~50 are 1 liter/pulse and meter 51 ~~ 100 has 1.5 liter/pulse.
448
449 User can set calculate flag to 1 for meter 1~~50 and 2 for meter 51 ~~ 100, So IoT Server can use this field for calculation.
450
451 Default value: 0. 
452
453 Range (6 bits): (b)000000 ~~ (b) 111111
454
455
456
457 === 2.4.6  Alarm ===
458
459
460 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]]
461
462
463
464 === 2.4.7  Contact Status ===
465
466
467 0: Open
468
469 1: Close
470
471
472
473 === 2.4.8  Total pulse ===
474
475
476 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]]
477
478 Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215
479
480
481
482 === 2.4.9  The last open duration ===
483
484
485 Dry Contact last open duration.
486
487 Unit: min.
488
489 [[image:image-20221021111346-17.png||height="146" width="770"]]
490
491
492
493 === 2.4.10  Timestamp ===
494
495
496 Timestamp : 0x6315537b =1662342011
497
498 Convert Unix timestamp to time 2022-9-5 9:40:11.
499
500 **~ **
501
502
503 == 2.5  Downlink Payload ==
504
505
506 By default, CPN01 prints the downlink payload to console port.
507
508 [[image:image-20221021111414-18.png]] ​
509
510
511 **Examples:**
512
513 * (% style="color:#037691" %)**Set TDC**
514
515 If the payload=0100003C, it means set the END Node's TDC to 0x00003C=60(S), while type code is 01.
516
517 Payload:    01 00 00 1E    TDC=30S
518
519 Payload:    01 00 00 3C    TDC=60S
520
521 * (% style="color:#037691" %)**Reset**
522
523 If payload = 0x04FF, it will reset the NSE01
524
525 * (% style="color:#037691" %)**INTMOD**
526
527 Downlink Payload: 06000003, Set AT+INTMOD=3
528
529
530
531 == 2.6  ​LED Indicator ==
532
533
534 The CPN01 has an internal LED which is to show the status of different states.
535
536 * When the device starts normally, the LED will light up for 1 second.
537 * After CPN01 join NB-IoT network. The LED will be ON for 3 seconds.
538 * For each uplink probe, LED will be on for 500ms.
539
540 == 2.7  Alarm Base on Timeout ==
541
542
543 CPN01 can monitor the timeout for a status change, this feature can be used to monitor some events such as door opening too long etc. Related Parameters are:
544
545
546 (% style="color:blue" %)**1. Keep Status: Status to be monitor**
547
548 Keep Status = 1: Monitor Close to Open event
549
550 Keep Status = 0: Monitor Open to Close event
551
552
553 (% style="color:blue" %)**2. Keep Time: Timeout to send an Alarm**
554
555 Range 0 ~~ 65535(0xFFFF) seconds.
556
557 If keep time = 0, Disable Alarm Base on Timeout feature.
558
559 If keep time > 0, device will monitor the keep status event and send an alarm when status doesn’t change after timeout.
560
561
562 (% style="color:blue" %)**AT Command to configure:**
563
564 (% style="color:#037691" %)**AT+TTRIG=1,30** (%%) **~-~->**  When the **Keep Status** change from connected to disconnect, and device remains in disconnect status for more than 30 seconds. CPN01 will send an uplink packet, the [[Alarm bit>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/CPL01%20LoRaWAN%20Outdoor%20PulseContact%20%20Sensor%20Manual/#H2.3.3Real-TimeOpen2FCloseStatus2CUplinkFPORT3D2]] (the second bit of 1^^st^^ byte of payload) on this uplink packet is set to 1.
565
566 (% style="color:#037691" %)**AT+TTRIG=0,0 ** (%%) **~-~->** Default Value, disable timeout Alarm.
567
568
569
570 == 2.8  Set debug mode ==
571
572
573 Feature: Enable or Disable debug mode
574
575 (% style="color:blue" %)**AT Command: AT+DEBUG**
576
577 [[image:image-20221021111629-21.png]]
578
579
580
581 == 2.9  Clear Flash Record ==
582
583
584 Feature: Clear flash storage for data log feature.
585
586 (% style="color:blue" %)**AT Command: AT+CLRDTA**
587
588 [[image:image-20221021111527-19.png]]
589
590
591
592 == 2.10  Set trigger mode ==
593
594
595 (% style="color:blue" %)**AT Command: AT+TTRMOD**
596
597 Feature: Set the trigger interrupt mode.
598
599 [[image:image-20221021111552-20.png]]
600
601
602
603 == 2.11  Set the calculate flag ==
604
605
606 Feature: Set the calculate flag
607
608 (% style="color:blue" %)**AT Command: AT+CALCFLAG**
609
610 [[image:image-20221021111711-22.png]]
611
612
613
614 == 2.12 Set count number ==
615
616
617 Feature: Manually set the count number
618
619 (% style="color:blue" %)**AT Command: AT+SETCNT**
620
621 [[image:image-20221021111748-24.png]]
622
623
624
625 == 2.13  Set the number of data to be uploaded and the recording time ==
626
627
628 (% style="color:blue" %)**AT Command:**
629
630 (% 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)
631
632 (% 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.
633
634
635
636 == 2.14  Read or Clear cached data ==
637
638
639 (% style="color:blue" %)**AT Command:**
640
641 (% style="color:#037691" %)**AT+CDP**  (%%) ~/~/ Read cached data
642
643 (% style="color:#037691" %)**AT+CDP=0**  (%%) ~/~/ Clear cached data ​
644
645 [[image:image-20221021111810-25.png||height="364" width="797"]]
646
647
648
649 == 2.15  ​Firmware Change Log ==
650
651
652 Download URL & Firmware Change log: [[https:~~/~~/www.dropbox.com/sh/1zmcakvbkf24f8x/AACmq2dZ3iRB9F1nVWeEB9Moa?dl=0>>url:https://www.dropbox.com/sh/1zmcakvbkf24f8x/AACmq2dZ3iRB9F1nVWeEB9Moa?dl=0]]
653
654 Upgrade Instruction: [[Upgrade Firmware>>path:#H5.1200BHowtoUpgradeFirmware]]
655
656
657
658 == 2.16  ​Battery Analysis ==
659
660
661 === 2.16.1  ​Battery Type ===
662
663
664 The CPN01 battery is a combination of an 8500mAh Li/SOCI2 Battery and a Super Capacitor. The battery is non-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.
665
666 The battery is designed to last for several years depends on the actual use environment and update interval. 
667
668 The battery-related documents as below:
669
670 * [[Battery Dimension>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
671
672 * [[Lithium-Thionyl Chloride Battery datasheet>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
673
674 * [[Lithium-ion Battery-Capacitor datasheet>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
675
676 [[image:image-20221021111911-26.png]] ​
677
678
679
680 === 2.16.2  Power consumption Analyze ===
681
682
683 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.
684
685 Instruction to use as below:
686
687 (% style="color:blue" %)**Step 1:  **(%%)Downlink the up-to-date DRAGINO_Battery_Life_Prediction_Table.xlsx from: [[https:~~/~~/www.dragino.com/downloads/index.php?dir=LoRa_End_Node/Battery_Analyze/>>url:https://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/Battery_Analyze/]]
688
689 (% style="color:blue" %)**Step 2: **(%%) Open it and choose
690
691 * Product Model
692
693 * Uplink Interval
694
695 * Working Mode
696
697 And the Life expectation in difference case will be shown on the right.
698
699 [[image:1666596205057-567.png]] ​
700
701
702
703 === 2.16.3  ​Battery Note ===
704
705
706 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.
707
708
709
710 === 2.16.4  Replace the battery ===
711
712
713 The default battery pack of CPN01 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).
714
715
716
717 = 3. ​ Access NB-IoT Module =
718
719
720 Users can directly access the AT command set of the NB-IoT module.
721
722 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/]] 
723
724 [[image:image-20221021112006-28.png]] ​
725
726
727
728 = 4.  Using the AT Commands =
729
730
731 == 4.1  Access AT Commands ==
732
733
734 See this link for detail:  [[https:~~/~~/www.dropbox.com/sh/351dwor6joz8nwh/AADn1BQaAAxLF_QMyU8NkW47a?dl=0>>url:https://www.dropbox.com/sh/351dwor6joz8nwh/AADn1BQaAAxLF_QMyU8NkW47a?dl=0]]
735
736 AT+<CMD>?  : Help on <CMD>
737
738 AT+<CMD>         : Run <CMD>
739
740 AT+<CMD>=<value> : Set the value
741
742 AT+<CMD>=?  : Get the value
743
744
745 (% style="color:blue" %)**General Commands**      
746
747 AT  : Attention       
748
749 AT?  : Short Help     
750
751 ATZ  : MCU Reset    
752
753 AT+TDC  : Application Data Transmission Interval
754
755 AT+CFG  : Print all configurations
756
757 AT+CFGMOD           : Working mode selection
758
759 AT+INTMOD            : Set the trigger interrupt mode
760
761 AT+5VT  : Set extend the time of 5V power  
762
763 AT+PRO  : Choose agreement
764
765 AT+RXDL  : Extend the sending and receiving time
766
767 AT+SERVADDR  : Server Address
768
769 AT+TR      :  Get or Set record time
770
771 AT+NOUD      : Get or Set the number of data to be uploaded
772
773 AT+CDP     :  Read or Clear cached data
774
775 AT+ DEBUG   : Enable or Disable debug mode
776
777 AT+ TTRIG   : Get or Set Alarm Base on Timeout
778
779 AT+ TTRMOD   : Get or Set the trigger interrupt mode(0:falling,1:rising)
780
781 AT+ CALCFLAG   : Get or Set the calculate flag
782
783 AT+ CLRC   : Clear current door open count
784
785
786 (% style="color:blue" %)**COAP Management**      
787
788 AT+URI            : Resource parameters
789
790
791 (% style="color:blue" %)**UDP Management**
792
793 AT+CFM          : Upload confirmation mode (only valid for UDP)
794
795
796 (% style="color:blue" %)**MQTT Management**
797
798 AT+CLIENT               : Get or Set MQTT client
799
800 AT+UNAME  : Get or Set MQTT Username
801
802 AT+PWD                  : Get or Set MQTT password
803
804 AT+PUBTOPIC  : Get or Set MQTT publish topic
805
806 AT+SUBTOPIC  : Get or Set MQTT subscription topic
807
808
809 (% style="color:blue" %)**Information**          
810
811 AT+FDR  : Factory Data Reset
812
813 AT+PWORD  : Serial Access Password
814
815
816
817 = ​5.  FAQ =
818
819
820 == 5.1 ​ How to Upgrade Firmware ==
821
822
823 User can upgrade the firmware for 1) bug fix, 2) new feature release.
824
825 Please see this link for how to upgrade:  [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/#H2.HardwareUpgradeMethodSupportList>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/#H2.HardwareUpgradeMethodSupportList]]
826
827 (% style="color:red" %)**Notice: **(% style="color:blue" %)**CPN01** (%%)**and (% style="color:blue" %)CPL01(%%)**(% style="color:blue" %) (%%)**share the same mother board. They use the same connection and method to update.**
828
829
830
831 = 6.  Trouble Shooting =
832
833
834 == 6.1  ​Connection problem when uploading firmware ==
835
836
837 (% style="color:blue" %)**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]]
838
839
840
841 == 6.2  AT Command input doesn't work ==
842
843
844 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.
845
846
847
848 = 7. ​ Order Info =
849
850
851 Part Number**:** CPN01
852
853
854
855 = 8.  Packing Info =
856
857
858 (% style="color:blue" %)**Package Includes**:
859
860 * CPN01 Open/Close Sensor x 1
861 * External antenna x 1
862
863 (% style="color:blue" %)**Dimension and weight**:
864
865 * Size: 195 x 125 x 55 mm
866 * Weight:   420g
867
868 = 9.  Support =
869
870
871 * 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.
872
873 * 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]]
874
875 ​

Applications

Navigation

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