CPL01 LoRaWAN Outdoor Pulse/Contact Sensor

The Dragino CPL01 is a (% style="color:blue" %)**LoRaWAN Contact Sensor**(%%). It detects open/close status and uplink to IoT server via LoRaWAN network. user can see the dry contact status, open time, open counts in the IoT Server.

30

)))

31

32

(((

33

CPL01 is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), It is designed for long term use up to 10 years. (Actually Battery life depends on the use environment, update period.)

)))

(((

The CPL01 will send periodically data every day as well as for each dry contact action. It also counts the contact open times and calculate last open duration. User can also disable the uplink for each open/close event, instead, device can count each open event and uplink periodically.

)))

(((

CPL01 has the open alarm feature, user can set this feature so device will send Alarm if the contact has been open for a certain time.

)))

(((

CPL01 is designed for outdoor use. It has a weatherproof enclosure and industrial level battery to work in low to high temperatures.

)))

(((

Each CPL01 is pre-load with a set of unique keys for LoRaWAN registration, register these keys to LoRaWAN server and it will auto connect after power on.

)))

(((

*Battery life depends on how often to send data, please see [[battery analyzer>>||anchor="H4.Battery26howtoreplace"]].

)))

== 1.2 Features ==

* LoRaWAN v1.0.3 Class A protocol.

62

* Frequency Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865/RU864

63

* Open/Close detect

64

* Open/Close statistics

65

* 8500mAh industrial battery(none-rechargeable)

66

* AT Commands to change parameters

67

* Uplink on periodically and open/close event

68

* Datalog feature

69

* Remote configure parameters via LoRa Downlink

70

* Firmware upgradable via program port

* Wall Mountable

* Outdoor Use

== 1.3 Installation ==

75

76

77

Connect CPL01 to an Open Close sensor like below. So it can detect the open/close event.

78

79

80

[[image:1652857419839-473.png||height="435" width="482"]]

81

82

83

[[image:1652857455276-422.png||height="229" width="728"]]

== 1.4 Storage & Operation Temperature ==

-40°C to +85°C

== 1.5 Applications ==

95

96

97

(% class="wikigeneratedid" %)

98

(% style="display:none" %)

99

100

* Open/Close Detection

101

* Pulse meter application

102

* Dry Contact Detection

== 1.6 Mechanical ==

[[image:1652857762997-798.png]]

108

109

110

[[image:1652857791347-991.png]]

== 1.7 Pin Definitions and Switch ==

115

116

117

[[image:1652857867227-591.png||height="374" width="727"]]

=== 1.7.1 Pin Definition ===

122

123

124

CPL01 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 user manual of LSN50v2 at: [[https:~~/~~/www.dropbox.com/sh/djkxs7mr17y94mi/AABVlWbM9uzK9OA3mXyAT10Za?dl=0>>https://www.dropbox.com/sh/djkxs7mr17y94mi/AABVlWbM9uzK9OA3mXyAT10Za?dl=0]]

=== 1.7.2 Jumper JP2(Power ON/OFF) ===

129

130

131

Power on Device when putting this jumper.

=== 1.7.3 BOOT MODE / SW1 ===

(((

1) ISP: upgrade mode, device won't have any signal in this mode. but ready for upgrade firmware. LED won't work. Firmware won't run.

)))

(((

2) Flash: work mode, the device starts to work and send out console output for further debug

)))

=== 1.7.4 Reset Button ===

149

150

151

Press to reboot the device.

=== 1.7.5 LED ===

It will flash:

1. Boot the device in flash mode

161

1. Send an uplink packet

162

163

= 2. Operation Mode =

164

165

166

== 2.1 How it works? ==

(((

Each CPL01 is shipped with a worldwide unique set of OTAA keys. To use CPL01 in a LoRaWAN network, user needs to input the OTAA keys in the LoRaWAN network server. So CPL01 can join the LoRaWAN network and start to transmit sensor data.

)))

== 2.2 Example to use for LoRaWAN network ==

176

177

178

This section shows an example of how to join the TTN V3 LoRaWAN IoT server. Usages with other LoRaWAN IoT servers are similar.

179

180

181

[[image:1652858412212-334.png||height="327" width="723"]]

* (((

In this use case, the CPL01 is connect to a dry contact sensor to detect the open/close event and send the status to the LoRaWAN server. The CPL01 will uplink different types of messages to the LoRaWAN server. See [[Uplink payload>>||anchor="H2.3UplinkPayload"]] for detail.

)))

