Wiki source code of SW3L-LB -- LoRaWAN Flow Sensor User Manual

Version 67.4 by Xiaoling on 2023/05/30 14:21

version	line-number	content
26.1	1	(% style="text-align:center" %)
67.2	2	[[image:image-20230530140053-1.jpeg\|\|height="645" width="645"]]
1.1	3
	4
67.2	5
	6
	7
31.2	8	Table of Contents：
30.1	9
1.1	10	{{toc/}}
	11
	12
	13
	14
	15
	16
31.1	17	= 1. Introduction =
1.1	18
67.3	19	== 1.1 What is SW3L-LB LoRaWAN Flow Sensor ==
1.1	20
39.6	21
67.3	22	The Dragino SW3L-LB is a (% style="color:blue" %)LoRaWAN Flow Sensor(%%). It detects water flow volume and uplink to IoT server via LoRaWAN network. User can use this to(% style="color:blue" %) monitor the water usage for buildings.
1.1	23
67.3	24	The SW3L-LB will send water flow volume every 20 minutes. It can also (% style="color:blue" %)detect the water flow status(%%) and (% style="color:blue" %)send Alarm(%%), to avoid the waste for water usage such as broken toilet case.
1.1	25
67.3	26	SW3L-LB is designed for both indoor and outdoor use. It has a weatherproof enclosure and industrial level battery to work in low to high temperatures.
1.1	27
67.3	28	The LoRa wireless technology used in SW3L-LB allows device to send data and reach extremely long ranges at low data-rates. It provides ultra-long range spread spectrum communication and high interference immunity whilst minimizing current consumption.
1.1	29
67.3	30	SW3L-LB (% style="color:blue" %)supports BLE configure(%%) and (% style="color:blue" %)wireless OTA update(%%) which make user easy to use.
62.4	31
67.3	32	SW3L-LB is powered by (% style="color:blue" %)8500mAh Li-SOCI2 battery(%%), it is designed for long term use up to 5 years.
1.1	33
67.3	34	Each SW3L-LB is pre-load with a set of unique keys for LoRaWAN registrations, register these keys to local LoRaWAN server and it will auto connect after power on.
1.1	35
	36
66.2	37	[[image:image-20230530135919-1.png\|\|height="404" width="806"]]
64.2	38
	39
1.1	40	== 1.2 Features ==
	41
39.6	42
1.1	43	* LoRaWAN 1.0.3 Class A
62.4	44	* Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865
1.1	45	* Ultra-low power consumption
67.4	46	* Upload water flow volume
	47	* Monitor water waste
	48	* AT Commands to change parameters
62.4	49	* supports Datalog feature
1.1	50	* Support Bluetooth v5.1 and LoRaWAN remote configure
	51	* Support wireless OTA update firmware
62.4	52	* Uplink on periodically and open/close event
1.1	53	* Downlink to change configure
	54	* 8500mAh Battery for long term use
	55
	56	== 1.3 Specification ==
	57
	58
	59	(% style="color:#037691" %)Common DC Characteristics:
	60
	61	* Supply Voltage: built in 8500mAh Li-SOCI2 battery , 2.5v ~~ 3.6v
	62	* Operating Temperature: -40 ~~ 85°C
	63
	64	(% style="color:#037691" %)LoRa Spec:
	65
	66	* Frequency Range, Band 1 (HF): 862 ~~ 1020 Mhz
	67	* Max +22 dBm constant RF output vs.
	68	* RX sensitivity: down to -139 dBm.
	69	* Excellent blocking immunity
	70
	71	(% style="color:#037691" %)Battery:
	72
	73	* Li/SOCI2 un-chargeable battery
	74	* Capacity: 8500mAh
	75	* Self-Discharge: <1% / Year @ 25°C
	76	* Max continuously current: 130mA
	77	* Max boost current: 2A, 1 second
	78
	79	(% style="color:#037691" %)Power Consumption
	80
	81	* Sleep Mode: 5uA @ 3.3v
	82	* LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm
	83
62.4	84	== 1.4 Applications ==
1.1	85
62.4	86
67.4	87	* Flow Sensor application
	88	* Water Control
	89	* Toilet Flow Sensor
	90	* Monitor Waste water
62.4	91
	92	== 1.5 Sleep mode and working mode ==
	93
	94
1.1	95	(% style="color:blue" %)Deep Sleep Mode: (%%)Sensor doesn't have any LoRaWAN activate. This mode is used for storage and shipping to save battery life.
	96
	97	(% style="color:blue" %)Working Mode: (%%)In this mode, Sensor will work as LoRaWAN Sensor to Join LoRaWAN network and send out sensor data to server. Between each sampling/tx/rx periodically, sensor will be in IDLE mode), in IDLE mode, sensor has the same power consumption as Deep Sleep mode.
	98
	99
62.9	100	== 1.6 Button & LEDs ==
1.1	101
	102
6.1	103	[[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675071855856-879.png]]
1.1	104
	105
14.13	106	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
14.11	107	\|=(% style="width: 167px;background-color:#D9E2F3;color:#0070C0" %)Behavior on ACT\|=(% style="width: 117px;background-color:#D9E2F3;color:#0070C0" %)Function\|=(% style="width: 225px;background-color:#D9E2F3;color:#0070C0" %)Action
1.1	108	\|(% style="width:167px" %)Pressing ACT between 1s < time < 3s\|(% style="width:117px" %)Send an uplink\|(% style="width:225px" %)(((
	109	If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, (% style="color:blue" %)blue led (%%)will blink once.
	110	Meanwhile, BLE module will be active and user can connect via BLE to configure device.
	111	)))
	112	\|(% style="width:167px" %)Pressing ACT for more than 3s\|(% style="width:117px" %)Active Device\|(% style="width:225px" %)(((
	113	(% style="color:green" %)Green led(%%) will fast blink 5 times, device will enter (% style="color:#037691" %)OTA mode(%%) for 3 seconds. And then start to JOIN LoRaWAN network.
	114	(% style="color:green" %)Green led(%%) will solidly turn on for 5 seconds after joined in network.
	115	Once sensor is active, BLE module will be active and user can connect via BLE to configure device, no matter if device join or not join LoRaWAN network.
	116	)))
6.1	117	\|(% style="width:167px" %)Fast press ACT 5 times.\|(% style="width:117px" %)Deactivate Device\|(% style="width:225px" %)(% style="color:red" %)Red led(%%) will solid on for 5 seconds. Means device is in Deep Sleep Mode.
1.1	118
62.9	119	== 1.7 BLE connection ==
1.1	120
	121
67.4	122	SW3L-LB support BLE remote configure.
1.1	123
	124
	125	BLE can be used to configure the parameter of sensor or see the console output from sensor. BLE will be only activate on below case:
	126
	127	* Press button to send an uplink
	128	* Press button to active device.
	129	* Device Power on or reset.
	130
	131	If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode.
	132
	133
62.9	134	== 1.8 Pin Definitions ==
1.1	135
43.1	136	[[image:image-20230523174230-1.png]]
1.1	137
43.1	138
67.4	139	== 1.9 Flow Sensor Spec ==
43.1	140
	141
