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

Last modified by Edwin Chen on 2024/04/23 08:31

version	line-number	content
99.2	1	(% style="display:none" %)
1.1	2
99.2	3	(% style="text-align:center" %)
	4	[[image:image-20240108093525-3.png]]
1.1	5
67.2	6
	7
	8
80.2	9
99.3	10	Table of Contents :
30.1	11
1.1	12	{{toc/}}
	13
	14
	15
	16
	17
	18
31.1	19	= 1. Introduction =
1.1	20
99.10	21	== 1.1 What is SW3L-LB/LS LoRaWAN Flow Sensor ==
1.1	22
39.6	23
99.10	24	The Dragino SW3L-LB/LS 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	25
99.10	26	The SW3L-LB/LS 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	27
99.10	28	SW3L-LB/LS 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	29
99.10	30	The LoRa wireless technology used in SW3L-LB/LS 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	31
99.10	32	SW3L-LB/LS (% style="color:blue" %)supports BLE configure(%%) and (% style="color:blue" %)wireless OTA update(%%) which make user easy to use.
62.4	33
99.10	34	SW3L-LB/LS is powered by (% style="color:blue" %)8500mAh Li-SOCI2 battery (%%)or (% style="color:blue" %)solar powered + li-on battery(%%), it is designed for long term use up to 5 years.
1.1	35
99.10	36	Each SW3L-LB/LS 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	37
66.2	38	[[image:image-20230530135919-1.png\|\|height="404" width="806"]]
64.2	39
	40
1.1	41	== 1.2 Features ==
	42
39.6	43
1.1	44	* LoRaWAN 1.0.3 Class A
62.4	45	* Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865
1.1	46	* Ultra-low power consumption
67.4	47	* Upload water flow volume
	48	* Monitor water waste
	49	* AT Commands to change parameters
62.4	50	* supports Datalog feature
1.1	51	* Support Bluetooth v5.1 and LoRaWAN remote configure
	52	* Support wireless OTA update firmware
62.4	53	* Uplink on periodically and open/close event
1.1	54	* Downlink to change configure
99.7	55	* 8500mAh Li/SOCl2 Battery (SW3L-LB)
	56	* Solar panel + 3000mAh Li-on battery (SW3L-LS)
1.1	57
	58	== 1.3 Specification ==
	59
	60
	61	(% style="color:#037691" %)Common DC Characteristics:
	62
99.7	63	* Supply Voltage: Built-in Battery , 2.5v ~~ 3.6v
1.1	64	* Operating Temperature: -40 ~~ 85°C
	65
	66	(% style="color:#037691" %)LoRa Spec:
	67
	68	* Frequency Range, Band 1 (HF): 862 ~~ 1020 Mhz
	69	* Max +22 dBm constant RF output vs.
	70	* RX sensitivity: down to -139 dBm.
	71	* Excellent blocking immunity
	72
	73	(% style="color:#037691" %)Battery:
	74
	75	* Li/SOCI2 un-chargeable battery
	76	* Capacity: 8500mAh
	77	* Self-Discharge: <1% / Year @ 25°C
	78	* Max continuously current: 130mA
	79	* Max boost current: 2A, 1 second
	80
	81	(% style="color:#037691" %)Power Consumption
	82
	83	* Sleep Mode: 5uA @ 3.3v
	84	* LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm
	85
62.4	86	== 1.4 Applications ==
1.1	87
62.4	88
67.4	89	* Flow Sensor application
	90	* Water Control
	91	* Toilet Flow Sensor
	92	* Monitor Waste water
62.4	93
	94	== 1.5 Sleep mode and working mode ==
	95
	96