(((

Assume the DLOS8 is already set to connect to the [[TTN V3 network >>url:https://eu1.cloud.thethings.network]]. We need to add the CPL01 device in TTN V3:

)))

(((

(% style="color:blue" %)**Step 1**(%%): Create a device in TTN V3 with the OTAA keys from CPL01.

)))

(((

Each CPL01 is shipped with a sticker with the default device EUI as below:

200

)))

201

202

[[image:1652858451221-297.png]]

203

204

205

Users can enter these keys in the LoRaWAN Server portal. Below is the TTN V3 screenshot:

206

207

Add APP EUI in the application.

208

209

[[image:1652858478050-325.png]]

210

211

212

[[image:1652858498638-881.png||height="327" width="727"]]

213

214

215

[[image:1652858507748-628.png]]

216

217

[[image:1652858520534-791.png]]

218

219

220

Add APP KEY and DEV EUI

(% style="color:blue" %)**Step 2**(%%): Power on CPL01

225

226

227

[[image:1652858584749-726.png]]

(((

Put the jumper to power on CPL01 and it will auto-join to the TTN V3 network. After join success, it will start to upload sensor data to TTN V3 and the user can see it in the panel.

233

)))

234

235

[[image:1652858597931-989.png||height="322" width="721"]]

== 2.3 Uplink Payload ==

(((

Uplink payloads have two types:

)))

* (((

Open/Close Status: Use FPORT=2

248

)))

249

* (((

250

Other control commands: Use other FPORT fields.

)))

(((

The application server should parse the correct value based on FPORT settings.

)))

=== 2.3.1 Device Status, FPORT~=5 ===

(((

Include device configure status. Once CPL01 Joined the network, it will uplink this message to the server. After that, CPL01 will uplink Device Status every 12 hours.

)))

(((

Users can also use the downlink command(0x26 01) to ask CPL01 to resend this uplink. This uplink payload also includes the DeviceTimeReq to get time.

268

269

[[image:image-20220609150022-3.png]]

)))

Example parse in TTNv3

274

275

[[image:1652859749264-179.png||height="275" width="723"]]

* (((

(% style="color:#037691" %)** Sensor Model**(%%): For CPL01, this value is 0x0E

)))

* (((

(% style="color:#037691" %)** Firmware Version**(%%): 0x0100, Means: v1.0.0 version

)))

* (((

(% style="color:#037691" %)** Frequency Band**:

)))

(% class="box" %)

(((

*0x01: EU868

*0x02: US915

*0x03: IN865

*0x04: AU915

*0x05: KZ865

*0x06: RU864

*0x07: AS923

*0x08: AS923-1

*0x09: AS923-2

*0x0a: AS923-3

*0x0b: CN470

*0x0c: EU433

*0x0d: KR920

*0x0e: MA869

)))

* (((

(((

(% style="color:#037691" %)** Sub-Band**:

)))

* (((

AU915 and US915:value 0x00 ~~ 0x08

315

)))

316

* (((

317

CN470: value 0x0B ~~ 0x0C

318

)))

319

* (((

320

Other Bands: Always 0x00

)))

)))

* (((

(% style="color:#037691" %)** Battery Info:**

)))

(((

Check the battery voltage.

)))

(((

(% style="color:blue" %)** Ex1**(%%): 0x0B45 = 2885mV

)))

(((

(% style="color:blue" %)** Ex2**(%%): 0x0B49 = 2889mV

)))

=== 2.3.2 Sensor Configuration, FPORT~=4 ===

343

344

345

CPL01 will only send this command after getting the downlink command (0x26 02) from the server.

346

347

[[image:image-20220609150109-4.png]]

* (((

(% style="color:#037691" %)** TDC: (default: 0x001C20)**

)))

(((

Uplink interval for the total pulse count, default value is 0x001C20 which is 7200 seconds = 2 hours.

)))

* (((

(% style="color:#037691" %)** Disalarm: (default: 0)**

)))

(((

(% style="color:blue" %)** If Disalarm = 1**(%%), CPL01 will only send uplink at every TDC periodically. This is normally use for pulse meter application, in this application, there are many disconnect/connect event, and platform only care about the total number of pulse.

)))

(((

(% style="color:blue" %)** If Disalarm = 0**(%%), CPL01 will send uplink at every TDC periodically.

)))

* (((

(% style="color:#037691" %)** Keep Status & Keep Time**

)))

(((

Shows the configure value of [[Alarm Base on Timeout Feature>>||anchor="H3.5AlarmBaseonTimeout"]]

)))

* (((

(% style="color:#037691" %)** Trigger mode (default: 0)**

)))

(((

(% style="color:blue" %)** If Trigger mode = 0**(%%), count close to open event.

)))

(((

(% style="color:blue" %)** If Trigger mode = 1**(%%), count open to close event.

394

)))

395

396

[[image:1652860064987-743.png||height="152" width="730"]]

397

398

399

[[image:1652860079526-831.png||height="209" width="729"]]

=== 2.3.3 Real-Time Open/Close Status, Uplink FPORT~=2 ===

(((

(((

CPL01 will send this uplink **after** Device Status once join the LoRaWAN network successfully. And CPL01 will:

)))

)))

(((

(((

periodically send this uplink every 2 hours, this interval [[can be changed>>||anchor="H3.1SetTransmitIntervalTime"]].

)))

)))

(((

(((

Uplink Payload totals 11 bytes.

)))

)))

(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %)

425

|=(% colspan="5" style="width: 723px;" %)**Real-Time Open/Close Status, FPORT=2**

426

427

|(% style="width:101px" %)**Value**|(% style="width:133px" %)Status & [[Alarm>>||anchor="H3.5AlarmBaseonTimeout"]]|(% style="width:92px" %)Total pulse|(% style="width:247px" %)The last open duration (unit: min)|(% style="width:149px" %)[[Unix TimeStamp>>||anchor="H2.4.1UnixTimeStamp"]]

428

429

[[image:image-20220609150155-5.png]]

* (((

(% style="color:#037691" %)** Calculate Flag**

)))

(((

The calculate flag is a user define field, IoT server can use this filed to handle different meter with different pulse factor. For example, if there are 100 water meters, meter 1 ~~50 are 1 liter/pulse and meter 51 ~~ 100 has 1.5 liter/pulse.

)))

(((

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.

)))

(((

Default value: 0.

)))

(((

Range (6 bits): (b)000000 ~~ (b) 111111

)))

(((

Refer: [[Set Calculate Flag>>||anchor="H3.9Setthecalculateflag"]]

)))

* (((

(% style="color:#037691" %)** Alarm**

)))

(((

See [[Alarm Base on Timeout>>||anchor="H3.5AlarmBaseonTimeout"]]

)))

* (((

(% style="color:#037691" %)** Contact Status**

)))

(((

0: Open

)))

(((

1: Close

)))

* (((

(% style="color:#037691" %)** Total pulse**

)))

(((

Total pulse/counting base on dry [[contact trigger event>>||anchor="H2.3.2SensorConfiguration2CFPORT3D4"]]

)))

(((

Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215

)))

* (((

(% style="color:#037691" %)** The last open duration**

)))

(((

Dry Contact last open duration.

)))

(((

Unit: min.

)))

[[image:1652860403792-491.png||height="153" width="735"]]

509

510

511

=== 2.3.4 Real-Time Open/Close Status, 3 pulse mode, Uplink FPORT~=6 ( Firmware not release) ===

512

513

514

(% style="color:red" %)**Note:**

515

516

* Firmware support for this mode is not released. If users want to test, please contact Dragino support.

517

* Users need to run **AT+MOD=3** to support this model after updating the firmware.

518

* This mode doesn't support Historical Events and Datalog features.

519

520

521

(% style="color:blue" %)**CPL03 3 Pulse Wiring:**

522

523

[[image:image-20221013153352-1.png]]

524

525

526

(% style="color:blue" %)**Payload:**

527

528

[[image:image-20221013153352-2.png||height="167" width="1215"]]

529

530

531

(% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:447px" %)

532

533

|(% style="width:93px" %)**Value**|(% style="width:59px" %)Status|(% style="width:98px" %)(((

534

Port1 Total Pulse(PB14)

535

)))|(% style="width:96px" %)(((

536

Port2 Total Pulse(PB15)

537

)))|(% style="width:94px" %)(((

538

Port3 Total Pulse(PA4)

)))

(% style="color:blue" %)**Status:**

543

544

(% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:257px" %)

545

|(% style="width:75px" %)**Size(bit)**|(% style="width:111px" %)**6**|(% style="width:68px" %)**2**

546

|(% style="width:75px" %)**Value**|(% style="width:111px" %)Calculate Flag|(% style="width:68px" %)Reserve

547

548

549

(% style="color:red" %)**Max COUNT for each port is 16777215. Exceed this number will reset to 1.**

550

551

552

(% style="color:blue" %)**Related AT Command:**

553

554

(% style="color:#037691" %)**AT+TTRMOD1: Port1 count mode; 0: Signal falling edge(Default), 1: Signal raising edge**

555

556

AT+TTRMOD1=0 Downlink Command: 0xA4 01 00

557

558

AT+TTRMOD1=1 Downlink Command: 0xA4 01 01

559

560

561

(% style="color:#037691" %)**AT+TTRMOD2: Port2 count mode; 0: Signal falling edge(Default), 1: Signal raising edge**

562

563

AT+TTRMOD1=0 Downlink Command: 0xA4 02 00

564

565

AT+TTRMOD1=1 Downlink Command: 0xA4 02 01

566

567

568

(% style="color:#037691" %)**AT+TTRMOD3: Port3 count mode; 0: Signal falling edge(Default), 1: Signal raising edge**

569

570

AT+TTRMOD1=0 Downlink Command: 0xA4 03 00

571

572

AT+TTRMOD1=1 Downlink Command: 0xA4 03 01

573

574

575

(% style="color:#037691" %)**AT+CALCFLAG: Calculate Flag ( Default : 0 )**

AT+CALCFLAG=aa

(% style="color:blue" %)**Downlink Command: 0xA5 aa**

581

582

(% style="color:#037691" %)**AT+COUNTMOD: Accumulative Mode; 0: Accumulative (Default),1: Reset after uplink.**

583

584

AT+COUNTMOD=0 Downlink Command: 0x0B 00

585

586

AT+COUNTMOD=1 Downlink Command: 0x0B 01

587

588

589

(% style="color:#037691" %)**AT+SETCNT: Set count value**

590

591

AT+SETCNT=1,aa Downlink Command: 0xA6 01 aa aa aa

592

593

AT+SETCNT=2,aa Downlink Command: 0xA6 02 aa aa aa

594

595

AT+SETCNT=3,aa Downlink Command: 0xA6 03 aa aa aa

596

597

598

(% style="color:blue" %)**Decode:**

599

600

function Decoder(bytes, port) {

if(port==0x05)

{

var sub_band;

var freq_band;

var sensor;

if(bytes[0]==0x0F)

sensor= "CPL03";

if(bytes[4]==0xff)

sub_band="NULL";

else

sub_band=bytes[4];

if(bytes[3]==0x01)

freq_band="EU868";

else if(bytes[3]==0x02)

freq_band="US915";

else if(bytes[3]==0x03)

freq_band="IN865";

else if(bytes[3]==0x04)

freq_band="AU915";

else if(bytes[3]==0x05)

freq_band="KZ865";

else if(bytes[3]==0x06)

freq_band="RU864";

else if(bytes[3]==0x07)

freq_band="AS923";

else if(bytes[3]==0x08)

freq_band="AS923_1";

else if(bytes[3]==0x09)

freq_band="AS923_2";

else if(bytes[3]==0x0A)

freq_band="AS923_3";

else if(bytes[3]==0x0B)

freq_band="CN470";

else if(bytes[3]==0x0C)

freq_band="EU433";

else if(bytes[3]==0x0D)

freq_band="KR920";

else if(bytes[3]==0x0E)

freq_band="MA869";

var firm_ver= (bytes[1]&0x0f)+'.'+(bytes[2]>>4&0x0f)+'.'+(bytes[2]&0x0f);

685

686

var bat= (bytes[5]<<8 | bytes[6])/1000;

return {

SENSOR_MODEL:sensor,

FIRMWARE_VERSION:firm_ver,

694

695

FREQUENCY_BAND:freq_band,

SUB_BAND:sub_band,

BAT:bat,

};

}

else

{

var calculate_flag=(bytes[0]&0xFC)>>2;

710

711

var total_pulse1=bytes[1]<<16 | bytes[2]<<8 | bytes[3];

712

713

var total_pulse2=bytes[4]<<16 | bytes[5]<<8 | bytes[6];

714

715

var total_pulse3=bytes[7]<<16 | bytes[8]<<8 | bytes[9];

if(bytes.length==10)

{

return {

CALCULATE_FLAG:calculate_flag,

725

726

PORT1_TOTAL_PULSE:total_pulse1,

727

728

PORT2_TOTAL_PULSE:total_pulse2,

729

730

PORT3_TOTAL_PULSE:total_pulse3,

};

}

}

}

=== 2.3.5 Historical Door Open/Close Event, FPORT~=3 ===

(((

CPL01 stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.4DatalogFeature"]].

)))

(((

The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time open/close status.

)))

* (((

Each data entry is 11 bytes and has the same structure as [[Real-Time open/close status>>||anchor="H2.3.3Real-TimeOpen2FCloseStatus2CUplinkFPORT3D2"]], to save airtime and battery, CPL01 will send max bytes according to the current DR and Frequency bands.

)))

(((

For example, in the US915 band, the max payload for different DR is:

)))

(((

a) (% style="color:blue" %)**DR0**(%%): max is 11 bytes so one entry of data

)))

(((

b) (% style="color:blue" %)**DR1**(%%): max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)

)))

(((

c) (% style="color:blue" %)**DR2**(%%): total payload includes 11 entries of data

)))