67.4	142	(((
	143	(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %)
	144	\|=(% style="width: 80px;background-color:#D9E2F3;color:#0070C0" %)Model\|=(% style="width: 80px;background-color:#D9E2F3;color:#0070C0" %)Probe\|=(% style="width: 80px;background-color:#D9E2F3;color:#0070C0" %)Diameter\|=(% style="width: 80px;background-color:#D9E2F3;color:#0070C0" %)Range\|=(% style="width: 80px;background-color:#D9E2F3;color:#0070C0" %)Max Pressure\|=(% style="width: 110px;background-color:#D9E2F3;color:#0070C0" %)Measure
	145	\|(% style="width:88px" %)SW3L-004\|(% style="width:75px" %)DW-004\|(% style="width:107px" %)G1/2" /DN15\|(% style="width:101px" %)1~~30L/min\|(% style="width:116px" %)≤ 2.0Mpa\|(% style="width:124px" %)450 pulse = 1 L
	146	\|(% style="width:88px" %)SW3L-006\|(% style="width:75px" %)DW-006\|(% style="width:107px" %)G3/4" /DN20\|(% style="width:101px" %)1~~60L/min\|(% style="width:116px" %)≤ 1.2Mpa\|(% style="width:124px" %)390 pulse = 1 L
	147	\|(% style="width:88px" %)SW3L-010\|(% style="width:75px" %)DW-010\|(% style="width:107px" %)G 1" /DN25\|(% style="width:101px" %)2~~100L/min\|(% style="width:116px" %)≤ 2.0Mpa\|(% style="width:124px" %)64 pulse = 1 L
	148	)))
	149
	150
	151	== 2.10 Mechanical ==
	152
	153
6.1	154	[[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675143884058-338.png]]
1.1	155
	156
6.1	157	[[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675143899218-599.png]]
1.1	158
	159
6.1	160	[[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675143909447-639.png]]
1.1	161
	162
67.4	163	(% style="color:blue" %)DW-004 Flow Sensor: diameter: G1/2” / DN15. 450 pulse = 1 L
	164
	165	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L%20LoRaWAN%20Outdoor%20Flow%20Sensor/WebHome/image-20220519091350-1.png?width=722&height=385&rev=1.1\|\|alt="image-20220519091350-1.png"]]
	166
	167
	168	(% style="color:blue" %)006: DW-006 Flow Sensor: diameter: G3/4” / DN20. 390 pulse = 1 L
	169
	170	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L%20LoRaWAN%20Outdoor%20Flow%20Sensor/WebHome/image-20220519091423-2.png?width=723&height=258&rev=1.1\|\|alt="image-20220519091423-2.png"]]
	171
	172
	173	(% style="color:blue" %)010: DW-010 Flow Sensor: diameter: G 1” / DN25. 64 pulse = 1 L
	174
	175	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L%20LoRaWAN%20Outdoor%20Flow%20Sensor/WebHome/image-20220519091423-3.png?width=724&height=448&rev=1.1\|\|alt="image-20220519091423-3.png"]]
	176
	177
62.5	178	= 2. Configure CPL03-LB to connect to LoRaWAN network =
1.1	179
	180	== 2.1 How it works ==
	181
	182
67.4	183	The SW3L-LB is configured as (% style="color:#037691" %)LoRaWAN OTAA Class A(%%) mode by default. It has OTAA keys to join LoRaWAN network. To connect a local LoRaWAN network, you need to input the OTAA keys in the LoRaWAN IoT server and press the button to activate the SW3L-LB. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 20 minutes.
1.1	184
64.2	185	(% style="display:none" %) (%%)
1.1	186
	187	== 2.2 Quick guide to connect to LoRaWAN server (OTAA) ==
	188
	189
	190	Following is an example for how to join the [[TTN v3 LoRaWAN Network>>url:https://console.cloud.thethings.network/]]. Below is the network structure; we use the [[LPS8v2>>url:https://www.dragino.com/products/lora-lorawan-gateway/item/228-lps8v2.html]] as a LoRaWAN gateway in this example.
	191
62.5	192	The LPS8v2 is already set to connected to [[TTN network >>url:https://console.cloud.thethings.network/]], so what we need to now is configure the TTN server.
1.1	193
66.2	194	[[image:image-20230530135929-2.png\|\|height="404" width="806"]](% style="display:none" %)
1.1	195
64.2	196
67.4	197	(% style="color:blue" %)Step 1:(%%) Create a device in TTN with the OTAA keys from SW3L-LB.
1.1	198
67.4	199	Each SW3L-LB is shipped with a sticker with the default device EUI as below:
1.1	200
30.1	201	[[image:image-20230426084152-1.png\|\|alt="图片-20230426084152-1.png" height="233" width="502"]]
1.1	202
	203
	204	You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
	205
	206
	207	(% style="color:blue" %)Register the device
	208
14.13	209	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50v2-S31-S31B%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20User%20Manual/WebHome/1654935135620-998.png?rev=1.1\|\|alt="1654935135620-998.png"]]
1.1	210
	211
	212	(% style="color:blue" %)Add APP EUI and DEV EUI
	213
30.1	214	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50v2-S31-S31B%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20User%20Manual/WebHome/image-20220611161308-4.png?width=753&height=551&rev=1.1\|\|alt="图片-20220611161308-4.png"]]
1.1	215
	216
	217	(% style="color:blue" %)Add APP EUI in the application
	218
	219
30.1	220	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50v2-S31-S31B%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20User%20Manual/WebHome/image-20220611161308-5.png?width=742&height=601&rev=1.1\|\|alt="图片-20220611161308-5.png"]]
1.1	221
	222
	223	(% style="color:blue" %)Add APP KEY
	224
30.1	225	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50v2-S31-S31B%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20User%20Manual/WebHome/image-20220611161308-6.png?width=744&height=485&rev=1.1\|\|alt="图片-20220611161308-6.png"]]
1.1	226
	227
67.4	228	(% style="color:blue" %)Step 2:(%%) Activate on SW3L-LB
1.1	229
	230
62.5	231	Press the button for 5 seconds to activate the CPL03-LB.
6.1	232
1.1	233	(% style="color:green" %)Green led(%%) will fast blink 5 times, device will enter (% style="color:blue" %)OTA mode(%%) for 3 seconds. And then start to JOIN LoRaWAN network. (% style="color:green" %)Green led(%%) will solidly turn on for 5 seconds after joined in network.
	234
	235	After join success, it will start to upload messages to TTN and you can see the messages in the panel.
	236
	237
	238	== 2.3 Uplink Payload ==
	239
	240	=== 2.3.1 Device Status, FPORT~=5 ===
	241
	242
67.4	243	Users can use the downlink command(0x26 01) to ask CPL03-LB to send device configure detail, include device configure status. SW3L-LB will uplink a payload via FPort=5 to server.
1.1	244
	245	The Payload format is as below.
	246
	247
14.15	248	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
	249	\|(% colspan="6" style="background-color:#d9e2f3; color:#0070c0" %)Device Status (FPORT=5)
