Wiki source code of CPN01- NB-IoT Outdoor Open/Close Dry Contact Sensor User Manual

Version 44.1 by David Huang on 2022/10/24 09:08

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

Wiki source code of CPN01- NB-IoT Outdoor Open/Close Dry Contact Sensor User Manual

Applications

Navigation