(((

d) (% style="color:blue" %)**DR3**(%%): total payload includes 22 entries of data.

)))

(((

If CPL01 doesn't have any data in the polling time. It will uplink 11 bytes of 0

)))

(% style="color:blue" %)** Downlink:**

(% class="box" %)

(((

**0x31 61 E9 3A D4 61 E9 3D E0 05**

788

)))

789

790

[[image:1652861353248-624.png||height="189" width="720"]]

791

792

793

(% style="color:blue" %)** Uplink:**

(% class="box" %)

(((

**0E 00 23 E6 00 00 00 61 E9 3B 04 0E 00 23 E6 00 00 00 61 E9 3B 25 0D 00 00 00 00 00 00 61 E9 3B C8 0E 00 00 02 00 00 00 61 E9 3B D4 0E 00 00 06 00 00 00 61 E9 3B DB 01 00 00 00 00 00 00 61 E9 3C 91 01 00 00 00 00 00 00 61 E9 3C A1 0D 00 00 00 00 00 00 61 E9 3C BC 0E 00 00 07 00 00 00 61 E9 3C D6 00 00 00 00 00 00 00 61 E9 3D A6**

798

)))

799

800

(% style="color:#037691" %)** **

801

802

(% style="color:#037691" %)**Parsed Value:**