1.1	250	\|(% style="width:103px" %)Size (bytes)\|(% style="width:72px" %)1\|2\|(% style="width:91px" %)1\|(% style="width:86px" %)1\|(% style="width:44px" %)2
	251	\|(% style="width:103px" %)Value\|(% style="width:72px" %)Sensor Model\|Firmware Version\|(% style="width:91px" %)Frequency Band\|(% style="width:86px" %)Sub-band\|(% style="width:44px" %)BAT
	252
	253	Example parse in TTNv3
	254
62.5	255	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/CPL01%20LoRaWAN%20Outdoor%20PulseContact%20%20Sensor%20Manual/WebHome/1652859749264-179.png?width=723&height=275&rev=1.1\|\|alt="1652859749264-179.png"]]
1.1	256
	257
62.5	258	(% style="color:#037691" %)Sensor Model(%%): For CPL03-LB, this value is 0x0A
1.1	259
	260	(% style="color:#037691" %)Firmware Version(%%): 0x0100, Means: v1.0.0 version
	261
	262	(% style="color:#037691" %)Frequency Band:
	263
	264	*0x01: EU868
	265
	266	*0x02: US915
	267
	268	*0x03: IN865
	269
	270	*0x04: AU915
	271
	272	*0x05: KZ865
	273
	274	*0x06: RU864
	275
	276	*0x07: AS923
	277
	278	*0x08: AS923-1
	279
	280	*0x09: AS923-2
	281
	282	*0x0a: AS923-3
	283
	284	*0x0b: CN470
	285
	286	*0x0c: EU433
	287
	288	*0x0d: KR920
	289
	290	*0x0e: MA869
	291
	292
	293	(% style="color:#037691" %)Sub-Band:
	294
	295	AU915 and US915:value 0x00 ~~ 0x08
	296
	297	CN470: value 0x0B ~~ 0x0C
	298
	299	Other Bands: Always 0x00
	300
	301
	302	(% style="color:#037691" %)Battery Info:
	303
	304	Check the battery voltage.
	305
	306	Ex1: 0x0B45 = 2885mV
	307
	308	Ex2: 0x0B49 = 2889mV
	309
	310
62.5	311	=== 2.3.2 Sensor Configuration, FPORT~=4 ===
1.1	312
	313
62.8	314	CPL03-LB will only send this command after getting the downlink command (0x26 02) from the server.
1.1	315
62.5	316	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
	317	\|(% colspan="6" style="background-color:#d9e2f3; color:#0070c0; width:504px" %)Sensor Configuration FPORT=4
	318	\|Size(bytes)\|(% style="width:75px" %)3\|(% style="width:77px" %)1\|(% style="width:96px" %)1\|(% style="width:158px" %)2\|(% style="width:158px" %)1
	319	\|Value\|(% style="width:75px" %)TDC (unit:sec)\|(% style="width:77px" %)Disalarm\|(% style="width:96px" %)Keep status\|(% style="width:158px" %)Keep time (unit: sec)\|(% style="width:158px" %)Trigger mode
	320
	321	* (((
	322	(% style="color:#037691" %) TDC: (default: 0x001C20)
7.1	323	)))
1.1	324
62.5	325	(((
	326	Uplink interval for the total pulse count, default value is 0x001C20 which is 7200 seconds = 2 hours.
58.1	327
62.5	328
	329	)))
58.1	330
62.5	331	* (((
	332	(% style="color:#037691" %) Disalarm: (default: 0)
	333	)))
1.1	334
62.5	335	(((
62.8	336	(% style="color:blue" %) If Disalarm = 1(%%), CPL03-LB 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.
62.5	337	)))
1.1	338
62.5	339	(((
62.8	340	(% style="color:blue" %) If Disalarm = 0(%%), CPL03-LB will send uplink at every TDC periodically.
1.1	341
62.5	342
	343	)))
1.1	344
62.5	345	* (((
	346	(% style="color:#037691" %) Keep Status & Keep Time
	347	)))
1.1	348
62.5	349	(((
64.4	350	Shows the configure value of [[Alarm Base on Timeout Feature>>\|\|anchor="H3.3.5AlarmBaseonTimeout"]]
1.1	351
62.5	352
	353	)))
1.1	354
62.5	355	* (((
	356	(% style="color:#037691" %) Trigger mode (default: 0)
	357	)))
1.1	358
62.5	359	(((
	360	(% style="color:blue" %) If Trigger mode = 0(%%), count close to open event.
	361	)))
1.1	362
62.5	363	(((
	364	(% style="color:blue" %) If Trigger mode = 1(%%), count open to close event.
	365	)))
1.1	366
64.3	367	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/CPL01%20LoRaWAN%20Outdoor%20PulseContact%20%20Sensor%20Manual/WebHome/1652860064987-743.png?width=730&height=152&rev=1.1\|\|alt="1652860064987-743.png"]]
1.1	368
	369
64.3	370	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/CPL01%20LoRaWAN%20Outdoor%20PulseContact%20%20Sensor%20Manual/WebHome/1652860079526-831.png?width=729&height=209&rev=1.1\|\|alt="1652860079526-831.png"]]
1.1	371
	372
62.5	373	=== 2.3.3 Real-Time Open/Close Status, Uplink FPORT~=2 ===
1.1	374
	375
62.5	376	(((
	377	(((
62.8	378	CPL03-LB will send this uplink after Device Status once join the LoRaWAN network successfully. And CPL03-LB will:
62.5	379	)))
	380	)))
1.1	381
62.5	382	(((
	383	(((
64.5	384	periodically send this uplink every 2 hours, this interval [[can be changed>>\|\|anchor="H3.3.1SetTransmitIntervalTime"]].
62.5	385	)))
	386	)))
1.1	387
62.5	388	(((
	389	(((
	390	Uplink Payload totals 11 bytes.
	391	)))
	392	)))
1.1	393
62.5	394	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:520px" %)
	395	\|=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0; width: 520px;" %)Real-Time Open/Close Status, FPORT=2
	396	\|(% style="width:60px" %)Size(bytes)\|(% style="width:65px" %)1\|(% style="width:65px" %)3\|(% style="width:240px" %)3\|(% style="width:90px" %)4
64.5	397	\|(% style="width:101px" %)Value\|(% style="width:133px" %)Status & [[Alarm>>\|\|anchor="H3.3.5AlarmBaseonTimeout"]]\|(% style="width:92px" %)Total pulse\|(% style="width:247px" %)The last open duration (unit: min)\|(% style="width:149px" %)[[Unix TimeStamp>>\|\|anchor="H2.5.2UnixTimeStamp"]]
1.1	398
62.5	399	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:504px" %)
	400	\|=(% colspan="4" style="background-color:#D9E2F3;color:#0070C0; width: 502px;" %)Status & Alarm field
	401	\|(% style="width:60px" %)Size(bit)\|(% style="width:70px" %)6\|(% style="width:228px" %)1\|(% style="width:146px" %)1
	402	\|(% style="width:76px" %)Value\|(% style="width:80px" %)Calculate Flag\|(% style="width:208px" %)Alarm: 0: No Alarm; 1: Alarm\|(% style="width:136px" %)Contact Status: 0: Open, 1: Close