1.1	97	(% 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.
	98
	99	(% 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.
	100
	101
62.9	102	== 1.6 Button & LEDs ==
1.1	103
	104
99.7	105	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/RS485-LB_Waterproof_RS485UART_to_LoRaWAN_Converter/WebHome/image-20240103160425-4.png?rev=1.1\|\|alt="image-20240103160425-4.png"]]
1.1	106
14.13	107	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
99.14	108	\|=(% style="width: 167px;background-color:#4F81BD;color:white" %)Behavior on ACT\|=(% style="width: 117px;background-color:#4F81BD;color:white" %)Function\|=(% style="width: 226px;background-color:#4F81BD;color:white" %)Action
1.1	109	\|(% style="width:167px" %)Pressing ACT between 1s < time < 3s\|(% style="width:117px" %)Send an uplink\|(% style="width:225px" %)(((
	110	If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, (% style="color:blue" %)blue led (%%)will blink once.
	111	Meanwhile, BLE module will be active and user can connect via BLE to configure device.
	112	)))
	113	\|(% style="width:167px" %)Pressing ACT for more than 3s\|(% style="width:117px" %)Active Device\|(% style="width:225px" %)(((
	114	(% 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.
	115	(% style="color:green" %)Green led(%%) will solidly turn on for 5 seconds after joined in network.
	116	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.
	117	)))
6.1	118	\|(% 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	119
62.9	120	== 1.7 BLE connection ==
1.1	121
	122
99.11	123	SW3L-LB/LS support BLE remote configure.
1.1	124
	125
	126	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:
	127
	128	* Press button to send an uplink
	129	* Press button to active device.
	130	* Device Power on or reset.
	131
	132	If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode.
	133
	134
62.9	135	== 1.8 Pin Definitions ==
1.1	136
89.2	137
75.1	138	[[image:image-20230614172344-1.png]]
1.1	139
43.1	140
67.4	141	== 1.9 Flow Sensor Spec ==
43.1	142
	143
67.4	144	(((
106.1	145	(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:778px" %)
	146	\|=(% style="width: 103px; background-color:#4F81BD; color: white;" %)Model\|=(% style="width: 133px; background-color: rgb(79, 129, 189); color: white;" %)SW3L-002-FE\|=(% style="width: 135px; background-color: rgb(79, 129, 189); color: white;" %)SW3L-004\|=(% style="width: 150px; background-color: rgb(79, 129, 189); color: white;" %)SW3L-006\|=(% style="width: 120px; background-color: rgb(79, 129, 189); color: white;" %)SW3L-010\|=(% style="width: 151px; background-color: rgb(79, 129, 189); color: white;" %)SW3L-020
	147	\|(% style="width:152px" %)Probe #\|(% style="width:133px" %)DW-002-FE\|(% style="width:135px" %)DW-004\|(% style="width:150px" %)DW-006\|(% style="width:120px" %)DW-010\|(% style="width:151px" %)DW-020
	148	\|(% style="width:152px" %)Diameter\|(% style="width:133px" %)G1/4" / DN10\|(% style="width:135px" %)G1/2" / DN15\|(% style="width:150px" %)G3/4" / DN20\|(% style="width:120px" %)G1" / DN25\|(% style="width:151px" %)G2" / DN50
	149	\|(% style="width:152px" %)Working Range\|(% style="width:133px" %)0.3 ~~ 6L/min\|(% style="width:135px" %)1~~30L/min\|(% style="width:150px" %)1~~60L/min\|(% style="width:120px" %)2~~100L/min\|(% style="width:151px" %)10~~300L/min
	150	\|(% style="width:152px" %)Measure\|(% style="width:133px" %)1377 pulse = 1L\|(% style="width:135px" %)450 pulse = 1 L\|(% style="width:150px" %)390 pulse = 1 L\|(% style="width:120px" %)64 pulse = 1 L\|(% style="width:151px" %)12 pulse = 1 L
	151	\|(% style="width:152px" %)Accurancy\|(% style="width:133px" %)±5%\|(% style="width:135px" %)±5%\|(% style="width:150px" %)±5%\|(% style="width:120px" %)±5%\|(% style="width:151px" %)±5%
	152	\|(% style="width:152px" %)Power Consumption\|(% style="width:133px" %)1uA, 3.6v (Sensor Only)\|(% style="width:135px" %)1uA, 3.6v (Sensor Only)\|(% style="width:150px" %)1uA, 3.6v (Sensor Only)\|(% style="width:120px" %)1uA, 3.6v (Sensor Only)\|(% style="width:151px" %)1uA, 3.6v (Sensor Only)
	153	\|(% style="width:152px" %)Max Pressure\|(% style="width:133px" %)≤0.8Mpa\|(% style="width:135px" %)≤ 1.75Mpa\|(% style="width:150px" %)≤ 1.75Mpa \|(% style="width:120px" %)≤ 1.75Mpa\|(% style="width:151px" %)≤ 1.75Mpa
	154	\|(% style="width:152px" %)Temperature range\|(% style="width:133px" %)<80°C\|(% style="width:135px" %)<80°C\|(% style="width:150px" %)<80°C\|(% style="width:120px" %)<80°C\|(% style="width:151px" %)<80°C
	155	\|(% style="width:152px" %)Humidity Range\|(% style="width:133px" %)35%~~90%RH (no frost)\|(% style="width:135px" %)35%~~90%RH (no frost)\|(% style="width:150px" %)35%~~90%RH (no frost)\|(% style="width:120px" %)35%~~90%RH (no frost)\|(% style="width:151px" %)35%~~90%RH (no frost)
67.4	156	)))
	157
107.1	158	(% style="color:red" %)Notice: SW3L-002-FE model is none off-shore model, only valid with MOQ of 200pcs ordering.
67.4	159
107.1	160
77.1	161	== 1.10 Mechanical ==
67.4	162
99.7	163	=== 1.10.1 for LB version ===
67.4	164
99.7	165	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/DDS75-LB_LoRaWAN_Distance_Detection_Sensor_User_Manual/WebHome/image-20240105152536-3.png?rev=1.1\|\|alt="image-20240105152536-3.png"]]
1.1	166
	167
106.1	168	(% style="color:blue" %)002-FE: diameter: G1/4” / DN10. 1377 pulse = 1 L
	169
	170	[[image:image-20240209233838-1.png]]
	171
	172
104.4	173	(% style="color:blue" %)004: DW-004 Flow Sensor: diameter: G1/2” / DN15. 450 pulse = 1 L
67.4	174
	175	[[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"]]
	176
	177
	178	(% style="color:blue" %)006: DW-006 Flow Sensor: diameter: G3/4” / DN20. 390 pulse = 1 L
	179
	180	[[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"]]
	181
	182
	183	(% style="color:blue" %)010: DW-010 Flow Sensor: diameter: G 1” / DN25. 64 pulse = 1 L
	184
	185	[[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"]]
	186
	187
95.4	188	(% style="color:blue" %)020: DW-020 Flow Sensor: diameter: G 2”/ DN50. 12 pulse = 1 L
95.1	189
104.2	190	[[image:image-20240125090731-1.png]]
95.1	191
	192
99.7	193	=== 1.10.2 for LS version ===
	194
	195
	196	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SN50v3-LB/WebHome/image-20231231203439-3.png?width=886&height=385&rev=1.1\|\|alt="image-20231231203439-3.png"]]
	197
	198
99.12	199	= 2. Configure SW3L-LB/LS to connect to LoRaWAN network =
1.1	200
	201	== 2.1 How it works ==
	202
	203
99.12	204	The SW3L-LB/LS 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/LS. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 20 minutes.
1.1	205
64.2	206	(% style="display:none" %) (%%)
1.1	207
	208	== 2.2 Quick guide to connect to LoRaWAN server (OTAA) ==
	209
	210
	211	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.
	212
62.5	213	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	214
66.2	215	[[image:image-20230530135929-2.png\|\|height="404" width="806"]](% style="display:none" %)
1.1	216
64.2	217
99.13	218	(% style="color:blue" %)Step 1:(%%) Create a device in TTN with the OTAA keys from SW3L-LB/LS.
1.1	219
99.13	220	Each SW3L-LB/LS is shipped with a sticker with the default device EUI as below:
1.1	221
30.1	222	[[image:image-20230426084152-1.png\|\|alt="图片-20230426084152-1.png" height="233" width="502"]]
1.1	223
	224
	225	You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
	226
	227
	228	(% style="color:blue" %)Register the device
	229
14.13	230	[[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	231
	232
	233	(% style="color:blue" %)Add APP EUI and DEV EUI
	234
30.1	235	[[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	236
	237
	238	(% style="color:blue" %)Add APP EUI in the application
	239
	240
30.1	241	[[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	242
	243
	244	(% style="color:blue" %)Add APP KEY
	245
30.1	246	[[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	247
	248
99.13	249	(% style="color:blue" %)Step 2:(%%) Activate on SW3L-LB/LS
1.1	250
	251
99.13	252	Press the button for 5 seconds to activate the SW3L-LB/LS.
6.1	253
1.1	254	(% 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.
	255
	256	After join success, it will start to upload messages to TTN and you can see the messages in the panel.
	257
	258
	259	== 2.3 Uplink Payload ==
	260
	261	=== 2.3.1 Device Status, FPORT~=5 ===
	262
	263
99.13	264	Include device configure status. Once SW3L-LB/LS Joined the network, it will uplink this message to the server. After that, SW3L-LB/LS will uplink Device Status every 12 hours.
1.1	265
99.13	266	Users can also use the downlink command(0x26 01) to ask SW3L-LB/LS to resend this uplink. This uplink payload also includes the DeviceTimeReq to get time.
67.6	267
1.1	268	The Payload format is as below.
	269
14.15	270	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
99.20	271	\|(% colspan="6" style="background-color:#4f81bd; color:white" %)Device Status (FPORT=5)
1.1	272	\|(% style="width:103px" %)Size (bytes)\|(% style="width:72px" %)1\|2\|(% style="width:91px" %)1\|(% style="width:86px" %)1\|(% style="width:44px" %)2
96.5	273	\|(% 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
1.1	274
	275	Example parse in TTNv3
	276
75.1	277	[[image:image-20230614172520-3.png\|\|height="169" width="869"]]
1.1	278
	279
99.13	280	(% style="color:#037691" %)Sensor Model(%%): For SW3L-LB/LS, this value is 0x1F
1.1	281
	282	(% style="color:#037691" %)Firmware Version(%%): 0x0100, Means: v1.0.0 version
	283
	284	(% style="color:#037691" %)Frequency Band:
	285
77.10	286	0x01: EU868
1.1	287
77.10	288	0x02: US915
1.1	289
77.10	290	0x03: IN865
1.1	291
77.10	292	0x04: AU915
1.1	293
77.10	294	0x05: KZ865
1.1	295
77.10	296	0x06: RU864
1.1	297
77.10	298	0x07: AS923
1.1	299
77.10	300	0x08: AS923-1
1.1	301
77.10	302	0x09: AS923-2
1.1	303
77.10	304	0x0a: AS923-3
1.1	305
77.10	306	0x0b: CN470
1.1	307
77.10	308	0x0c: EU433
1.1	309
77.10	310	0x0d: KR920
1.1	311
77.10	312	0x0e: MA869
1.1	313
	314
	315	(% style="color:#037691" %)Sub-Band:
	316
	317	AU915 and US915:value 0x00 ~~ 0x08
	318
	319	CN470: value 0x0B ~~ 0x0C
	320
	321	Other Bands: Always 0x00
	322
	323
	324	(% style="color:#037691" %)Battery Info:
	325
	326	Check the battery voltage.
	327
	328	Ex1: 0x0B45 = 2885mV
	329
	330	Ex2: 0x0B49 = 2889mV
	331
	332
62.5	333	=== 2.3.2 Sensor Configuration, FPORT~=4 ===
1.1	334
	335
99.13	336	SW3L-LB/LS will only send this command after getting the downlink command (0x26 02) from the server.
1.1	337
77.10	338	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
99.20	339	\|(% style="background-color:#4f81bd; color:white; width:70px" %) Size(bytes)\|(% style="background-color:#4f81bd; color:white; width:105px" %)3\|(% style="background-color:#4f81bd; color:white; width:60px" %)1\|(% style="background-color:#4f81bd; color:white; width:96px" %)1\|(% style="background-color:#4f81bd; color:white; width:105px" %)2\|(% style="background-color:#4f81bd; color:white; width:74px" %)1
96.3	340	\|Value\|(% style="width:104px" %)TDC(unit:sec)\|(% style="width:43px" %)N/A\|(% style="width:91px" %)Stop Timer\|(% style="width:100px" %)Alarm Timer\|(% style="width:69px" %)Reserve
62.5	341
90.1	342	Example parse in TTNv3
	343
	344	[[image:image-20230614172555-4.png\|\|height="151" width="853"]]
	345
	346
88.2	347	* (% style="color:blue" %)TDC: (default: 0x0004B0)
1.1	348
67.7	349	Uplink interval for the total pulse count, default value is 0x0004B0 which is 1200 seconds = 20 minutes.
58.1	350
	351
88.2	352	* (% style="color:blue" %)STOP Duration & Alarm Timer
1.1	353
67.14	354	Shows the configure value of [[Alarm for continuously water flow>>\|\|anchor="H3.3.4Alarmforcontinuouslywaterflow"]]
1.1	355
	356
67.7	357	=== 2.3.3 Water Flow Value, Uplink FPORT~=2 ===
1.1	358
67.7	359
62.5	360	(((
99.13	361	SW3L-LB/LS will send this uplink after Device Status once join the LoRaWAN network successfully. And SW3L-LB/LS will:
62.5	362	)))
1.1	363
62.5	364	(((
67.14	365	periodically send this uplink every 20 minutes, this interval [[can be changed>>\|\|anchor="H3.3.1SetTransmitIntervalTime"]].
62.5	366	)))
1.1	367
62.5	368	(((
67.7	369	Uplink Payload totals 11 bytes.
62.5	370	)))
1.1	371
86.2	372	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
99.15	373	\|=(% colspan="6" style="width: 515px; background-color:#4F81BD;color:white" %)Water Flow Value, FPORT=2
86.4	374	\|(% style="width:50px" %)Size(bytes)\|(% style="width:110px" %)1\|(% style="width:120px" %)4\|(% style="width:110px" %)1\|(% style="width:55px" %)1\|(% style="width:70px" %)4
96.5	375	\|(% style="width:110px" %)Value\|(% style="width:81px" %)Calculate Flag & [[Alarm>>\|\|anchor="H3.3.4Alarmforcontinuouslywaterflow"]]\|(% style="width:95px" %)(((
67.7	376	Total pulse Or Last Pulse
86.1	377	)))\|(% style="width:78px" %)(((
86.2	378	MOD & PA4_status & PB15_status
86.1	379	)))\|(% style="width:92px" %)Reserve(0x01)\|(% style="width:134px" %)[[Unix TimeStamp>>\|\|anchor="H2.5.2UnixTimeStamp"]]
	380
81.1	381	Calculate Flag & Alarm:
76.1	382
79.2	383	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
99.20	384	\|(% style="background-color:#4f81bd; color:white; width:70px" %)Size(bit)\|(% style="background-color:#4f81bd; color:white; width:70px" %)[bit7:bit6]\|(% style="background-color:#4f81bd; color:white; width:90px" %)[bit5:bit2]\|(% style="background-color:#4f81bd; color:white; width:140px" %)bit1\|(% style="background-color:#4f81bd; color:white; width:130px" %)bit0
96.4	385	\|(% style="width:88px" %)Value\|(% style="width:117px" %)Reserve\|(% style="width:117px" %)Calculate Flag\|(% style="width:169px" %)Alarm: 0: No Alarm; 1: Alarm\|(% style="width:150px" %)TDC flag 0:No;1:Yes
1.1	386
86.1	387	MOD & PA4_status & PB15_status:
1.1	388
86.6	389	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:230px" %)
99.20	390	\|(% style="background-color:#4f81bd; color:white; width:50px" %)Size(bit)\|(% style="background-color:#4f81bd; color:white; width:60px" %)bit7\|(% style="background-color:#4f81bd; color:white; width:60px" %)bit6\|(% style="background-color:#4f81bd; color:white; width:60px" %)[bit5:bit0]
96.4	391	\|(% style="width:88px" %)Value\|(% style="width:117px" %)PA4_status\|(% style="width:117px" %)PB15_status\|(% style="width:118px" %)MOD
86.1	392
85.1	393	(% style="color:#037691" %) [[image:image-20230626093242-1.png\|\|height="276" width="892"]]
1.1	394
86.1	395
67.7	396	* (((
88.3	397	(% style="color:blue" %)Calculate Flag
62.5	398	)))
1.1	399
62.5	400	(((
67.7	401	The calculate flag is a user defined field, IoT server can use this flag to handle different meters with different pulse factors. For example, if there are 100 Flow Sensors, meters 1 ~~50 are 1 liter/pulse and meters 51 ~~ 100 has 1.5 liter/pulse.
80.2	402
	403
62.5	404	)))
1.1	405
62.5	406	(((
67.7	407	Example: in the default payload:
62.5	408	)))
1.1	409
62.5	410	* (((
67.7	411	calculate flag=0: for SW3L-004 Flow Sensor: 450 pulse = 1 L
62.5	412	)))
67.7	413	* (((
	414	calculate flag=1: for SW3L-006 Flow Sensor: 390 pulse = 1 L
62.5	415	)))
67.7	416	* (((
	417	calculate flag=2: for SW3L-010 Flow Sensor: 64 pulse = 1 L
62.5	418	)))
96.1	419	* (((
	420	calculate flag=3: for SW3L-010 Flow Sensor: 12 pulse = 1 L
	421	)))
46.1	422
62.5	423	(((
	424	Default value: 0.
	425	)))
1.1	426
62.5	427	(((
79.1	428	Range (4 bits): (b)0000 ~~ (b) 1111
67.7	429
	430	If user use with a meter for example is 0.02L/pulse. To proper decode the correct value in server,
	431
	432	1) User can set the Calculate Flag of this sensor to 3.
	433
	434	2) In server side, when a sensor data arrive, the decoder will check the value of Calculate Flag, It the value is 3, the total volume = 0.02 x Pulse Count.
62.5	435	)))
1.1	436
62.5	437	(((
88.5	438	(% style="color:red" %)NOTE: User need to set Calculate Flag to proper value before use Flow Sensor. Downlink or AT Command see: (%%)Refer: [[Set Calculate Flag>>\|\|anchor="H3.3.5Setthecalculateflag"]]
77.1	439
77.11	440	(((
89.1	441
62.5	442	)))
77.1	443	)))
14.22	444
77.5	445
62.5	446	* (((
88.4	447	(% style="color:blue" %)Alarm
62.5	448	)))
1.1	449
62.5	450	(((
67.16	451	See [[Alarm for continuously water flow>>\|\|anchor="H3.3.4Alarmforcontinuouslywaterflow"]]
62.5	452	)))
1.1	453
67.7	454	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L%20LoRaWAN%20Outdoor%20Flow%20Sensor/WebHome/image-20220519095946-4.png?width=724&height=65&rev=1.1\|\|alt="image-20220519095946-4.png"]]
	455
	456
89.1	457	(((
	458	* (% style="color:blue" %)TDC flag
	459
	460	When the flag is 1, it means sending packets at normal time intervals.
	461
	462	Otherwise, it is a packet sent at non-TDC time.
	463
	464
	465	)))
	466
62.5	467	* (((
88.4	468	(% style="color:blue" %)Total pulse
62.5	469	)))
10.1	470
62.5	471	(((
67.7	472	Total pulse/counting since factory
62.5	473	)))
1.1	474
62.5	475	(((
67.7	476	Range (4 Bytes) : 0x00000000~~ 0xFFFFFFFF .
77.11	477
	478
62.5	479	)))
1.1	480
62.5	481	* (((
88.4	482	(% style="color:blue" %)Last Pulse
62.5	483	)))
1.1	484
62.5	485	(((
67.7	486	Total pulse since last FPORT=2 uplink. (Default 20 minutes)
62.5	487	)))
1.1	488
62.5	489	(((
77.5	490	Range (4 Bytes) : 0x00000000~~ 0xFFFFFFFF .
77.11	491
86.1	492
	493	* (((
88.4	494	(% style="color:blue" %)PA4_status: Support digital level input below 3.3V
86.1	495	)))
	496
	497	(((
	498	0 ~-~-> PA4 is at low level.
	499	)))
	500
	501	(((
	502	1 ~-~-> PA4 is at high level.
	503
	504
	505	* (((
88.4	506	(% style="color:blue" %)PB15_status: Support digital level input below 3.3V
86.1	507	)))
	508
	509	(((
	510	0 ~-~-> PB15 is at low level.
	511	)))
	512
	513	(((
	514	1 ~-~-> PB15 is at high level..
	515
77.11	516
62.5	517	)))
86.1	518	)))
	519	)))
1.1	520
44.1	521	* (((
88.4	522	(% style="color:blue" %)MOD: Default =0
44.1	523	)))
62.5	524
	525	(((
67.7	526	MOD=0 ~-~-> Uplink Total Pulse since factory
44.1	527	)))
1.1	528
62.5	529	(((
77.5	530	MOD=1 ~-~-> Uplink total pulse since last FPORT=2 uplink.
77.11	531
	532
62.5	533	)))
1.1	534
67.7	535	* (((
88.4	536	(% style="color:blue" %)Water Flow Value
67.7	537	)))
1.1	538
67.7	539	(((
	540	Total Water Flow Volume = (Calculate Flag) x (Total Pulse)=9597/450=21.3L
	541	)))
39.5	542
67.7	543	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L%20LoRaWAN%20Outdoor%20Flow%20Sensor/WebHome/image-20220519095946-5.png?width=727&height=50&rev=1.1\|\|alt="image-20220519095946-5.png"]]
1.1	544
	545
67.7	546	(((
	547	Total Water Flow for TDC timer = (Calculate Flag) x (Last Pulse)=79/450=0.2L
62.5	548	)))
1.1	549
75.1	550	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L%20LoRaWAN%20Outdoor%20Flow%20Sensor/WebHome/image-20220519095946-6.png?width=733&height=43&rev=1.1\|\|alt="image-20220519095946-6.png"]]
1.1	551
	552
67.7	553	=== 2.3.4 Historical Water Flow Status, FPORT~=3 ===
1.1	554
	555
55.1	556	(((
99.13	557	SW3L-LB/LS stores sensor values and users can retrieve these history values via the [[downlink command>>\|\|anchor="H2.5DatalogFeature"]].
55.1	558	)))
	559
	560	(((
67.7	561	The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time water flow status.
75.1	562
86.7	563	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
99.15	564	\|=(% colspan="6" style="width: 515px; background-color:#4F81BD;color:white" %)Water Flow Value, FPORT=3
86.7	565	\|(% style="width:50px" %)Size(bytes)\|(% style="width:110px" %)1\|(% style="width:120px" %)4\|(% style="width:110px" %)1\|(% style="width:55px" %)1\|(% style="width:70px" %)4
96.5	566	\|(% style="width:110px" %)Value\|(% style="width:81px" %)Calculate Flag & [[Alarm>>\|\|anchor="H3.3.4Alarmforcontinuouslywaterflow"]]\|(% style="width:95px" %)(((
75.1	567	Total pulse Or Last Pulse
86.1	568	)))\|(% style="width:78px" %)(((
86.7	569	MOD & PA4_status & PB15_status
86.1	570	)))\|(% style="width:92px" %)Reserve(0x01)\|(% style="width:134px" %)[[Unix TimeStamp>>\|\|anchor="H2.5.2UnixTimeStamp"]]
	571
81.1	572	Calculate Flag & Alarm:
76.1	573
81.3	574	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
99.20	575	\|(% style="background-color:#4f81bd; color:white; width:50px" %)Size(bit)\|(% style="background-color:#4f81bd; color:white; width:89px" %)bit7\|(% style="background-color:#4f81bd; color:white; width:89px" %)bit6\|(% style="background-color:#4f81bd; color:white; width:69px" %)[bit5:bit2]\|(% style="background-color:#4f81bd; color:white; width:129px" %)bit1\|(% style="background-color:#4f81bd; color:white; width:89px" %)bit0
96.5	576	\|(% style="width:88px" %)Value\|(% style="width:96px" %)(((
77.10	577	No ACK message
	578	)))\|(% style="width:94px" %)Poll Message Flag\|(% style="width:115px" %)Calculate Flag\|(% style="width:136px" %)Alarm: 0: No Alarm; 1: Alarm\|(% style="width:120px" %)TDC flag 0:No;1:Yes
86.1	579
	580	MOD & PA4_status & PB15_status:
	581
86.8	582	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:240px" %)
99.20	583	\|(% style="background-color:#4f81bd; color:white; width:60px" %)Size(bit)\|(% style="background-color:#4f81bd; color:white; width:60px" %)bit7\|(% style="background-color:#4f81bd; color:white; width:60px" %)bit6\|(% style="background-color:#4f81bd; color:white; width:60px" %)[bit5:bit0]
96.5	584	\|(% style="width:88px" %)Value\|(% style="width:117px" %)PA4_status\|(% style="width:117px" %)PB15_status\|(% style="width:118px" %)MOD
55.1	585	)))
46.1	586
62.5	587	* (((
67.7	588	Each data entry is 11 bytes and has the same structure as [[real time water flow status>>\|\|anchor="H2.3.3A0WaterFlowValue2CUplinkFPORT3D2"]], to save airtime and battery, SW3L will send max bytes according to the current DR and Frequency bands.
62.5	589	)))
46.1	590
62.5	591	(((
	592	For example, in the US915 band, the max payload for different DR is:
	593	)))
1.1	594
62.5	595	(((
67.23	596	(% style="color:blue" %)a) DR0:(%%) max is 11 bytes so one entry of data
62.5	597	)))
55.1	598
62.5	599	(((
67.23	600	(% style="color:blue" %)b) DR1:(%%) max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
62.5	601	)))
1.1	602
62.5	603	(((
67.23	604	(% style="color:blue" %)c) DR2:(%%) total payload includes 11 entries of data
62.5	605	)))
1.1	606
62.5	607	(((
67.23	608	(% style="color:blue" %)d) DR3:(%%) total payload includes 22 entries of data.
62.5	609	)))
1.1	610
62.5	611	(((
99.13	612	If SW3L-LB/LS doesn't have any data in the polling time. It will uplink 11 bytes of 0
86.10	613
	614
62.5	615	)))
1.1	616
62.5	617	(((
67.7	618	(% style="color:#037691" %)Downlink:
62.5	619	)))
1.1	620
62.5	621	(((
85.1	622	0x31 64 92 C5 AC 64 92 C7 8C 05
62.5	623	)))
1.1	624
85.1	625	[[image:image-20230626093440-2.png\|\|height="160" width="890"]]
1.1	626
	627
62.5	628	(((
67.7	629	(% style="color:#037691" %)Uplink:
62.5	630	)))
1.1	631
62.5	632	(((
85.1	633	41 00 01 00 00 00 08 64 92 C5 E4 40 00 01 00 00 00 08 64 92 C6 06 49 41 01 00 00 00 00 64 92 C6 8B 49 81 01 00 00 00 00 64 92 C7 34 4A 01 01 00 00 00 2D 64 92 C7 7C
86.10	634
	635
62.5	636	)))
1.1	637
62.5	638	(((
67.7	639	(% style="color:#037691" %)Parsed Value:
62.5	640	)))
1.1	641
62.5	642	(((
85.1	643	[TDC_flag, Alarm, Calculate Flag, PA4_status, PB15_status, MOD, Total pulse or Last Pulse, Water Flow Value, TIME]
62.5	644	)))
14.26	645
55.1	646
14.44	647	(((
85.1	648	[YES,FALSE,0,L,L, 0,8, 0.0,2023-06-21 09:41:56],
1.1	649
85.1	650	[NO,FALSE,0,L,L, 0,8, 0.0,2023-06-21 09:42:30],
1.1	651
85.1	652	[YES,FALSE,2,L,H,1,0, 0.0,2023-06-21 09:44:43],
1.1	653
85.1	654	[YES,FALSE,2,H,L,1,0, 0.0,2023-06-21 09:47:32],
1.1	655
85.1	656	[NO,TRUE ,2, L,L,1,45,0.7,2023-06-21 09:48:44],
1.1	657
85.1	658
14.44	659	)))
1.1	660
85.1	661	[[image:image-20230626093703-3.png\|\|height="156" width="894"]]
62.5	662
1.1	663
62.5	664	== 2.4 Payload Decoder file ==
1.1	665
	666
62.5	667	In TTN, use can add a custom payload so it shows friendly reading
1.1	668
88.1	669	In the page (% style="color:#037691" %)Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder(%%) to add the decoder from: [[dragino-end-node-decoder/SW3L-LB at main · dragino/dragino-end-node-decoder · GitHub>>url:https://github.com/dragino/dragino-end-node-decoder/tree/main/SW3L-LB]]
1.1	670
	671
62.5	672	== 2.5 Datalog Feature ==
1.1	673
51.1	674
99.13	675	Datalog Feature is to ensure IoT Server can get all sampling data from Sensor even if the LoRaWAN network is down. For each sampling, SW3L-LB/LS will store the reading for future retrieving purposes.
62.5	676
91.2	677	(% style="color:red" %)Note: After the device is reset, in cumulative counting mode,the last stored count value will be read as the initial value.
62.5	678
76.1	679
62.5	680	=== 2.5.1 Ways to get datalog via LoRaWAN ===
	681
	682
99.13	683	Set PNACKMD=1, SW3L-LB/LS will wait for ACK for every uplink, when there is no LoRaWAN network, SW3L-LB/LS 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	684
	685	* (((
99.13	686	a) SW3L-LB/LS will do an ACK check for data records sending to make sure every data arrive server.
62.5	687	)))
	688	* (((
99.13	689	b) SW3L-LB/LS will send data in CONFIRMED Mode when PNACKMD=1, but SW3L-LB/LS 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 SW3L-LB/LS gets a ACK, SW3L-LB/LS will consider there is a network connection and resend all NONE-ACK messages.
62.5	690	)))
	691
	692	Below is the typical case for the auto-update datalog feature (Set PNACKMD=1)
	693
	694	[[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"]]
	695
	696
	697	=== 2.5.2 Unix TimeStamp ===
	698
	699
99.13	700	SW3L-LB/LS uses Unix TimeStamp format based on
62.5	701
	702	[[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"]]
	703
	704	User can get this time from link: [[https:~~/~~/www.epochconverter.com/>>url:https://www.epochconverter.com/]] :
	705
	706	Below is the converter example
	707
	708	[[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"]]
	709
	710
	711	So, we can use AT+TIMESTAMP=1611889405 or downlink 3060137afd00 to set the current time 2021 – Jan ~-~- 29 Friday 03:03:25
	712
	713
	714	=== 2.5.3 Set Device Time ===
	715
	716
	717	User need to set (% style="color:blue" %)SYNCMOD=1(%%) to enable sync time via MAC command.
	718
99.13	719	Once SW3L-LB/LS Joined LoRaWAN network, it will send the MAC command (DeviceTimeReq) and the server will reply with (DeviceTimeAns) to send the current time to SW3L-LB/LS. If SW3L-LB/LS fails to get the time from the server, SW3L-LB/LS 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	720
	721	(% 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.
	722
	723
	724	=== 2.5.4 Poll sensor value ===
	725
	726
	727	Users can poll sensor values based on timestamps. Below is the downlink command.
	728
99.17	729	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:425.818px" %)
99.20	730	\|(% colspan="4" style="background-color:#4f81bd; color:white; width:423px" %)Downlink Command to poll Open/Close status (0x31)
62.5	731	\|(% style="width:58px" %)1byte\|(% style="width:127px" %)4bytes\|(% style="width:124px" %)4bytes\|(% style="width:114px" %)1byte
	732	\|(% style="width:58px" %)31\|(% style="width:127px" %)Timestamp start\|(% style="width:124px" %)Timestamp end\|(% style="width:114px" %)Uplink Interval
	733
	734	(((
	735	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.
	736	)))
	737
	738	(((
64.8	739	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	740	)))
	741
	742	(((
	743	Is to check 2021/11/12 12:00:00 to 2021/11/12 15:00:00's data
	744	)))
	745
	746	(((
99.13	747	Uplink Internal =5s，means SW3L-LB/LS will send one packet every 5s. range 5~~255s.
62.5	748	)))
	749
	750
67.20	751	== 2.6 Frequency Plans ==
1.1	752
	753
99.21	754	The SW3L-LB/LS uses OTAA mode and below frequency plans by default. Each frequency band use different firmware, user update the firmware to the corresponding band for their country.
1.1	755
	756	[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]]
	757
	758
99.13	759	= 3. Configure SW3L-LB/LS =
1.1	760
16.4	761	== 3.1 Configure Methods ==
1.1	762
	763
99.13	764	SW3L-LB/LS supports below configure method:
1.1	765
	766	* AT Command via Bluetooth Connection (Recommended): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
67.20	767
11.1	768	* 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]].
67.20	769
1.1	770	* LoRaWAN Downlink. Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
	771
	772	== 3.2 General Commands ==
	773
	774
	775	These commands are to configure:
	776
	777	* General system settings like: uplink interval.
67.20	778
1.1	779	* LoRaWAN protocol & radio related command.
	780
	781	They are same for all Dragino Devices which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki:
	782
	783	[[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/]]
	784
	785
99.13	786	== 3.3 Commands special design for SW3L-LB/LS ==
1.1	787
	788
99.13	789	These commands only valid for SW3L-LB/LS, as below:
1.1	790
	791
	792	=== 3.3.1 Set Transmit Interval Time ===
	793
	794
62.5	795	(((
1.1	796	Feature: Change LoRaWAN End Node Transmit Interval.
62.5	797	)))
	798
	799	(((
1.1	800	(% style="color:blue" %)AT Command: AT+TDC
62.5	801	)))
1.1	802
14.34	803	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
99.17	804	\|=(% style="width: 156px;background-color:#4F81BD;color:white" %)Command Example\|=(% style="width: 137px;background-color:#4F81BD;color:white" %)Function\|=(% style="background-color:#4F81BD;color:white" %)Response
1.1	805	\|(% style="width:156px" %)AT+TDC=?\|(% style="width:137px" %)Show current transmit Interval\|(((
	806	30000
	807	OK
	808	the interval is 30000ms = 30s
	809	)))
	810	\|(% style="width:156px" %)AT+TDC=60000\|(% style="width:137px" %)Set Transmit Interval\|(((
	811	OK
	812	Set transmit interval to 60000ms = 60 seconds
	813	)))
	814
62.5	815	(((
1.1	816	(% style="color:blue" %)Downlink Command: 0x01
62.5	817	)))
1.1	818
62.5	819	(((
1.1	820	Format: Command Code (0x01) followed by 3 bytes time value.
62.5	821	)))
1.1	822
62.5	823	(((
1.1	824	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	825	)))
1.1	826
62.5	827	* (((
	828	Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds
	829	)))
	830	* (((
67.10	831	Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
77.11	832
79.5	833
77.11	834
67.10	835	)))
1.1	836
76.1	837	=== 3.3.2 Set Power Output Duration ===
1.1	838
62.5	839
76.1	840	Control the output duration 5V . Before each sampling, device will
62.5	841
76.1	842	~1. first enable the power output to external sensor,
62.5	843
76.1	844	2. keep it on as per duration, read sensor value and construct uplink payload
62.5	845
76.1	846	3. final, close the power output.
62.5	847
76.1	848	(% style="color:blue" %)AT Command:AT+5VT
62.5	849
99.18	850	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:460px" %)
	851	\|=(% style="width: 156px;background-color:#4F81BD;color:white" %)Command Example\|=(% style="width: 175px; background-color: #4F81BD;color:white" %)Function\|=(% style="background-color: #4F81BD;color:white; width: 126px;" %)Response
76.1	852	\|(% style="width:156px" %)AT+5VT=?\|(% style="width:175px" %)Show 5V open time.\|(% style="width:126px" %)(((
	853	0 (default)
	854	OK
	855	)))
91.1	856	\|(% style="width:156px" %)AT+5VT=1000\|(% style="width:175px" %)Close after a delay of 1000 milliseconds.\|(% style="width:126px" %)(((
76.1	857	OK
	858
	859	)))
62.5	860
76.1	861	(% style="color:blue" %)Downlink Command:0x07
62.5	862
76.1	863	Format: Command Code (0x07) followed by 2 bytes.
62.5	864
76.1	865	The first and second bytes are the time to turn on.
62.5	866
76.1	867	* Example 1: Downlink Payload: 070000 ~-~--> AT+5VT=0
	868	* Example 2: Downlink Payload: 0701F4 ~-~--> AT+5VT=500
1.1	869
76.1	870	=== 3.3.3 Set Time Sync Mode ===
1.1	871
77.11	872
76.1	873	Feature: Enable/Disable Sync system time via LoRaWAN MAC Command (DeviceTimeReq), LoRaWAN server must support v1.0.3 protocol to reply to this command.
1.1	874
76.1	875	SYNCMOD is set to 1 by default. If user wants to set a different time from the LoRaWAN server, the user needs to set this to 0.
	876
	877	(% style="color:blue" %)AT Command:
	878
99.18	879	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
	880	\|=(% style="width: 155px;background-color:#4F81BD;color:white" %)Command Example\|=(% style="width: 284px; background-color:#4F81BD;color:white" %)Function\|=(% style="background-color:#4F81BD;color:white" %)Response
79.3	881	\|(% style="width:156px" %)AT+SYNCMOD=1\|(% style="width:284px" %)Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) The default is zero time zone.\|(% style="width:72px" %)(((
76.1	882	OK
	883
	884	)))
79.3	885	\|(% style="width:156px" %)AT+SYNCMOD=1,8\|(% style="width:284px" %)Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) Set to East eight time zone.\|(% style="width:72px" %)(((
76.1	886	OK
	887
	888	)))
79.3	889	\|(% style="width:156px" %)AT+SYNCMOD=1,-12\|(% style="width:284px" %)Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) Set to West Twelve Time Zone.\|(% style="width:72px" %)(((
76.1	890	OK
	891	)))
	892
	893	(% style="color:blue" %)Downlink Command:
	894
	895	0x28 01 ~/~/ Same As AT+SYNCMOD=1
	896
	897	0x28 01 08 ~/~/ Same As AT+SYNCMOD=1,8
	898
	899	0x28 01 F4 ~/~/ Same As AT+SYNCMOD=1,-12
	900
	901	0x28 00 ~/~/ Same As AT+SYNCMOD=0
	902
	903
67.13	904	=== 3.3.4 Alarm for continuously water flow ===
1.1	905
39.6	906
62.5	907	(((
67.10	908	This feature is to monitor and send Alarm for continuously water flow.
62.5	909	)))
1.1	910
62.5	911	(((
67.10	912	Example case is for Toilet water monitoring, if some one push toilet button, the toilet will have water flow. If the toilet button has broken and can't returned to original state, the water flow will keep for hours or days which cause huge waste for water.
62.5	913	)))
1.1	914
62.5	915	(((
67.10	916	To monitor this faulty and send alarm, there are two settings:
62.5	917	)))
1.1	918
67.10	919	* (((
88.6	920	(% style="color:blue" %)Stop Duration: Unit: Second
62.5	921	)))
1.1	922
62.5	923	(((
99.13	924	Default: 15s, If SW3L-LB/LS didn't see any water flow in 15s, SW3L-LB/LS will consider stop of water flow event.
62.5	925	)))
1.1	926
67.10	927	* (((
88.6	928	(% style="color:blue" %)Alarm Timer: Units: Minute; Default 0 minutes (means Alarm disable)
62.5	929	)))
1.1	930
62.5	931	(((
99.13	932	Example: 3 minutes, if SW3L-LB/LS detect a start of water flow event and didn't detect a stop event within Alarm timer, SW3L-LB/LS will send an Alarm to indicate a water flow abnormal alarm.
62.5	933	)))
1.1	934
62.5	935	(((
67.10	936	So for example, If we set stop duration=15s and Alarm Timer=3minutes. If the toilet water flow continuously for more than 3 minutes, Sensor will send an alarm (in Confirmed MODE) to platform.
62.5	937	)))
1.1	938
62.5	939	(((
67.10	940	(% style="color:red" %)Note: After this alarm is send, sensor will consider a stop of water flow and count for another new event. So if water flow waste last for 1 hour, Sensor will keep sending alarm every 3 minutes.
62.5	941	)))
39.6	942
62.5	943	(((
88.6	944	(% style="color:blue" %)AT Command to configure:
62.5	945	)))
1.1	946
67.10	947	* (((
	948	AT+PTRIG=15,3 ~-~-> Set Stop duration: 15s, Alarm Timer: 3 minutes.
62.5	949	)))
1.1	950
67.10	951	* (((
	952	AT+ PTRIG=15,0 ~-~-> Default Value, disable water waste Alarm.
62.5	953	)))
1.1	954
62.5	955	(((
88.6	956	(% style="color:blue" %)Downlink Command to configure:
62.5	957	)))
1.1	958
62.5	959	(((
67.10	960	Command: 0xAA aa bb cc
62.5	961	)))
1.1	962
62.5	963	(((
67.10	964	AA: Command Type Code
62.5	965	)))
1.1	966
62.5	967	(((
67.10	968	aa: Stop duration
62.5	969	)))
1.1	970
62.5	971	(((
67.10	972	bb cc: Alarm Timer
62.5	973	)))
1.1	974
62.5	975	(((
67.10	976	If user send 0xAA 0F 00 03: equal to AT+PTRIG=15,3
62.5	977	)))
1.1	978
	979
76.1	980	=== 3.3.5 Set the calculate flag ===
1.1	981
	982
62.5	983	Feature: Set the calculate flag
	984
62.6	985	(% style="color:blue" %)AT Command: AT+CALCFLAG
62.5	986
99.19	987	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:461px" %)
99.15	988	\|=(% style="width: 158px;background-color:#4F81BD;color:white" %)Command Example\|=(% style="width: 193px;background-color:#4F81BD;color:white" %)Function\|=(% style="width: 110px;background-color:#4F81BD;color:white" %)Response
62.5	989	\|(% style="width:158px" %)AT+CALCFLAG =1\|(% style="width:192px" %)Set the calculate flag to 1.\|(% style="width:109px" %)OK
	990	\|(% style="width:158px" %)AT+CALCFLAG =2\|(% style="width:192px" %)Set the calculate flag to 2.\|(% style="width:109px" %)OK
96.1	991	\|(% style="width:158px" %)AT+CALCFLAG =3\|(% style="width:192px" %)Set the calculate flag to 3.\|(% style="width:109px" %)OK
62.5	992
62.6	993	(% style="color:blue" %)Downlink Command:
62.5	994
	995	* Example: 0XA501 ~/~/ Same as AT+CALCFLAG =1
	996
76.1	997	=== 3.3.6 Set count number ===
62.5	998
	999
	1000	Feature: Manually set the count number
	1001
62.6	1002	(% style="color:blue" %)AT Command: AT+SETCNT
62.5	1003
99.15	1004	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:479px" %)
	1005	\|=(% style="width: 160px;background-color:#4F81BD;color:white" %)Command Example\|=(% style="width: 223px;background-color:#4F81BD;color:white" %)Function\|=(% style="width: 96px;background-color:#4F81BD;color:white" %)Response
62.5	1006	\|(% style="width:160px" %)AT+ SETCNT =0\|(% style="width:221px" %)Set the count number to 0.\|(% style="width:95px" %)OK
	1007	\|(% style="width:160px" %)AT+ SETCNT =100\|(% style="width:221px" %)Set the count number to 100.\|(% style="width:95px" %)OK
	1008
62.6	1009	(% style="color:blue" %)Downlink Command:
62.5	1010
	1011	* Example: 0xA6000001 ~/~/ Same as AT+ SETCNT =1
62.6	1012
62.5	1013	* Example: 0xA6000064 ~/~/ Same as AT+ SETCNT =100
	1014
76.1	1015	=== 3.3.7 Set work mode ===
62.5	1016
67.10	1017
	1018	Feature: Manually set the work mode
41.1	1019
67.10	1020	(% style="color:blue" %)AT Command: AT+MOD
41.1	1021
99.15	1022	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:463px" %)
	1023	\|=(% style="width: 162px;background-color:#4F81BD;color:white" %)Command Example\|=(% style="width: 193px;background-color:#4F81BD;color:white" %)Function\|=(% style="width: 108px;background-color:#4F81BD;color:white" %)Response
67.10	1024	\|(% style="width:162px" %)AT+MOD=0\|(% style="width:191px" %)Set the work mode to 0.\|(% style="width:106px" %)OK
	1025	\|(% style="width:162px" %)AT+MOD=1\|(% style="width:191px" %)Set the work mode to 1\|(% style="width:106px" %)OK
41.1	1026
67.10	1027	(% style="color:blue" %)Downlink Command:
41.1	1028
67.10	1029	* Example: 0x0A00 ~/~/ Same as AT+MOD=0
41.1	1030
67.10	1031	* Example: 0x0A01 ~/~/ Same as AT+MOD=1
62.7	1032
76.1	1033	=== 3.3.8 Clear Flash Record ===
67.23	1034
76.1	1035
	1036	Feature: Clear flash storage for data log feature.
	1037
	1038	(% style="color:blue" %)AT Command: AT+CLRDTA
	1039
99.15	1040	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
	1041	\|=(% style="width: 157px;background-color:#4F81BD;color:white" %)Command Example\|=(% style="width: 169px;background-color:#4F81BD;color:white" %)Function\|=(% style="width: 174px;background-color:#4F81BD;color:white" %)Response
76.1	1042	\|(% style="width:157px" %)AT+CLRDTA\|(% style="width:169px" %)Clear flash storage for data log feature.\|Clear all stored sensor data… OK
	1043
16.4	1044	= 4. Battery & Power Consumption =
14.45	1045
1.1	1046
99.5	1047	SW3L-LB use ER26500 + SPC1520 battery pack and SW3L-LS use 3000mAh Recharable Battery with Solar Panel. See below link for detail information about the battery info and how to replace.
1.1	1048
	1049	[[Battery Info & Power Consumption Analyze>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
	1050
	1051
16.4	1052	= 5. OTA Firmware update =
1.1	1053
	1054
13.1	1055	(% class="wikigeneratedid" %)
99.13	1056	User can change firmware SW3L-LB/LS to:
1.1	1057
13.1	1058	* Change Frequency band/ region.
62.7	1059
13.1	1060	* Update with new features.
62.7	1061
13.1	1062	* Fix bugs.
1.1	1063
80.2	1064	Firmware and changelog can be downloaded from : [[Firmware download link>>https://www.dropbox.com/sh/qs74jsd0zecdk3q/AADHPJ4Sl6z980Cg-rCdzgeza?dl=0]]
1.1	1065
31.1	1066	Methods to Update Firmware:
1.1	1067
80.2	1068	* (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	1069
80.2	1070	* 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	1071
31.1	1072	= 6. FAQ =
1.1	1073
62.7	1074	== 6.1 AT Commands input doesn't work ==
1.1	1075
	1076
62.7	1077	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.
	1078
	1079
31.1	1080	= 7. Order Info =
1.1	1081
	1082
99.6	1083	Part Number: (% style="color:blue" %)SW3L-LB-XXX-YYY (%%)or (% style="color:blue" %)SW3L-LS-XX-YY(%%)
1.1	1084
99.6	1085	(% style="color:red" %)XX(%%): The default frequency band
1.1	1086
38.1	1087	* (% style="color:red" %)AS923(%%): LoRaWAN AS923 band
1.1	1088
38.1	1089	* (% style="color:red" %)AU915(%%): LoRaWAN AU915 band
1.1	1090
38.1	1091	* (% style="color:red" %)EU433(%%): LoRaWAN EU433 band
1.1	1092
38.1	1093	* (% style="color:red" %)EU868(%%): LoRaWAN EU868 band
1.1	1094
38.1	1095	* (% style="color:red" %)KR920(%%): LoRaWAN KR920 band
1.1	1096
38.1	1097	* (% style="color:red" %)US915(%%): LoRaWAN US915 band
1.1	1098
38.1	1099	* (% style="color:red" %)IN865(%%): LoRaWAN IN865 band
1.1	1100
38.1	1101	* (% style="color:red" %)CN470(%%): LoRaWAN CN470 band
1.1	1102
67.11	1103	(((
99.6	1104	(% style="color:blue" %)YY(%%): Flow Sensor Model
67.11	1105	)))
	1106
	1107	(((
95.4	1108	* 004: DW-004 Flow Sensor: diameter: G1/2” / DN15. 450 pulse = 1 L
67.11	1109	)))
	1110
	1111	(((
95.4	1112	* 006: DW-006 Flow Sensor: diameter: G3/4” / DN20. 390 pulse = 1 L
67.11	1113	)))
	1114
	1115	(((
95.4	1116	* 010: DW-010 Flow Sensor: diameter: G 1” / DN25. 64 pulse = 1 L
67.11	1117	)))
	1118
95.3	1119	(((
96.2	1120	* 020: DW-020 Flow Sensor: diameter: G 2” / DN50. 12 pulse = 1 L
67.11	1121	)))
	1122
95.3	1123
31.1	1124	= 8. Packing Info =
1.1	1125
39.6	1126
39.1	1127	(% style="color:#037691" %)Package Includes:
1.1	1128
99.6	1129	* SW3L-LB or SW3L-LS LoRaWAN Flow Sensor
1.1	1130
39.1	1131	(% style="color:#037691" %)Dimension and weight:
1.1	1132
31.1	1133	* Device Size: cm
1.1	1134
31.1	1135	* Device Weight: g
1.1	1136
31.1	1137	* Package Size / pcs : cm
1.1	1138
31.1	1139	* Weight / pcs : g
1.1	1140
31.1	1141	= 9. Support =
1.1	1142
	1143
31.1	1144	* 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	1145
	1146	* 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/LS -- LoRaWAN Flow Sensor User Manual

Applications

Navigation