803

804

(((

805

[ALARM, PIN_STATUS, TOTAL_PULSE, CALCULATE_FLAG, LAST_OPEN_DURATION, TIME]

)))

(((

)))

(((

[TRUE, CLOSE, 9190, 3, 0, 2022-01-20 10:35:48],

)))

(((

[TRUE, CLOSE, 9190, 3, 0, 2022-01-20 10:36:21],

)))

(((

[FALSE, OPEN, 0, 3, 0, 2022-01-20 10:39:04],

)))

(((

[TRUE, CLOSE, 2, 3, 0, 2022-01-20 10:39:16],

)))

(((

[TRUE, CLOSE, 6, 3, 0, 2022-01-20 10:39:23],

)))

(((

[FALSE, OPEN, 0, 0, 0, 2022-01-20 10:42:25],

)))

(((

[FALSE, OPEN, 0, 0, 0, 2022-01-20 10:42:41],

)))

(((

[FALSE, OPEN, 0, 3, 0, 2022-01-20 10:43:08],

)))

(((

[TRUE, CLOSE, 7, 3, 0, 2022-01-20 10:43:34],

)))

(((

[FALSE, CLOSE, 0, 0, 0, 2022-01-20 10:47:02],

)))

[[image:1652861480446-216.png]]

== 2.4 Datalog Feature ==