1.1	403
62.5	404	* (((
	405	(% style="color:#037691" %) Calculate Flag
	406	)))
1.1	407
62.5	408	(((
	409	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.
	410	)))
46.1	411
62.5	412	(((
	413	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.
	414	)))
46.1	415
62.5	416	(((
	417	Default value: 0.
	418	)))
1.1	419
62.5	420	(((
	421	Range (6 bits): (b)000000 ~~ (b) 111111
	422	)))
1.1	423
62.5	424	(((
64.6	425	Refer: [[Set Calculate Flag>>\|\|anchor="H3.3.8Setthecalculateflag"]]
1.1	426
62.5	427
	428	)))
14.22	429
62.5	430	* (((
	431	(% style="color:#037691" %) Alarm
	432	)))
1.1	433
62.5	434	(((
64.6	435	See [[Alarm Base on Timeout>>\|\|anchor="H3.3.5AlarmBaseonTimeout"]]
1.1	436
62.5	437
	438	)))
1.1	439
62.5	440	* (((
	441	(% style="color:#037691" %) Contact Status
	442	)))
10.1	443
62.5	444	(((
	445	0: Open
	446	)))
1.1	447
62.5	448	(((
	449	1: Close
1.1	450
62.5	451
	452	)))
1.1	453
62.5	454	* (((
	455	(% style="color:#037691" %) Total pulse
	456	)))
1.1	457
62.5	458	(((
	459	Total pulse/counting base on dry [[contact trigger event>>\|\|anchor="H2.3.2SensorConfiguration2CFPORT3D4"]]
	460	)))
1.1	461
62.5	462	(((
	463	Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215
1.1	464
62.5	465
	466	)))
1.1	467
44.1	468	* (((
62.5	469	(% style="color:#037691" %) The last open duration
44.1	470	)))
62.5	471
	472	(((
	473	Dry Contact last open duration.
44.1	474	)))
1.1	475
62.5	476	(((
	477	Unit: min.
	478	)))
1.1	479
64.7	480	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/CPL01%20LoRaWAN%20Outdoor%20PulseContact%20%20Sensor%20Manual/WebHome/1652860403792-491.png?width=735&height=153&rev=1.1\|\|alt="1652860403792-491.png"]]
1.1	481
39.5	482
62.5	483	=== 2.3.4 Real-Time Open/Close Status, 3 pulse mode, Uplink FPORT~=6 ===
1.1	484
	485
62.5	486	(% style="color:red" %)Note:
1.1	487
62.5	488	* Firmware support for this mode is not released. If users want to test, please contact Dragino support.
	489	* Users need to run (% style="color:blue" %)AT+MOD=3(%%) to support this model after updating the firmware.
	490	* This mode doesn't support Historical Events and Datalog features.
1.1	491
62.5	492	(% style="color:blue" %)CPL03-LB 3 Pulse Wiring:
1.1	493
64.7	494	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/CPL01%20LoRaWAN%20Outdoor%20PulseContact%20%20Sensor%20Manual/WebHome/image-20221013153352-1.png?width=720&height=628&rev=1.1\|\|alt="image-20221013153352-1.png"]]
1.1	495
	496
62.5	497	(% style="color:blue" %)Payload:
39.5	498
64.7	499	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/CPL01%20LoRaWAN%20Outdoor%20PulseContact%20%20Sensor%20Manual/WebHome/image-20221013153352-2.png?width=1215&height=167&rev=1.1\|\|alt="image-20221013153352-2.png"]]
1.1	500
	501
62.5	502	(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:447px" %)
	503	\|(% style="background-color:#d9e2f3; color:#0070c0; width:95px" %)Size(bytes)\|(% style="background-color:#d9e2f3; color:#0070c0; width:61px" %)1\|(% style="background-color:#d9e2f3; color:#0070c0; width:98px" %)3\|(% style="background-color:#d9e2f3; color:#0070c0; width:98px" %)3\|(% style="background-color:#d9e2f3; color:#0070c0; width:95px" %)3
	504	\|(% style="width:93px" %)Value\|(% style="width:59px" %)Status\|(% style="width:98px" %)(((
	505	Port1 Total Pulse(PB14)
	506	)))\|(% style="width:96px" %)(((
	507	Port2 Total Pulse(PB15)
	508	)))\|(% style="width:94px" %)(((
	509	Port3 Total Pulse(PA4)
	510	)))
1.1	511
62.5	512	(% style="color:blue" %)Status:
1.1	513
62.5	514	(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:257px" %)
	515	\|(% style="background-color:#d9e2f3; color:#0070c0; width:75px" %)Size(bit)\|(% style="background-color:#d9e2f3; color:#0070c0; width:112px" %)6\|(% style="background-color:#d9e2f3; color:#0070c0; width:70px" %)2
	516	\|(% style="width:75px" %)Value\|(% style="width:111px" %)Calculate Flag\|(% style="width:68px" %)Reserve
1.1	517
62.5	518	(% style="color:red" %)Max COUNT for each port is 16777215. Exceed this number will reset to 1.
1.1	519
	520
62.5	521	(% style="color:blue" %)Related AT Command:
1.1	522
62.5	523	(% style="color:#037691" %)AT+TTRMOD1: Port1 count mode; 0: Signal falling edge(Default), 1: Signal raising edge
1.1	524
62.5	525	AT+TTRMOD1=0 Downlink Command: 0xA4 01 00
1.1	526
62.5	527	AT+TTRMOD1=1 Downlink Command: 0xA4 01 01
1.1	528
	529
62.5	530	(% style="color:#037691" %)AT+TTRMOD2: Port2 count mode; 0: Signal falling edge(Default), 1: Signal raising edge
	531
	532	AT+TTRMOD1=0 Downlink Command: 0xA4 02 00
	533
	534	AT+TTRMOD1=1 Downlink Command: 0xA4 02 01
	535
	536
	537	(% style="color:#037691" %)AT+TTRMOD3: Port3 count mode; 0: Signal falling edge(Default), 1: Signal raising edge
	538
	539	AT+TTRMOD1=0 Downlink Command: 0xA4 03 00
	540
	541	AT+TTRMOD1=1 Downlink Command: 0xA4 03 01
	542
	543
	544	(% style="color:#037691" %)AT+CALCFLAG: Calculate Flag ( Default : 0 )
	545
	546	AT+CALCFLAG=aa
	547
	548
	549	(% style="color:blue" %)Downlink Command: 0xA5 aa
	550
	551	(% style="color:#037691" %)AT+COUNTMOD: Accumulative Mode; 0: Accumulative (Default),1: Reset after uplink.
	552
	553	AT+COUNTMOD=0 Downlink Command: 0x0B 00
	554
	555	AT+COUNTMOD=1 Downlink Command: 0x0B 01
	556
	557
	558	(% style="color:#037691" %)AT+SETCNT: Set count value
	559
	560	AT+SETCNT=1,aa Downlink Command: 0xA6 01 aa aa aa
	561
	562	AT+SETCNT=2,aa Downlink Command: 0xA6 02 aa aa aa
	563
	564	AT+SETCNT=3,aa Downlink Command: 0xA6 03 aa aa aa
	565
	566
	567	(% style="color:blue" %)Decode: (%%)[[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]]
	568
	569
	570	=== 2.3.5 Historical Door Open/Close Event, FPORT~=3 ===
	571
	572
55.1	573	(((
64.9	574	CPL03-LB stores sensor values and users can retrieve these history values via the [[downlink command>>\|\|anchor="H2.5DatalogFeature"]].
55.1	575	)))
	576
	577	(((
62.5	578	The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time open/close status.
55.1	579	)))
46.1	580
62.5	581	* (((
62.8	582	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, CPL03-LB will send max bytes according to the current DR and Frequency bands.
62.5	583	)))
46.1	584
62.5	585	(((
	586	For example, in the US915 band, the max payload for different DR is:
	587	)))
1.1	588
62.5	589	(((
	590	a) (% style="color:blue" %)DR0(%%): max is 11 bytes so one entry of data
	591	)))
55.1	592
62.5	593	(((
	594	b) (% style="color:blue" %)DR1(%%): max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
	595	)))
1.1	596
62.5	597	(((
	598	c) (% style="color:blue" %)DR2(%%): total payload includes 11 entries of data
	599	)))
1.1	600
62.5	601	(((
	602	d) (% style="color:blue" %)DR3(%%): total payload includes 22 entries of data.
	603	)))
1.1	604
62.5	605	(((
62.8	606	If CPL03-LB doesn't have any data in the polling time. It will uplink 11 bytes of 0
1.1	607
62.5	608
	609	)))
1.1	610
62.5	611	(% style="color:blue" %) Downlink:
1.1	612
62.5	613	(% class="box" %)
	614	(((
	615	0x31 61 E9 3A D4 61 E9 3D E0 05
	616	)))
1.1	617
64.7	618	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/CPL01%20LoRaWAN%20Outdoor%20PulseContact%20%20Sensor%20Manual/WebHome/1652861353248-624.png?width=720&height=189&rev=1.1\|\|alt="1652861353248-624.png"]]
1.1	619
	620
62.5	621	(% style="color:blue" %) Uplink:
1.1	622
62.5	623	(% class="box" %)
	624	(((
	625	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
	626	)))
1.1	627
62.5	628	(% style="color:#037691" %)
1.1	629
62.5	630	(% style="color:#037691" %)Parsed Value:
1.1	631
62.5	632	(((
	633	[ALARM, PIN_STATUS, TOTAL_PULSE, CALCULATE_FLAG, LAST_OPEN_DURATION, TIME]
	634	)))
1.1	635
62.5	636	(((
	637
	638	)))
1.1	639
62.5	640	(((
	641	[TRUE, CLOSE, 9190, 3, 0, 2022-01-20 10:35:48],
	642	)))
1.1	643
62.5	644	(((
	645	[TRUE, CLOSE, 9190, 3, 0, 2022-01-20 10:36:21],
	646	)))
14.26	647
62.5	648	(((
	649	[FALSE, OPEN, 0, 3, 0, 2022-01-20 10:39:04],
	650	)))
55.1	651
14.44	652	(((
62.5	653	[TRUE, CLOSE, 2, 3, 0, 2022-01-20 10:39:16],
14.44	654	)))
1.1	655
14.44	656	(((
62.5	657	[TRUE, CLOSE, 6, 3, 0, 2022-01-20 10:39:23],
14.44	658	)))
1.1	659
14.44	660	(((
62.5	661	[FALSE, OPEN, 0, 0, 0, 2022-01-20 10:42:25],
14.44	662	)))
1.1	663
14.44	664	(((
62.5	665	[FALSE, OPEN, 0, 0, 0, 2022-01-20 10:42:41],
14.44	666	)))
1.1	667
14.44	668	(((
62.5	669	[FALSE, OPEN, 0, 3, 0, 2022-01-20 10:43:08],
14.44	670	)))
1.1	671
14.44	672	(((
62.5	673	[TRUE, CLOSE, 7, 3, 0, 2022-01-20 10:43:34],
14.44	674	)))
1.1	675
14.44	676	(((
62.5	677	[FALSE, CLOSE, 0, 0, 0, 2022-01-20 10:47:02],
	678
	679
14.44	680	)))
1.1	681
64.7	682	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/CPL01%20LoRaWAN%20Outdoor%20PulseContact%20%20Sensor%20Manual/WebHome/1652861480446-216.png?rev=1.1\|\|alt="1652861480446-216.png"]]
1.1	683
	684
62.5	685	== 2.4 Payload Decoder file ==
1.1	686
	687
62.5	688	In TTN, use can add a custom payload so it shows friendly reading
1.1	689
62.5	690	In the page (% style="color:#037691" %)Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder(%%) to add the decoder from: [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]]
1.1	691
	692
62.5	693	== 2.5 Datalog Feature ==
1.1	694
51.1	695
62.8	696	Datalog Feature is to ensure IoT Server can get all sampling data from Sensor even if the LoRaWAN network is down. For each sampling, CPL03-LB will store the reading for future retrieving purposes.
62.5	697
	698
	699	=== 2.5.1 Ways to get datalog via LoRaWAN ===
	700
	701
64.8	702	Set PNACKMD=1, CPL03-LB will wait for ACK for every uplink, when there is no LoRaWAN network,CPL03-LB will mark these records with non-ack messages and store the sensor data, and it will send all messages (10s interval) after the network recovery.
62.5	703
	704	* (((
62.8	705	a) CPL03-LB will do an ACK check for data records sending to make sure every data arrive server.
62.5	706	)))
	707	* (((
62.8	708	b) CPL03-LB will send data in CONFIRMED Mode when PNACKMD=1, but CPL03-LB won't re-transmit the packet if it doesn't get ACK, it will just mark it as a NONE-ACK message. In a future uplink if CPL03-LB gets a ACK, CPL03-LB will consider there is a network connection and resend all NONE-ACK messages.
62.5	709	)))
	710
	711	Below is the typical case for the auto-update datalog feature (Set PNACKMD=1)
	712
	713	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/WebHome/image-20220703111700-2.png?width=1119&height=381&rev=1.1\|\|alt="图片-20220703111700-2.png" height="381" width="1119"]]
	714
	715
	716	=== 2.5.2 Unix TimeStamp ===
	717
	718
62.8	719	CPL03-LB uses Unix TimeStamp format based on
62.5	720
	721	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/WebHome/image-20220523001219-11.png?width=627&height=97&rev=1.1\|\|alt="图片-20220523001219-11.png" height="97" width="627"]]
	722
	723	User can get this time from link: [[https:~~/~~/www.epochconverter.com/>>url:https://www.epochconverter.com/]] :
	724
	725	Below is the converter example
	726
	727	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/WebHome/image-20220523001219-12.png?width=720&height=298&rev=1.1\|\|alt="图片-20220523001219-12.png" height="298" width="720"]]
	728
	729
	730	So, we can use AT+TIMESTAMP=1611889405 or downlink 3060137afd00 to set the current time 2021 – Jan ~-~- 29 Friday 03:03:25
	731
	732
	733	=== 2.5.3 Set Device Time ===
	734
	735
	736	User need to set (% style="color:blue" %)SYNCMOD=1(%%) to enable sync time via MAC command.
	737