859

860

861

When a user wants to retrieve sensor value, he can send a poll command from the IoT platform to ask the sensor to send value in the required time slot.

=== 2.4.1 Unix TimeStamp ===

866

867

868

CPL01 uses Unix TimeStamp format based on

869

870

[[image:1652861618065-927.png||height="109" width="705"]]

871

872

Users can get this time from the link: [[https:~~/~~/www.epochconverter.com/>>url:https://www.epochconverter.com/]] :

873

874

Below is the converter example

875

876

[[image:1652861637105-371.png||height="428" width="732"]]

=== 2.4.2 Set Device Time ===

(((

(((

There are two ways to set the device's time:

)))

)))

(((

(((

(% style="color:blue" %)**1. Through LoRaWAN MAC Command (Default settings)**

)))

)))

(((

(((

Users need to set SYNCMOD=1 to enable sync time via the MAC command.

)))

)))

(((

(((

Once CPL01 Joined the LoRaWAN network, it will send the MAC command (DeviceTimeReq) and the server will reply with (DeviceTimeAns) to send the current time to CPL01. If CPL01 fails to get the time from the server, CPL01 will use the internal time and wait for the next time request ~[[[via Device Status (FPORT=5)>>||anchor="H2.3.1DeviceStatus2CFPORT3D5"]]].

)))

)))

(((

(((

(% style="color:red" %)**Note: LoRaWAN Server needs to support LoRaWAN v1.0.3(MAC v1.0.3) or higher to support this MAC command feature.**

)))

(((

)))

(((

(% style="color:blue" %)**2. Manually Set Time**

)))

(((

Users need to set SYNCMOD=0 to manual time, otherwise, the user set time will be overwritten by the time set by the server.

)))

)))

=== 2.4.3 Poll sensor value ===

932

933

934

Users can poll sensor values based on timestamps. Below is the downlink command.

935

936

(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:453.989px" %)

937

|=(% colspan="4" style="width: 451px;" %)**Downlink Command to poll Open/Close status (0x31)**

938

|(% style="width:59px" %)**1byte**|(% style="width:126px" %)**4bytes**|(% style="width:138px" %)**4bytes**|(% style="width:128px" %)**1byte**

939

|(% style="width:59px" %)31|(% style="width:126px" %)Timestamp start|(% style="width:138px" %)Timestamp end|(% style="width:128px" %)Uplink Interval

940

941

(((

942

Timestamp start and Timestamp end-use Unix TimeStamp format as mentioned above. Devices will reply with all data logs during this period, using the uplink interval.

)))

(((

For example, downlink command[[image:image-20220518162852-1.png]]

)))

(((

Is to check 2021/11/12 12:00:00 to 2021/11/12 15:00:00's data

)))

(((

Uplink Internal =5s，means CPL01 will send one packet every 5s. range 5~~255s.

)))

=== 2.4.4 Decoder in TTN V3 ===

960

961

962

[[image:1652862574387-195.png||height="359" width="722"]]

963

964

(((

965

Please check the decoder from this link:

)))

(((

[[https:~~/~~/docs.google.com/document/d/1LFTp2IupfM3O4rQ1gJgZHJNP49BZFnm2xThiErnJYPQ/edit?usp=sharing>>url:https://docs.google.com/document/d/1LFTp2IupfM3O4rQ1gJgZHJNP49BZFnm2xThiErnJYPQ/edit?usp=sharing]]

)))

= 2.5 Show data on Datacake =

(((

Datacake IoT platform provides a human-friendly interface to show the sensor data, once we have sensor data in TTN V3, we can use Datacake to connect to TTN V3 and see the data in Datacake. Below are the steps:

)))

(((

(% style="color:blue" %)**Step 1**(%%): Link TTNv3 to Datacake [[https:~~/~~/docs.datacake.de/lorawan/lns/thethingsindustries#create-integration-on-tti>>url:https://docs.datacake.de/lorawan/lns/thethingsindustries#create-integration-on-tti]]

)))

(((

(% style="color:blue" %)**Step 2**(%%): Configure CPL01 in Datacake

987

)))

988

989

[[image:1652862663124-805.png]]

990

991

[[image:1652862686700-576.png]]

[[image:1652862716106-261.png]]

997

998

[[image:1652862734313-990.png||height="229" width="707"]]

999

1000

1001

[[image:1652862744310-982.png||height="380" width="715"]]

1002

1003

1004

[[image:1652862755419-628.png||height="258" width="718"]]

1005

1006

1007

[[image:1652862763975-153.png||height="214" width="720"]]

1008

1009

1010

[[image:1652862773781-198.png||height="321" width="499"]]

1011

1012

1013

[[image:1652862794151-835.png||height="327" width="487"]]

1014

1015

1016

[[image:1652862807472-427.png||height="378" width="670"]]

= 3. Configure CPL01 via AT Command or LoRaWAN Downlink =

(((

Use can configure CPL01 via AT Command or LoRaWAN Downlink.

)))

* (((

AT Command Connection: See [[FAQ>>||anchor="H5.FAQ"]].

1029

)))

1030

* (((

1031

LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>doc:Main.WebHome]]

)))

(((

There are two kinds of commands to configure CPL01, they are:

)))

* (((

(% style="color:#4f81bd" %)**General Commands**.

)))

(((

These commands are to configure:

)))

* (((

General system settings like uplink interval.

1048

)))

1049

* (((

1050

LoRaWAN protocol & radio related command.

)))

(((

They are the same for all Dragino Devices which support DLWS-005 LoRaWAN Stack(Note~*~*). These commands can be found on the wiki: [[End Device AT Commands and Downlink Command>>doc:Main.End Device AT Commands and Downlink Command.WebHome]]

)))

(((

)))

* (((

(% style="color:#4f81bd" %)**Commands special design for CPL01**

)))

(((

These commands are only valid for CPL01, as below:

)))

== 3.1 Set Transmit Interval Time ==

(((

Feature: Change LoRaWAN End Node Transmit Interval.

)))

(((

(% style="color:#4f81bd" %)**AT Command: AT+TDC**

)))

(((

[[image:image-20220609134826-1.png]]

)))

(((

)))

(((

(% style="color:#4f81bd" %)**Downlink Command: 0x01**

)))

(((

Format: Command Code (0x01) followed by 3 bytes time value.

)))

(((

If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01.

)))

* (((

Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds

1106

)))

1107

* (((

1108

Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds

)))

== 3.2 Set Password ==

1116

1117

1118

Feature: Set device password, max 9 digits

1119

1120

1121

(% style="color:#4f81bd" %)**AT Command: AT+PWORD**

1122

1123

1124

(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:404.989px" %)

1125

|=(% style="width: 170px;" %)**Command Example**|=(% style="width: 123px;" %)**Function**|=(% style="width: 109px;" %)**Response**

1126

|(% style="width:170px" %)(((

1127

AT+PWORD=?

1128

)))|(% style="width:123px" %)(((

1129

Show password

1130

)))|(% style="width:109px" %)(((

(((

123456

)))

(((

OK

)))

)))

|(% style="width:170px" %)(((

1140

AT+PWORD=999999

1141

)))|(% style="width:123px" %)(((

1142

Set password

1143

)))|(% style="width:109px" %)(((

OK

)))

(% style="color:#4f81bd" %)**Downlink Command:**

1148

1149

No downlink command for this feature.

== 3.3 Quit AT Command ==

1154

1155

1156

Feature: Quit AT Command mode, so user needs to input the password again before using AT Commands.

1157

1158

1159

(% style="color:#4f81bd" %)**AT Command: AT+DISAT**

1160

1161

1162

(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:451.989px" %)

1163

|=(% style="width: 155px;" %)**Command Example**|=(% style="width: 198px;" %)**Function**|=(% style="width: 96px;" %)**Response**

1164

|(% style="width:155px" %)AT+DISAT|(% style="width:198px" %)Quit AT Commands mode|(% style="width:96px" %)OK

1165

1166

(% style="color:#4f81bd" %)**Downlink Command:**

1167

1168

No downlink command for this feature.

== 3.4 Enable / Disable Alarm ==

1173

1174

1175

Feature: Enable/Disable Alarm for open/close event. Default value 0.

1176

1177

1178

(% style="color:#4f81bd" %)**AT Command:**

1179

1180

(% id="cke_bm_3822S" style="display:none" %) [[image:image-20220609151041-6.png]]

1181

1182

[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/image-20220609140712-1.png?rev=1.1||alt="image-20220609140712-1.png"]]

1183

1184

1185

(% style="color:#4f81bd" %)**Downlink Command:**

1186

1187

**0xA7 01** ~/~/ Same As AT+DISALARM=1

1188

1189

**0xA7 00 ** ~/~/ Same As AT+DISALARM=0

1190

1191

1192

(% style="color:red" %)**Notice, This command requires setting CPL01 to LDS03A Mode first. See **(%%)**"(% style="color:blue" %)3.7 Set the sensor mode"(%%)**

== 3.5 Alarm Base on Timeout ==

(((

(((

CPL01 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:

)))

)))

(((

(((

(% style="color:#4f81bd" %)**1. Keep Status: Status to be monitor**

)))

)))

(((

(((

Keep Status = 1: Monitor Close to Open event

)))

)))

(((

(((

Keep Status = 0: Monitor Open to Close event

)))

)))

(((

(((

(% style="color:#4f81bd" %)**2. Keep Time: Timeout to send an Alarm**

)))

)))

(((

(((

Range 0 ~~ 65535(0xFFFF) seconds.

)))

)))

(((

(((

If keep time = 0, Disable Alarm Base on Timeout feature.

)))

)))

(((

(((

If keep time > 0, device will monitor the keep status event and send an alarm when status doesn’t change after timeout.

)))

(((

)))

)))

(((

(((

(% style="color:#4f81bd" %)**AT Command**(%%) to configure:

)))

(((

(% style="color:blue" %)**AT+TTRIG=1,30**(%%) ~-~-> When the **Keep Status** change from connect to disconnect, and device remains in disconnect status for more than 30 seconds. CPL01 will send an uplink packet, the [[Alarm bit>>||anchor="H2.3.3Real-TimeOpen2FCloseStatus2CUplinkFPORT3D2"]] (the second bit of 1^^st^^ byte of payload) on this uplink packet is set to 1.

)))

(((

(% style="color:blue" %)**AT+TTIG=0,0 **(%%) ~-~-> Default Value, disable timeout Alarm.

)))

)))

(((

)))

(((

(((

(% style="color:#4f81bd" %)**Downlink Command**(%%) to configure:

)))

(((

**Command: 0xA9 aa bb cc**

)))

)))

(((

(((

A9: Command Type Code

)))

)))

(((

(((

aa: status to be monitored

)))

)))

(((

(((

bb cc: timeout.

)))

)))

(((

)))

(((

(((

If user send 0xA9 01 00 1E: equal to AT+TTRIG=1,30

)))

)))

(((

(((

Or

)))

)))

(((

(((

0xA9 00 00 00: Equal to AT+TTRIG=0,0. Disable timeout Alarm.

)))

)))

== 3.6 Clear Flash Record ==

1326

1327

1328

Feature: Clear flash storage for data log feature.

1329

1330

1331

(% style="color:#4f81bd" %)**AT Command: AT+CLRDTA**

1332

1333

[[image:image-20220609151132-7.png]]

(((

(((

(% style="color:#4f81bd" %)**Downlink Command:**

)))

(((

* **Example**: 0xA301 ~/~/ Same as AT+CLRDTA

)))

)))

== 3.7 Set the sensor mode ==

1350

1351

1352

Feature: LDS03A and CPL01 use the same firmware. User is possible to switch between this two models.

1353

1354

1355

(% style="color:#4f81bd" %)**AT Command: AT+MOD**

1356

1357

(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:443.222px" %)

1358

|=(% style="width: 156px;" %)**Command Example**|=(% style="width: 195px;" %)**Function**|=(% style="width: 88px;" %)**Response**

1359

|(% style="width:156px" %)AT+MOD =1|(% style="width:195px" %)Set the sensor to LDS03A.|(% style="width:88px" %)OK

1360

|(% style="width:156px" %)AT+MOD=2|(% style="width:195px" %)Set the sensor to CPL01.|(% style="width:88px" %)OK

1361

1362

(% style="color:#4f81bd" %)**Downlink Command:**

1363

1364

* **Example**: 0x0A02 ~/~/ Same as AT+MOD=2

1365

1366

== 3.8 Set trigger mode ==

1367

1368

1369

Feature: Set the trigger interrupt mode.

1370

1371

1372

(% style="color:#4f81bd" %)**AT Command: AT+TTRMOD**

1373

1374

[[image:image-20220609151344-9.png]]

1375

1376

1377

(% style="color:#4f81bd" %)**Downlink Command:**

1378

1379

* **Example**: 0xA401 ~/~/ Same as AT+ TTRMOD =1

1380

1381

== 3.9 Set the calculate flag ==

1382

1383

1384

Feature: Set the calculate flag

1385

1386

1387

(% style="color:#4f81bd" %)**AT Command: AT+CALCFLAG**

1388

1389

(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:461.222px" %)

1390

|=(% style="width: 158px;" %)**Command Example**|=(% style="width: 192px;" %)**Function**|=(% style="width: 109px;" %)**Response**

1391

|(% style="width:158px" %)AT+CALCFLAG =1|(% style="width:192px" %)Set the calculate flag to 1.|(% style="width:109px" %)OK

1392

|(% style="width:158px" %)AT+CALCFLAG =2|(% style="width:192px" %)Set the calculate flag to 2.|(% style="width:109px" %)OK

1393

1394

(% style="color:#4f81bd" %)**Downlink Command:**

1395

1396

* **Example**: 0XA501 ~/~/ Same as AT+CALCFLAG =1

1397

1398

== 3.10 Set count number ==

1399

1400

1401

Feature: Manually set the count number

1402

1403

1404

(% style="color:#4f81bd" %)**AT Command: AT+SETCNT**

1405

1406

(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:479.989px" %)

1407

|=(% style="width: 160px;" %)**Command Example**|=(% style="width: 221px;" %)**Function**|=(% style="width: 95px;" %)**Response**

1408

|(% style="width:160px" %)AT+ SETCNT =0|(% style="width:221px" %)Set the count number to 0.|(% style="width:95px" %)OK

1409

|(% style="width:160px" %)AT+ SETCNT =100|(% style="width:221px" %)Set the count number to 100.|(% style="width:95px" %)OK

1410

1411

(% style="color:#4f81bd" %)**Downlink Command:**

1412

1413

1. **Example**: 0xA6000001 ~/~/ Same as AT+ SETCNT =1

1414

1. **Example**: 0xA6000064 ~/~/ Same as AT+ SETCNT =100

1415

1416

= 4. Battery & how to replace =

1417

1418

1419

== 4.1 Battery Info ==

1420

1421

1422

CPL01 is equipped with a [[8500mAH ER18505 Li-SOCI2 battery>>url:https://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]. The battery is an un-rechargeable battery with a low discharge rate targeting 8~~10 years of use. This type of battery is commonly used in IoT targets for long-term running, such as water meters.

1423

1424

(((

1425

The battery-related documents are as below:

)))

* (((

[[Battery Dimension>>https://www.dragino.com/downloads/index.php?dir=datasheet/Battery/]],

1430

)))

1431

* (((

1432

[[Lithium-Thionyl Chloride Battery datasheet>>https://www.dragino.com/downloads/downloads/datasheet/Battery/ER26500/ER26500_Datasheet-EN.pdf]],

1433

)))

1434

* (((

1435

[[Lithium-ion Battery-Capacitor datasheet>>https://www.dragino.com/downloads/index.php?dir=datasheet/Battery/]], [[Tech Spec>>https://www.dragino.com/downloads/index.php?dir=datasheet/Battery/]]

)))

(((

The discharge curve is not linear so can’t simply use percentage to show the battery level. Below is the battery performance.

1440

1441

1442

[[image:1652864571107-510.png]]

)))

(((

Minimum Working Voltage for the CPL01:

)))

(((

CPL01: 2.45v ~~ 3.6v

)))

=== 4.1.1 Battery Note ===

(((

The Li-SICO battery is designed for small current / long period applications. 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 to transmit LoRa, then the battery life may be decreased.

)))

== 4.2 Replace Battery ==

(((

(((

Any battery with a range of 2.45 ~~ 3.6v can be a replacement. We recommend using Li-SOCl2 Battery.

)))

)))

(((

(((

And make sure the positive and negative pins match.

)))

)))

[[image:image-20220518170657-2.png]]

== 4.3 Battery Life Analyze ==

(((

(((

Dragino battery powered products are all run in Low Power mode. User can check the guideline from this link to calculate the estimate battery life:

)))

)))

(((

(((

[[https:~~/~~/www.dragino.com/downloads/downloads/LoRa_End_Node/Battery_Analyze/DRAGINO_Battery_Life_Guide.pdf>>url:https://www.dragino.com/downloads/downloads/LoRa_End_Node/Battery_Analyze/DRAGINO_Battery_Life_Guide.pdf]]

)))

)))

= 5. FAQ =

== 5.1 How to use AT Command to configure CPL01 ==

1506

1507

1508

CPL01 UART connection photo

1509

1510

[[image:1652864909750-855.png||height="356" width="728"]]

(((

In the PC, you need to set the serial baud rate to (% style="color:green" %)**9600**(%%) to access the serial console for LSN50. LSN50 will output system info once power on as below:

1515

)))

1516

1517

[[image:1652864915792-686.png||height="508" width="726"]]

== 5.2 How to upgrade the firmware? ==

(((

(((

A new firmware might be available for:

)))

)))

* (((

(((

Support new features

)))

)))

* (((

(((

For bug fix

)))

)))

* (((

(((

Change LoRaWAN bands.

)))

)))

(((

(((

Instruction for how to upgrade: [[Firmware Upgrade Instruction>>doc:Main.Firmware Upgrade Instruction for STM32 base products.WebHome||anchor="H2.HardwareUpgradeMethodSupportList"]]

)))

)))

(((

(((

Firmware location: (**(% style="color:red" %)same firmware as LDS03A(%%)**)[[https:~~/~~/www.dropbox.com/sh/x9rpz9ftyljg135/AAAhC5hqtQOAw9_AoEEZbl9Ca?dl=0>>https://www.dropbox.com/sh/x9rpz9ftyljg135/AAAhC5hqtQOAw9_AoEEZbl9Ca?dl=0]]

)))

)))

== 5.3 How to change the LoRa Frequency Bands/Region? ==

1561

1562

1563

Users can follow the introduction for how to upgrade image. When downloading the images, choose the required image file for download.

= 6. Trouble Shooting =

1568

1569

1570

== 6.1 AT Commands input doesn't work ==

1571

1572

1573

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.

= 7. Order Info =

(((

(((

Part Number: (% style="color:#4f81bd" %)**CPL01-XX**

)))

)))

(((

(((

(% style="color:#4f81bd" %)**XX**(%%): The default frequency band

)))

)))

* (((

(% style="color:red" %)**AS923 **(%%)**:** LoRaWAN AS923 band

1594

)))

1595

* (((

1596

(% style="color:red" %)**AU915 **(%%)**: **LoRaWAN AU915 band

1597

)))

1598

* (((

1599

(% style="color:red" %)**EU433 **(%%)**:** LoRaWAN EU433 band

1600

)))

1601

* (((

1602

(% style="color:red" %)**EU868 **(%%)**:** LoRaWAN EU868 band

1603

)))

1604

* (((

1605

(% style="color:red" %)**KR920 **(%%)**:** LoRaWAN KR920 band

1606

)))

1607

* (((

1608

(% style="color:red" %)**US915 **(%%)**: **LoRaWAN US915 band

1609

)))

1610

* (((

1611

(% style="color:red" %)**IN865 **(%%)**: **LoRaWAN IN865 band

1612

)))

1613

* (((

1614

(% style="color:red" %)**CN470 **(%%)**: **LoRaWAN CN470 band

)))

= 8. Packing Info =

(((

**Package Includes**:

)))

* (((

CPL01 Open/Close Sensor x 1

)))

= 9. Support =

* (((

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.

1641

)))

1642

* (((

1643

Provide as much information as possible regarding your inquiry (product models, accurately describe your problem and steps to replicate it etc) and send a mail to [[support@dragino.com>>url:file:///D:/市场资料/说明书/LoRa/LT系列/support@dragino.com]].

)))

Wiki source code of CPL01 LoRaWAN Outdoor Pulse/Contact Sensor

Applications

Navigation