62.8	738	Once CPL03-LB Joined LoRaWAN network, it will send the MAC command (DeviceTimeReq) and the server will reply with (DeviceTimeAns) to send the current time to CPL03-LB. If CPL03-LB fails to get the time from the server, CPL03-LB will use the internal time and wait for next time request (AT+SYNCTDC to set the time request period, default is 10 days).
62.5	739
	740	(% style="color:red" %)Note: LoRaWAN Server need to support LoRaWAN v1.0.3(MAC v1.0.3) or higher to support this MAC command feature, Chirpstack,TTN V3 v3 and loriot support but TTN V3 v2 doesn't support. If server doesn't support this command, it will through away uplink packet with this command, so user will lose the packet with time request for TTN V3 v2 if SYNCMOD=1.
	741
	742
	743	=== 2.5.4 Poll sensor value ===
	744
	745
	746	Users can poll sensor values based on timestamps. Below is the downlink command.
	747
	748	(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:425.818px" %)
	749	\|(% colspan="4" style="background-color:#d9e2f3; color:#0070c0; width:423px" %)Downlink Command to poll Open/Close status (0x31)
	750	\|(% style="width:58px" %)1byte\|(% style="width:127px" %)4bytes\|(% style="width:124px" %)4bytes\|(% style="width:114px" %)1byte
	751	\|(% style="width:58px" %)31\|(% style="width:127px" %)Timestamp start\|(% style="width:124px" %)Timestamp end\|(% style="width:114px" %)Uplink Interval
	752
	753	(((
	754	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.
	755	)))
	756
	757	(((
64.8	758	For example, downlink command [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/CPL01%20LoRaWAN%20Outdoor%20PulseContact%20%20Sensor%20Manual/WebHome/image-20220518162852-1.png?rev=1.1\|\|alt="image-20220518162852-1.png"]]
62.5	759	)))
	760
	761	(((
	762	Is to check 2021/11/12 12:00:00 to 2021/11/12 15:00:00's data
	763	)))
	764
	765	(((
62.8	766	Uplink Internal =5s，means CPL03-LB will send one packet every 5s. range 5~~255s.
62.5	767	)))
	768
	769
1.1	770	== 2.7 Frequency Plans ==
	771
	772
62.8	773	The CPL03-LB uses OTAA mode and below frequency plans by default. If user want to use it with different frequency plan, please refer the AT command sets.
1.1	774
	775	[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]]
	776
	777
62.8	778	= 3. Configure CPL03-LB =
1.1	779
16.4	780	== 3.1 Configure Methods ==
1.1	781
	782
62.8	783	CPL03-LB supports below configure method:
1.1	784
	785	* AT Command via Bluetooth Connection (Recommended): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
11.1	786	* AT Command via UART Connection : See [[UART Connection>>http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H2.3UARTConnectionforSN50v3basemotherboard]].
1.1	787	* LoRaWAN Downlink. Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
	788
	789	== 3.2 General Commands ==
	790
	791
	792	These commands are to configure:
	793
	794	* General system settings like: uplink interval.
	795	* LoRaWAN protocol & radio related command.
	796
	797	They are same for all Dragino Devices which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki:
	798
	799	[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/]]
	800
	801
62.5	802	== 3.3 Commands special design for CPL03-LB ==
1.1	803
	804
62.5	805	These commands only valid for CPL03-LB, as below:
1.1	806
	807
	808	=== 3.3.1 Set Transmit Interval Time ===
	809
	810
62.5	811	(((
1.1	812	Feature: Change LoRaWAN End Node Transmit Interval.
62.5	813	)))
	814
	815	(((
1.1	816	(% style="color:blue" %)AT Command: AT+TDC
62.5	817	)))
1.1	818
14.34	819	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
62.5	820	\|=(% style="width: 156px;background-color:#D9E2F3; color:#0070c0" %)Command Example\|=(% style="width: 137px;background-color:#D9E2F3; color:#0070c0" %)Function\|=(% style="background-color:#D9E2F3; color:#0070c0" %)Response
1.1	821	\|(% style="width:156px" %)AT+TDC=?\|(% style="width:137px" %)Show current transmit Interval\|(((
	822	30000
	823	OK
	824	the interval is 30000ms = 30s
	825	)))
	826	\|(% style="width:156px" %)AT+TDC=60000\|(% style="width:137px" %)Set Transmit Interval\|(((
	827	OK
	828	Set transmit interval to 60000ms = 60 seconds
	829	)))
	830
62.5	831	(((
1.1	832	(% style="color:blue" %)Downlink Command: 0x01
62.5	833	)))
1.1	834
62.5	835	(((
1.1	836	Format: Command Code (0x01) followed by 3 bytes time value.
62.5	837	)))
1.1	838
62.5	839	(((
1.1	840	If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01.
62.5	841	)))
1.1	842
62.5	843	* (((
	844	Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds
	845	)))
	846	* (((
	847	Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
1.1	848
	849
62.5	850
	851	)))
1.1	852
62.5	853	=== 3.3.2 Quit AT Command ===
	854
	855
	856	Feature: Quit AT Command mode, so user needs to input the password again before using AT Commands.
	857
	858	(% style="color:blue" %)AT Command: AT+DISAT
	859
	860	(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:452px" %)
	861	\|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)Command Example\|=(% style="width: 198px;background-color:#D9E2F3;color:#0070C0" %)Function\|=(% style="width: 99px;background-color:#D9E2F3;color:#0070C0" %)Response
	862	\|(% style="width:155px" %)AT+DISAT\|(% style="width:198px" %)Quit AT Commands mode\|(% style="width:96px" %)OK
	863
	864	(% style="color:blue" %)Downlink Command:
	865
	866	No downlink command for this feature.
	867
	868
	869	=== 3.3.3 Get Device Status ===
	870
	871
1.1	872	Send a LoRaWAN downlink to ask device send Alarm settings.
	873
14.31	874	(% style="color:blue" %)Downlink Payload: (%%)0x26 01
1.1	875
	876	Sensor will upload Device Status via FPORT=5. See payload section for detail.
	877
	878
62.5	879	=== 3.3.4 Enable / Disable Alarm ===
1.1	880
39.6	881
62.5	882	Feature: Enable/Disable Alarm for open/close event. Default value 0.
1.1	883
62.5	884	(% style="color:blue" %)AT Command:
1.1	885
62.5	886	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:520px" %)
	887	\|(% style="background-color:#d9e2f3; color:#0070c0; width:154px" %)Command Example\|(% style="background-color:#d9e2f3; color:#0070c0; width:278px" %)Function\|(% style="background-color:#d9e2f3; color:#0070c0; width:88px" %)Response
	888	\|(% style="width:154px" %)AT+DISALARM=1\|(% style="width:278px" %)End node will only send packets in TDC time.\|OK
	889	\|(% style="width:154px" %)AT+DISALARM=0\|(% style="width:278px" %)End node will send packets in TDC time or status change for door sensor\|OK
1.1	890
62.5	891	(% style="color:blue" %)Downlink Command:
1.1	892
62.5	893	0xA7 01 ~/~/ Same As AT+DISALARM=1
1.1	894
62.5	895	0xA7 00 ~/~/ Same As AT+DISALARM=0
1.1	896
	897
62.5	898	=== 3.3.5 Alarm Base on Timeout ===
1.1	899
	900
62.5	901	(((
62.7	902	CPL03-LB 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:
62.5	903	)))
1.1	904
62.7	905
62.5	906	(((
	907	(% style="color:#4f81bd" %)1. Keep Status: Status to be monitor
	908	)))
1.1	909
62.5	910	(((
62.7	911	Keep Status = 1: Monitor Close to Open event
62.5	912	)))
1.1	913
62.5	914	(((
62.7	915	Keep Status = 0: Monitor Open to Close event
62.5	916	)))
1.1	917
62.7	918
62.5	919	(((
	920	(% style="color:#4f81bd" %)2. Keep Time: Timeout to send an Alarm
	921	)))
1.1	922
62.5	923	(((
	924	Range 0 ~~ 65535(0xFFFF) seconds.
	925	)))
1.1	926
62.5	927	(((
64.2	928	If keep time = 0, Disable Alarm Base on Timeout feature.
62.5	929	)))
1.1	930
62.5	931	(((
62.7	932	If keep time > 0, device will monitor the keep status event and send an alarm when status doesn’t change after timeout.
62.5	933	)))
1.1	934
	935
62.5	936	(((
	937	(% style="color:#4f81bd" %)AT Command(%%) to configure:
	938	)))
39.6	939
62.5	940	(((
62.8	941	(% 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. CPL03-LB 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.
62.5	942	)))
1.1	943
62.5	944	(((
	945	(% style="color:blue" %)AT+TTIG=0,0 (%%) ~-~-> Default Value, disable timeout Alarm.
	946	)))
1.1	947
	948
62.5	949	(((
	950	(% style="color:#4f81bd" %)Downlink Command(%%) to configure:
	951	)))
1.1	952
62.5	953	(((
	954	Command: 0xA9 aa bb cc
	955	)))
1.1	956
62.5	957	(((
62.7	958	A9: Command Type Code
62.5	959	)))
1.1	960
62.5	961	(((
62.7	962	aa: status to be monitored
62.5	963	)))
1.1	964
62.5	965	(((
62.7	966	bb cc: timeout.
62.5	967	)))
1.1	968
	969
62.5	970	(((
	971	If user send 0xA9 01 00 1E: equal to AT+TTRIG=1,30
	972	)))
1.1	973
62.5	974	(((
	975	Or
	976	)))
1.1	977
62.5	978	(((
	979	0xA9 00 00 00: Equal to AT+TTRIG=0,0. Disable timeout Alarm.
	980	)))
1.1	981
	982
62.5	983	=== 3.3.6 Clear Flash Record ===
1.1	984
14.45	985
62.5	986	Feature: Clear flash storage for data log feature.
11.1	987
62.7	988	(% style="color:blue" %)AT Command: AT+CLRDTA
62.5	989
	990	(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:500px" %)
	991	\|=(% style="width: 157px;background-color:#D9E2F3;color:#0070C0" %)Command Example\|=(% style="width: 169px;background-color:#D9E2F3;color:#0070C0" %)Function\|=(% style="width: 174px;background-color:#D9E2F3;color:#0070C0" %)Response
	992	\|(% style="width:157px" %)AT+CLRDTA\|(% style="width:169px" %)Clear flash storage for data log feature.\|Clear all stored sensor data… OK
	993
	994	(((
62.7	995	(% style="color:blue" %)Downlink Command:
62.5	996	)))
	997
	998	(((
	999	* Example: 0xA301 ~/~/ Same as AT+CLRDTA
	1000	)))
	1001
	1002
	1003
	1004	=== 3.3.7 Set trigger mode ===
	1005
	1006
	1007	Feature: Set the trigger interrupt mode.
	1008
62.6	1009	(% style="color:blue" %)AT Command: AT+TTRMOD
62.5	1010
	1011	(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:495px" %)
	1012	\|=(% style="width: 157px;background-color:#D9E2F3;color:#0070C0" %)Command Example\|=(% style="width: 246px;background-color:#D9E2F3;color:#0070C0" %)Function\|=(% style="width: 92px;background-color:#D9E2F3;color:#0070C0" %)Response
	1013	\|(% style="width:157px" %)(((
	1014	AT+TTRMOD=1
	1015	)))\|(% style="width:156px" %)Count and trigger from open to close (rising edge)\|(% style="width:89px" %)(((
	1016	(((
	1017	OK
	1018	)))
	1019	)))
	1020	\|(% style="width:157px" %)(((
	1021	AT+TTRMOD=0
	1022	)))\|(% style="width:156px" %)Count and trigger from close to open (falling edge)\|(% style="width:89px" %)(((
	1023	OK
	1024	)))
	1025
62.6	1026	(% style="color:blue" %)Downlink Command:
62.5	1027
	1028	* Example: 0xA401 ~/~/ Same as AT+ TTRMOD =1
	1029
	1030	=== 3.3.8 Set the calculate flag ===
	1031
	1032
	1033	Feature: Set the calculate flag
	1034
62.6	1035	(% style="color:blue" %)AT Command: AT+CALCFLAG
62.5	1036
	1037	(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:461px" %)
	1038	\|=(% style="width: 158px;background-color:#D9E2F3;color:#0070C0" %)Command Example\|=(% style="width: 193px;background-color:#D9E2F3;color:#0070C0" %)Function\|=(% style="width: 110px;background-color:#D9E2F3;color:#0070C0" %)Response
	1039	\|(% style="width:158px" %)AT+CALCFLAG =1\|(% style="width:192px" %)Set the calculate flag to 1.\|(% style="width:109px" %)OK
	1040	\|(% style="width:158px" %)AT+CALCFLAG =2\|(% style="width:192px" %)Set the calculate flag to 2.\|(% style="width:109px" %)OK
	1041
62.6	1042	(% style="color:blue" %)Downlink Command:
62.5	1043
	1044	* Example: 0XA501 ~/~/ Same as AT+CALCFLAG =1
	1045
	1046	=== 3.3.9 Set count number ===
	1047
	1048
	1049	Feature: Manually set the count number
	1050
62.6	1051	(% style="color:blue" %)AT Command: AT+SETCNT
62.5	1052
	1053	(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:479px" %)
	1054	\|=(% style="width: 160px;background-color:#D9E2F3;color:#0070C0" %)Command Example\|=(% style="width: 223px;background-color:#D9E2F3;color:#0070C0" %)Function\|=(% style="width: 96px;background-color:#D9E2F3;color:#0070C0" %)Response
	1055	\|(% style="width:160px" %)AT+ SETCNT =0\|(% style="width:221px" %)Set the count number to 0.\|(% style="width:95px" %)OK
	1056	\|(% style="width:160px" %)AT+ SETCNT =100\|(% style="width:221px" %)Set the count number to 100.\|(% style="width:95px" %)OK
	1057
62.6	1058	(% style="color:blue" %)Downlink Command:
62.5	1059
	1060	* Example: 0xA6000001 ~/~/ Same as AT+ SETCNT =1
62.6	1061
62.5	1062	* Example: 0xA6000064 ~/~/ Same as AT+ SETCNT =100
	1063
	1064	=== 3.3.10 Set Interrupt Mode ===
	1065
	1066
43.1	1067	Feature, Set Interrupt mode for PA8 of pin.
1.1	1068
46.1	1069	When AT+INTMOD=0 is set, PA8 is used as a digital input port.
	1070
1.1	1071	(% style="color:blue" %)AT Command: AT+INTMOD
	1072
14.34	1073	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
62.5	1074	\|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)Command Example\|=(% style="width: 197px;background-color:#D9E2F3;color:#0070C0" %)Function\|=(% style="width: 158px;background-color:#D9E2F3;color:#0070C0" %)Response
1.1	1075	\|(% style="width:154px" %)AT+INTMOD=?\|(% style="width:196px" %)Show current interrupt mode\|(% style="width:157px" %)(((
	1076	0
	1077	OK
	1078	the mode is 0 =Disable Interrupt
	1079	)))
	1080	\|(% style="width:154px" %)AT+INTMOD=2\|(% style="width:196px" %)(((
	1081	Set Transmit Interval
	1082	0. (Disable Interrupt),
	1083	~1. (Trigger by rising and falling edge)
	1084	2. (Trigger by falling edge)
	1085	3. (Trigger by rising edge)
	1086	)))\|(% style="width:157px" %)OK
	1087
	1088	(% style="color:blue" %)Downlink Command: 0x06
	1089
	1090	Format: Command Code (0x06) followed by 3 bytes.
	1091
	1092	This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
	1093
	1094	* Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode
62.6	1095
1.1	1096	* Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger
	1097
62.5	1098	=== 3.3.11 Set Power Output Duration ===
	1099
	1100
41.1	1101	Control the output duration 5V . Before each sampling, device will
	1102
	1103	~1. first enable the power output to external sensor,
	1104
	1105	2. keep it on as per duration, read sensor value and construct uplink payload
	1106
	1107	3. final, close the power output.
	1108
	1109	(% style="color:blue" %)AT Command: AT+5VT
	1110
	1111	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
62.5	1112	\|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)Command Example\|=(% style="width: 197px;background-color:#D9E2F3;color:#0070C0" %)Function\|=(% style="width: 158px;background-color:#D9E2F3;color:#0070C0" %)Response
41.1	1113	\|(% style="width:154px" %)AT+5VT=?\|(% style="width:196px" %)Show 5V open time.\|(% style="width:157px" %)0 (default)
	1114	OK
	1115	\|(% style="width:154px" %)AT+5VT=500\|(% style="width:196px" %)Close after a delay of 1000 milliseconds.\|(% style="width:157px" %)OK
	1116
	1117	(% style="color:blue" %)Downlink Command: 0x07
	1118
	1119	Format: Command Code (0x07) followed by 2 bytes.
	1120
	1121	The first and second bytes are the time to turn on.
	1122
	1123	* Example 1: Downlink Payload: 070000 ~-~--> AT+5VT=0
62.7	1124
41.1	1125	* Example 2: Downlink Payload: 0701F4 ~-~--> AT+5VT=500
	1126
16.4	1127	= 4. Battery & Power Consumption =
14.45	1128
1.1	1129
62.7	1130	CPL03-LB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
1.1	1131
	1132	[[Battery Info & Power Consumption Analyze>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
	1133
	1134
16.4	1135	= 5. OTA Firmware update =
1.1	1136
	1137
13.1	1138	(% class="wikigeneratedid" %)
62.7	1139	User can change firmware CPL03-LB to:
1.1	1140
13.1	1141	* Change Frequency band/ region.
62.7	1142
13.1	1143	* Update with new features.
62.7	1144
13.1	1145	* Fix bugs.
1.1	1146
31.1	1147	Firmware and changelog can be downloaded from : [[Firmware download link>>url:https://www.dropbox.com/sh/kwqv57tp6pejias/AAAopYMATh1GM6fZ-VRCLrpDa?dl=0]]
1.1	1148
31.1	1149	Methods to Update Firmware:
1.1	1150
31.1	1151	* (Recommanded way) OTA firmware update via wireless: [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/]]
62.7	1152
39.6	1153	* Update through UART TTL interface. [[Instruction>>url:http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H1.LoRaSTv4baseHardware]].
1.1	1154
31.1	1155	= 6. FAQ =
1.1	1156
62.7	1157	== 6.1 AT Commands input doesn't work ==
1.1	1158
	1159
62.7	1160	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.
	1161
	1162
31.1	1163	= 7. Order Info =
1.1	1164
	1165
62.7	1166	Part Number: (% style="color:blue" %)CPL03-LB-XXX
1.1	1167
62.7	1168	(% style="color:red" %)XXX(%%): The default frequency band
1.1	1169
38.1	1170	* (% style="color:red" %)AS923(%%): LoRaWAN AS923 band
1.1	1171
38.1	1172	* (% style="color:red" %)AU915(%%): LoRaWAN AU915 band
1.1	1173
38.1	1174	* (% style="color:red" %)EU433(%%): LoRaWAN EU433 band
1.1	1175
38.1	1176	* (% style="color:red" %)EU868(%%): LoRaWAN EU868 band
1.1	1177
38.1	1178	* (% style="color:red" %)KR920(%%): LoRaWAN KR920 band
1.1	1179
38.1	1180	* (% style="color:red" %)US915(%%): LoRaWAN US915 band
1.1	1181
38.1	1182	* (% style="color:red" %)IN865(%%): LoRaWAN IN865 band
1.1	1183
38.1	1184	* (% style="color:red" %)CN470(%%): LoRaWAN CN470 band
1.1	1185
31.1	1186	= 8. Packing Info =
1.1	1187
39.6	1188
39.1	1189	(% style="color:#037691" %)Package Includes:
1.1	1190
62.7	1191	* CPL03-LB LoRaWAN Pulse/Contact Sensor
1.1	1192
39.1	1193	(% style="color:#037691" %)Dimension and weight:
1.1	1194
31.1	1195	* Device Size: cm
1.1	1196
31.1	1197	* Device Weight: g
1.1	1198
31.1	1199	* Package Size / pcs : cm
1.1	1200
31.1	1201	* Weight / pcs : g
1.1	1202
31.1	1203	= 9. Support =
1.1	1204
	1205
31.1	1206	* 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.
39.6	1207
	1208	* 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.cc>>mailto:Support@dragino.cc]].

Wiki source code of SW3L-LB -- LoRaWAN Flow Sensor User Manual

Applications