Wiki source code of SW3L-NB -- NB-IoT Flow Sensor User Manual

Version 101.34 by Xiaoling on 2023/10/10 18:22

version	line-number	content
84.2	1	(% style="text-align:center" %)
100.2	2	[[image:image-20231010090810-1.png\|\|height="518" width="839"]]
1.1	3
	4
85.2	5
	6
	7
	8
	9
	10
82.23	11	Table of Contents:
30.1	12
1.1	13	{{toc/}}
	14
	15
	16
	17
	18
	19
31.1	20	= 1. Introduction =
1.1	21
100.3	22	== 1.1 What is SW3L-NB NB-IoT Flow Sensor ==
1.1	23
39.6	24
100.4	25	The Dragino SW3L-NB is a (% style="color:blue" %)NB-IoT Flow Sensor(%%). It detects water flow volume and uplink to IoT server via NB-IoT network. User can use this to (% style="color:blue" %)monitor the water usage for buildings.
1.1	26
100.4	27	The SW3L-NB will send water flow volume every 20 minutes. It can also detect the (% style="color:blue" %)water flow status and send Alarm(%%), to avoid the waste for water usage such as broken toilet case.
1.1	28
100.4	29	SW3L-NB is designed for both indoor and outdoor use. It has a weatherproof enclosure and industrial level battery to (% style="color:blue" %)work in low to high temperatures.
1.1	30
100.3	31	SW3L-NB supports different uplink methods including (% style="color:blue" %)MQTT, MQTTs, UDP & TCP(%%) for different application requirement, and support uplinks to various IoT Servers.
1.1	32
100.3	33	SW3L-NB (% style="color:blue" %)supports BLE configure (%%)and(% style="color:blue" %) OTA update(%%) which make user easy to use.
1.1	34
100.3	35	SW3L-NB is powered by (% style="color:blue" %)8500mAh Li-SOCI2 battery(%%), it is designed for long-term use up to several years.
1.1	36
100.3	37	SW3L-NB has optional built-in SIM card and default IoT server connection version. Which makes it works with simple configuration.
	38
101.2	39	[[image:image-20231010091546-2.png\|\|height="348" width="909"]]
1.1	40
	41
	42	== 1.2 Features ==
	43
39.6	44
70.3	45	* NB-IoT Bands: B1/B2/B3/B4/B5/B8/B12/B13/B17/B18/B19/B20/B25/B28/B66/B70/B85 @H-FDD
1.1	46	* Ultra-low power consumption
101.4	47	* Upload water flow volume
	48	* Monitor water waste
70.3	49	* Multiply Sampling and one uplink
	50	* Support Bluetooth v5.1 remote configure and update firmware
1.1	51	* Uplink on periodically
	52	* Downlink to change configure
	53	* 8500mAh Battery for long term use
70.3	54	* Nano SIM card slot for NB-IoT SIM
1.1	55
	56	== 1.3 Specification ==
	57
	58
82.28	59	(% style="color:blue" %)Common DC Characteristics:
1.1	60
84.4	61	* Supply Voltage: 2.5v ~~ 3.6v
1.1	62	* Operating Temperature: -40 ~~ 85°C
	63
82.28	64	(% style="color:blue" %)NB-IoT Spec:
1.1	65
82.28	66	(% style="color:#037691" %)NB-IoT Module: BC660K-GL
1.1	67
82.29	68	(% style="color:#037691" %)Support Bands:
70.4	69
	70	* B1 @H-FDD: 2100MHz
	71	* B2 @H-FDD: 1900MHz
	72	* B3 @H-FDD: 1800MHz
	73	* B4 @H-FDD: 2100MHz
	74	* B5 @H-FDD: 860MHz
	75	* B8 @H-FDD: 900MHz
	76	* B12 @H-FDD: 720MHz
	77	* B13 @H-FDD: 740MHz
	78	* B17 @H-FDD: 730MHz
	79	* B18 @H-FDD: 870MHz
	80	* B19 @H-FDD: 870MHz
	81	* B20 @H-FDD: 790MHz
	82	* B25 @H-FDD: 1900MHz
	83	* B28 @H-FDD: 750MHz
	84	* B66 @H-FDD: 2000MHz
	85	* B70 @H-FDD: 2000MHz
	86	* B85 @H-FDD: 700MHz
	87
82.28	88	(% style="color:blue" %)Battery:
1.1	89
	90	* Li/SOCI2 un-chargeable battery
	91	* Capacity: 8500mAh
70.5	92	* Self Discharge: <1% / Year @ 25°C
1.1	93	* Max continuously current: 130mA
	94	* Max boost current: 2A, 1 second
	95
82.28	96	(% style="color:blue" %)Power Consumption
1.1	97
70.4	98	* STOP Mode: 10uA @ 3.3v
	99	* Max transmit power: 350mA@3.3v
1.1	100
101.3	101	(% class="wikigeneratedid" id="H1.4Ratedenvironmentalconditions" %)
	102	(% style="display:none" %) (%%)
1.1	103
101.7	104	== 1.4 Flow Sensor Spec ==
84.5	105
	106
101.7	107	(((
	108	(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %)
101.24	109	\|=(% style="width: 80px;background-color:#4F81BD;color:white" %)Model\|=(% style="width: 80px;background-color:#4F81BD;color:white" %)Probe\|=(% style="width: 80px;background-color:#4F81BD;color:white" %)Diameter\|=(% style="width: 80px;background-color:#4F81BD;color:white" %)Range\|=(% style="width: 80px;background-color:#4F81BD;color:white" %)Max Pressure\|=(% style="width: 110px;background-color:#4F81BD;color:white" %)Measure
101.7	110	\|(% 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
	111	\|(% 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
	112	\|(% 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
	113	)))
	114
	115
	116	== 1.5 Applications ==
	117
	118
101.4	119	* Flow Sensor application
	120	* Water Control
	121	* Toilet Flow Sensor
	122	* Monitor Waste water
84.5	123
101.7	124	== 1.6 Sleep mode and working mode ==
84.5	125
	126
99.3	127	(% style="color:blue" %)Deep Sleep Mode: (%%)Sensor doesn't have any NB-IoT activate. This mode is used for storage and shipping to save battery life.
73.2	128
99.3	129	(% style="color:blue" %)Working Mode: (%%)In this mode, Sensor will work as NB-IoT Sensor to Join NB-IoT 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.
73.2	130
	131
101.7	132	== 1.7 Button & LEDs ==
73.2	133
	134
6.1	135	[[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675071855856-879.png]]
1.1	136
	137
14.13	138	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
80.11	139	\|=(% style="width: 167px;background-color:#4F81BD;color:white" %)Behavior on ACT\|=(% style="width: 117px;background-color:#4F81BD;color:white" %)Function\|=(% style="width:225px;background-color:#4F81BD;color:white" %)Action
1.1	140	\|(% style="width:167px" %)Pressing ACT between 1s < time < 3s\|(% style="width:117px" %)Send an uplink\|(% style="width:225px" %)(((
73.2	141	If sensor has already attached to NB-IoT network, sensor will send an uplink packet, (% style="color:blue" %)blue led (%%)will blink once.
1.1	142	Meanwhile, BLE module will be active and user can connect via BLE to configure device.
	143	)))
	144	\|(% style="width:167px" %)Pressing ACT for more than 3s\|(% style="width:117px" %)Active Device\|(% style="width:225px" %)(((
73.2	145	(% 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 attach NB-IoT network.
1.1	146	(% style="color:green" %)Green led(%%) will solidly turn on for 5 seconds after joined in network.
73.2	147	Once sensor is active, BLE module will be active and user can connect via BLE to configure device, no matter if device attach NB-IoT network or not.
1.1	148	)))
6.1	149	\|(% 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	150
101.7	151	== 1.8 BLE connection ==
1.1	152
	153
101.10	154	SW3L-NB support BLE remote configure and firmware update.
1.1	155
	156
	157	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:
	158
	159	* Press button to send an uplink
	160	* Press button to active device.
	161	* Device Power on or reset.
	162
	163	If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode.
	164
	165
101.7	166	== 1.9 Pin Definitions & Switch ==
1.1	167
73.3	168
73.2	169	[[image:image-20230819104805-5.png]]
1.1	170
43.1	171
101.25	172	=== 1.9.1 Jumper JP2 ===
43.1	173
73.3	174
	175	Power on Device when put this jumper.
	176
	177
101.25	178	=== 1.9.2 BOOT MODE / SW1 ===
73.3	179
	180
82.31	181	1) (% style="color:blue" %)ISP(%%): upgrade mode, device won't have any signal in this mode. but ready for upgrade firmware. LED won't work. Firmware won't run.
73.3	182
82.31	183	2) (% style="color:blue" %)Flash(%%): work mode, device starts to work and send out console output for further debug
73.3	184
	185
101.25	186	=== 1.9.3 Reset Button ===
73.3	187
80.2	188
73.3	189	Press to reboot the device.
	190
1.1	191	(% style="display:none" %)
	192
	193
101.25	194	== 1.10 Mechanical ==
84.14	195
	196	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual/WebHome/1675143884058-338.png?rev=1.1\|\|alt="1675143884058-338.png"]]
	197
	198	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual/WebHome/1675143899218-599.png?rev=1.1\|\|alt="1675143899218-599.png"]]
	199
	200	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual/WebHome/1675143909447-639.png?rev=1.1\|\|alt="1675143909447-639.png"]]
	201
	202
	203
101.7	204	Probe Mechanical:
84.14	205
	206
101.7	207	(% style="color:blue" %)DW-004 Flow Sensor: diameter: G1/2” / DN15. 450 pulse = 1 L
84.14	208
101.7	209	[[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"]]
	210
	211
	212	(% style="color:blue" %)006: DW-006 Flow Sensor: diameter: G3/4” / DN20. 390 pulse = 1 L
	213
	214	[[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"]]
	215
	216
	217	(% style="color:blue" %)010: DW-010 Flow Sensor: diameter: G 1” / DN25. 64 pulse = 1 L
	218
	219	[[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"]]
	220
	221
101.8	222	= 2. Use SW3L-NB to communicate with IoT Server =
1.1	223
80.2	224	== 2.1 Send data to IoT server via NB-IoT network ==
1.1	225
	226
101.10	227	The SW3L-NB is equipped with a NB-IoT module, the pre-loaded firmware in SW3L-NB will get environment data from sensors and send the value to local NB-IoT network via the NB-IoT module. The NB-IoT network will forward this value to IoT server via the protocol defined by SW3L-NB.
1.1	228
	229
80.2	230	Below shows the network structure:
1.1	231
101.3	232	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L-NB_NB-IoT_Flow_Sensor_User_Manual/WebHome/image-20231010091546-2.png?width=909&height=348&rev=1.1\|\|alt="image-20231010091546-2.png"]]
1.1	233
	234
101.10	235	There are two version: (% style="color:blue" %)-GE(%%) and (% style="color:blue" %)-1D(%%) version of SW3L-NB.
1.1	236
	237
101.10	238	(% style="color:blue" %)GE Version(%%): This version doesn't include SIM card or point to any IoT server. User needs to use AT Commands to configure below two steps to set SW3L-NB send data to IoT server.
1.1	239
82.19	240	* Install NB-IoT SIM card and configure APN. See instruction of [[Attach Network>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H2.AttachNetwork]].
80.4	241
82.19	242	* Set up sensor to point to IoT Server. See instruction of [[Configure to Connect Different Servers>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.Configuretoconnecttodifferentservers]].
1.1	243
80.2	244	Below shows result of different server as a glance.
1.1	245
80.9	246	(% border="1" cellspacing="4" style="width:515px" %)
81.2	247	\|(% style="background-color:#4f81bd; color:white; width:100px" %)Servers\|(% style="background-color:#4f81bd; color:white; width:300px" %)Dash Board\|(% style="background-color:#4f81bd; color:white; width:115px" %)Comments
82.24	248	\|(% style="width:127px" %)[[Node-Red>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.5A0Node-RedA028viaA0MQTT29]]\|(% style="width:385px" %)(((
	249	(% style="text-align:center" %)
	250	[[image:image-20230819113244-8.png\|\|height="183" width="367"]]
	251	)))\|(% style="width:170px" %)
	252	\|(% style="width:127px" %)[[DataCake>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.4Datacake]]\|(% style="width:385px" %)(((
	253	(% style="text-align:center" %)
82.25	254	[[image:image-20230819113244-9.png\|\|height="119" width="367"]]
82.24	255	)))\|(% style="width:170px" %)
80.9	256	\|(% style="width:127px" %)[[Tago.IO>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.7A0Tago.ioA028viaA0MQTT29]]\|(% style="width:385px" %) \|(% style="width:170px" %)
	257	\|(% style="width:127px" %)[[General UDP>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.1GeneralA0UDPA0Connection]]\|(% style="width:385px" %)Raw Payload. Need Developer to design Dash Board\|(% style="width:170px" %)
	258	\|(% style="width:127px" %)[[General MQTT>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.2GeneralA0MQTTA0Connection]]\|(% style="width:385px" %)Raw Payload. Need Developer to design Dash Board\|(% style="width:170px" %)
82.24	259	\|(% style="width:127px" %)[[ThingSpeak>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.3A0ThingSpeakA028viaA0MQTT29]]\|(% style="width:385px" %)(((
	260	(% style="text-align:center" %)
82.25	261	[[image:image-20230819113244-10.png\|\|height="104" width="367"]]
82.24	262	)))\|(% style="width:170px" %)
	263	\|(% style="width:127px" %)[[ThingsBoard>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.6A0ThingsBoard.CloudA028viaA0MQTT29]]\|(% style="width:385px" %)(((
	264	(% style="text-align:center" %)
82.25	265	[[image:image-20230819113244-11.png\|\|height="141" width="367"]]
82.24	266	)))\|(% style="width:170px" %)
80.2	267
101.10	268	(% style="color:blue" %)1D Version(%%): This version has 1NCE SIM card pre-installed and configure to send value to DataCake. User Just need to select the sensor type in DataCake and Activate SW3L-NB and user will be able to see data in DataCake. See here for [[DataCake Config Instruction>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.4Datacake]].
80.2	269
	270
	271	== 2.2 Payload Types ==
	272
	273
101.10	274	To meet different server requirement, SW3L-NB supports different payload type.
1.1	275
81.2	276	Includes:
1.1	277
82.21	278	* [[General JSON format payload>>\|\|anchor="H2.2.1GeneralJsonFormat28Type3D529"]]. (Type=5)
80.7	279
82.21	280	* [[HEX format Payload>>\|\|anchor="H2.2.2HEXformatPayload28Type3D029"]]. (Type=0)
80.7	281
82.21	282	* [[ThingSpeak Format>>\|\|anchor="H2.2.4ThingSpeakPayload28Type3D129"]]. (Type=1)
80.7	283
82.21	284	* [[ThingsBoard Format>>\|\|anchor="H2.2.3ThingsBoardPayload28Type3D329"]]. (Type=3)
1.1	285
80.3	286	User can specify the payload type when choose the connection protocol. Example:
1.1	287
81.2	288	(% style="color:#037691" %)AT+PRO=2,0 (%%) ~/~/ Use UDP Connection & hex Payload
1.1	289
80.8	290	(% style="color:#037691" %)AT+PRO=2,5 (%%) ~/~/ Use UDP Connection & Json Payload
1.1	291
81.2	292	(% style="color:#037691" %)AT+PRO=3,5 (%%) ~/~/ Use MQTT Connection & Json Payload
1.1	293
	294
82.20	295	=== 2.2.1 General Json Format(Type~=5) ===
1.1	296
80.8	297
80.3	298	This is the General Json Format. As below:
1.1	299
101.10	300	(% style="color:#4472c4" %){"IMEI":"866207058378443","Model":"SW3L-NB","distance":217,"battery":3.54,"signal":24,"1":{221,2023/09/20 09:47:01},"2":{0,2023/09/20 09:15:04},"3":{0,2023/09/20 09:00:04},"4":{0,2023/09/20 08:45:03},"5":{0,2023/09/20 08:30:03},"6":{0,2023/09/20 08:15:03},"7":{0,2023/09/20 08:00:04},"8":{0,2023/09/20 07:45:04}}
1.1	301
	302
92.1	303	[[image:image-20230920175015-3.png\|\|height="613" width="890"]]
90.1	304
	305
81.2	306	(% style="color:red" %)Notice, from above payload:
1.1	307
90.2	308	* Distance , Battery & Signal are the value at uplink time.
1.1	309
90.2	310	* Json entry 1 ~~ 8 are the last 1 ~~ 8 sampling data as specify by (% style="color:#037691" %)AT+NOUD=8 (%%)Command. Each entry includes (from left to right): Distance, Sampling time.
1.1	311
81.2	312	=== 2.2.2 HEX format Payload(Type~=0) ===
1.1	313
	314
80.3	315	This is the HEX Format. As below:
1.1	316
88.2	317	(% style="color:#4472c4" %)f8662070583784430b640dda15010003a4650abc400000650ab8180000650ab4940000650ab10f0000650aad8b0000650aaa070000650aa6840000650aa3000000650a9308
1.1	318
90.1	319	[[image:image-20230920172200-1.png\|\|height="191" width="1047"]]
6.1	320
1.1	321
88.2	322	If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NB sensor uplink data.
	323
92.1	324	[[image:image-20230920173352-2.png\|\|height="636" width="919"]]
88.2	325
88.3	326
80.4	327	(% style="color:blue" %)Version:
1.1	328
80.3	329	These bytes include the hardware and software version.
1.1	330
101.10	331	(% style="color:#037691" %)Higher byte:(%%) Specify Sensor Model: 0x0b for SW3L-NB
1.1	332
88.3	333	(% style="color:#037691" %)Lower byte:(%%) Specify the software version: 0x64=100, means firmware version 1.0.0
1.1	334
	335
81.2	336	(% style="color:blue" %)BAT (Battery Info):
1.1	337
88.3	338	Ex1: 0x0dda = 3546mV
1.1	339
	340
80.4	341	(% style="color:blue" %)Signal Strength:
1.1	342
80.3	343	NB-IoT Network signal Strength.
1.1	344
88.3	345	Ex1: 0x15 = 21
1.1	346
80.3	347	0 -113dBm or less
1.1	348
80.3	349	1 -111dBm
1.1	350
80.3	351	2...30 -109dBm... -53dBm
1.1	352
80.3	353	31 -51dBm or greater
1.1	354
80.3	355	99 Not known or not detectable
1.1	356
	357
88.3	358	(% style="color:blue" %)Distance:
1.1	359
88.3	360	Ex1: 0x03a4 = 932 mm
1.1	361
	362
88.3	363	(% style="color:blue" %)Timestamp:
1.1	364
88.3	365	Unit Timestamp Example: 650abc40(H) = 1695202368(D)
	366
	367	Put the decimal value into this link([[https:~~/~~/www.epochconverter.com)>>https://www.epochconverter.com]]) to get the time.
	368
	369
81.2	370	=== 2.2.3 ThingsBoard Payload(Type~=3) ===
1.1	371
80.8	372
80.3	373	Type3 payload special design for ThingsBoard, it will also configure other default server to ThingsBoard.
1.1	374
101.10	375	(% style="color:#4472c4" %) {"IMEI": "866207058378443","Model": "SW3L","distance": 502,"battery": 3.57,"signal": 23}
46.1	376
99.1	377	[[image:image-20230922094043-2.png\|\|height="558" width="851"]]
1.1	378
99.1	379
	380
81.2	381	=== 2.2.4 ThingSpeak Payload(Type~=1) ===
1.1	382
80.8	383
93.2	384	This payload meets ThingSpeak platform requirement. It includes only four fields. Form 1~~3 are:
1.1	385
90.2	386	Distance, Battery & Signal. This payload type only valid for ThingsSpeak Platform
14.22	387
80.3	388	As below:
1.1	389
92.1	390	(% style="color:#4472c4" %)field1=Distance value&field2=Battery value&field3=Singal value
1.1	391
92.1	392	[[image:image-20230921104741-1.png\|\|height="565" width="826"]]
84.24	393
92.1	394
84.15	395	== 2.3 Uplink Payload ==
10.1	396
101.11	397	=== 2.3.1 Sensor Configuration, FPORT~=4 ===
1.1	398
101.11	399
101.13	400	SW3L-NB will only send this command after getting the downlink command (0x26 02) from the server.
101.11	401
	402	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
101.27	403	\|(% 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
101.11	404	\|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
	405
	406	Example parse in TTNv3
	407
101.27	408	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L-LB_LoRaWAN_Flow_Sensor_User_Manual/WebHome/image-20230614172555-4.png?width=853&height=151&rev=1.1\|\|alt="image-20230614172555-4.png"]]
101.11	409
	410
	411	* (% style="color:blue" %)TDC: (default: 0x0004B0)
	412
	413	Uplink interval for the total pulse count, default value is 0x0004B0 which is 1200 seconds = 20 minutes.
	414
	415
	416	* (% style="color:blue" %)STOP Duration & Alarm Timer
	417
101.16	418	Shows the configure value of [[Alarm for continuously water flow>>\|\|anchor="H2.7Alarmforcontinuouslywaterflow"]]
101.11	419
	420
	421	=== 2.3.2 Water Flow Value, Uplink FPORT~=2 ===
	422
	423
84.15	424	(((
101.13	425	SW3L-NB will send this uplink after Device Status once join the NB-IoT network successfully. And SW3L-NB will:
84.15	426	)))
1.1	427
84.15	428	(((
101.20	429	periodically send this uplink every 20 minutes, this interval [[can be changed>>\|\|anchor="H2.10SetTransmitIntervalTime"]].
84.15	430	)))
	431
101.11	432	(((
	433	Uplink Payload totals 11 bytes.
	434	)))
84.15	435
101.11	436	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
101.20	437	\|=(% colspan="6" style="width: 515px; background-color:#4F81BD;color:white" %)Water Flow Value, FPORT=2
101.11	438	\|(% 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
101.20	439	\|(% style="width:110px" %)Value\|(% style="width:81px" %)Calculate Flag & [[Alarm>>\|\|anchor="H2.7Alarmforcontinuouslywaterflow"]]\|(% style="width:95px" %)(((
101.11	440	Total pulse Or Last Pulse
	441	)))\|(% style="width:78px" %)(((
	442	MOD & PA4_status & PB15_status
101.27	443	)))\|(% style="width:92px" %)Reserve(0x01)\|(% style="width:134px" %)Unix TimeStamp
93.3	444
101.11	445	Calculate Flag & Alarm:
	446
	447	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
101.27	448	\|(% 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
101.11	449	\|(% 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
	450
	451	MOD & PA4_status & PB15_status:
	452
	453	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:230px" %)
101.27	454	\|(% 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]
101.11	455	\|(% style="width:88px" %)Value\|(% style="width:117px" %)PA4_status\|(% style="width:117px" %)PB15_status\|(% style="width:118px" %)MOD
	456
101.27	457	(% style="color:#037691" %) [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L-LB_LoRaWAN_Flow_Sensor_User_Manual/WebHome/image-20230626093242-1.png?width=892&height=276&rev=1.1\|\|alt="image-20230626093242-1.png"]]
101.11	458
	459
	460	* (((
	461	(% style="color:blue" %)Calculate Flag
	462	)))
	463
	464	(((
	465	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.
94.2	466	)))
	467
101.11	468	(((
	469	Example: in the default payload:
	470	)))
94.2	471
101.11	472	* (((
	473	calculate flag=0: for SW3L-004 Flow Sensor: 450 pulse = 1 L
	474	)))
	475	* (((
	476	calculate flag=1: for SW3L-006 Flow Sensor: 390 pulse = 1 L
	477	)))
	478	* (((
	479	calculate flag=2: for SW3L-010 Flow Sensor: 64 pulse = 1 L
	480	)))
94.2	481
101.11	482	(((
	483	Default value: 0.
	484	)))
93.3	485
101.11	486	(((
	487	Range (4 bits): (b)0000 ~~ (b) 1111
101.10	488
101.11	489	If user use with a meter for example is 0.02L/pulse. To proper decode the correct value in server,
84.15	490
101.11	491	1) User can set the Calculate Flag of this sensor to 3.
84.15	492
101.11	493	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.
	494	)))
84.15	495
101.11	496	(((
101.31	497	(% 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="H2.8Setthecalculateflag"]]
84.15	498
101.11	499	(((
	500
	501	)))
	502	)))
84.15	503
	504
101.11	505	* (((
	506	(% style="color:blue" %)Alarm
	507	)))
84.15	508
101.11	509	(((
101.21	510	See [[Alarm for continuously water flow>>\|\|anchor="H2.7Alarmforcontinuouslywaterflow"]]
101.11	511	)))
84.15	512
101.11	513	[[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"]]
84.15	514
	515
101.11	516	(((
	517	* (% style="color:blue" %)TDC flag
84.15	518
101.11	519	When the flag is 1, it means sending packets at normal time intervals.
84.15	520
101.11	521	Otherwise, it is a packet sent at non-TDC time.
	522	)))
84.15	523
101.11	524	* (((
	525	(% style="color:blue" %)Total pulse
	526	)))
84.15	527
101.11	528	(((
	529	Total pulse/counting since factory
	530	)))
84.15	531
93.3	532	(((
101.11	533	Range (4 Bytes) : 0x00000000~~ 0xFFFFFFFF .
	534
	535
93.3	536	)))
84.15	537
101.11	538	* (((
	539	(% style="color:blue" %)Last Pulse
	540	)))
	541
93.3	542	(((
101.11	543	Total pulse since last FPORT=2 uplink. (Default 20 minutes)
	544	)))
84.15	545
101.11	546	(((
	547	Range (4 Bytes) : 0x00000000~~ 0xFFFFFFFF .
	548
	549
	550	* (((
	551	(% style="color:blue" %)PA4_status: Support digital level input below 3.3V
93.3	552	)))
84.15	553
101.11	554	(((
	555	0 ~-~-> PA4 is at low level.
	556	)))
84.15	557
101.11	558	(((
	559	1 ~-~-> PA4 is at high level.
84.15	560
101.11	561
	562	* (((
	563	(% style="color:blue" %)PB15_status: Support digital level input below 3.3V
	564	)))
	565
84.15	566	(((
101.11	567	0 ~-~-> PB15 is at low level.
	568	)))
	569
	570	(((
	571	1 ~-~-> PB15 is at high level..
	572	)))
	573	)))
	574	)))
	575
	576	* (((
	577	(% style="color:blue" %)MOD: Default =0
	578	)))
	579
	580	(((
	581	MOD=0 ~-~-> Uplink Total Pulse since factory
	582	)))
	583
	584	(((
	585	MOD=1 ~-~-> Uplink total pulse since last FPORT=2 uplink.
	586
84.15	587
	588	)))
	589
101.11	590	* (((
	591	(% style="color:blue" %)Water Flow Value
	592	)))
	593
	594	(((
	595	Total Water Flow Volume = (Calculate Flag) x (Total Pulse)=9597/450=21.3L
	596	)))
	597
	598	[[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"]]
	599
	600
	601	(((
	602	Total Water Flow for TDC timer = (Calculate Flag) x (Last Pulse)=79/450=0.2L
	603	)))
	604
	605	[[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"]]
	606
	607
	608	=== 2.3.3 Historical Water Flow Status, FPORT~=3 ===
	609
	610
	611	(((
101.32	612	SW3L-NB stores sensor values and users can retrieve these history values via the downlink command.
101.11	613	)))
	614
	615	(((
	616	The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time water flow status.
	617
	618	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
101.21	619	\|=(% colspan="6" style="width: 515px; background-color:#4F81BD;color:white" %)Water Flow Value, FPORT=3
101.11	620	\|(% 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
101.21	621	\|(% style="width:110px" %)Value\|(% style="width:81px" %)Calculate Flag & [[Alarm>>\|\|anchor="H2.7Alarmforcontinuouslywaterflow"]]\|(% style="width:95px" %)(((
101.11	622	Total pulse Or Last Pulse
	623	)))\|(% style="width:78px" %)(((
	624	MOD & PA4_status & PB15_status
101.28	625	)))\|(% style="width:92px" %)Reserve(0x01)\|(% style="width:134px" %)Unix TimeStamp
101.11	626
	627	Calculate Flag & Alarm:
	628
	629	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
101.29	630	\|(% 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
101.11	631	\|(% style="width:88px" %)Value\|(% style="width:96px" %)(((
	632	No ACK message
	633	)))\|(% 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
	634
	635	MOD & PA4_status & PB15_status:
	636
	637	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:240px" %)
101.27	638	\|(% 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]
101.11	639	\|(% style="width:88px" %)Value\|(% style="width:117px" %)PA4_status\|(% style="width:117px" %)PB15_status\|(% style="width:118px" %)MOD
	640	)))
	641
	642	* (((
101.21	643	Each data entry is 11 bytes and has the same structure as [[real time water flow status>>\|\|anchor="H2.3.2A0WaterFlowValue2CUplinkFPORT3D2"]], to save airtime and battery, SW3L will send max bytes according to the current DR and Frequency bands.
101.11	644	)))
	645
	646	(((
	647	For example, in the US915 band, the max payload for different DR is:
	648	)))
	649
	650	(((
	651	(% style="color:blue" %)a) DR0:(%%) max is 11 bytes so one entry of data
	652	)))
	653
	654	(((
	655	(% style="color:blue" %)b) DR1:(%%) max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
	656	)))
	657
	658	(((
	659	(% style="color:blue" %)c) DR2:(%%) total payload includes 11 entries of data
	660	)))
	661
	662	(((
	663	(% style="color:blue" %)d) DR3:(%%) total payload includes 22 entries of data.
	664	)))
	665
	666	(((
101.13	667	If SW3L-NB doesn't have any data in the polling time. It will uplink 11 bytes of 0
101.11	668
	669
	670	)))
	671
	672	(((
	673	(% style="color:#037691" %)Downlink:
	674	)))
	675
	676	(((
	677	0x31 64 92 C5 AC 64 92 C7 8C 05
	678	)))
	679
101.29	680	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L-LB_LoRaWAN_Flow_Sensor_User_Manual/WebHome/image-20230626093440-2.png?width=890&height=160&rev=1.1\|\|alt="image-20230626093440-2.png"]]
101.11	681
	682
	683	(((
	684	(% style="color:#037691" %)Uplink:
	685	)))
	686
	687	(((
	688	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
	689
	690
	691	)))
	692
	693	(((
	694	(% style="color:#037691" %)Parsed Value:
	695	)))
	696
	697	(((
	698	[TDC_flag, Alarm, Calculate Flag, PA4_status, PB15_status, MOD, Total pulse or Last Pulse, Water Flow Value, TIME]
	699	)))
	700
	701
	702	(((
	703	[YES,FALSE,0,L,L, 0,8, 0.0,2023-06-21 09:41:56],
	704
	705	[NO,FALSE,0,L,L, 0,8, 0.0,2023-06-21 09:42:30],
	706
	707	[YES,FALSE,2,L,H,1,0, 0.0,2023-06-21 09:44:43],
	708
	709	[YES,FALSE,2,H,L,1,0, 0.0,2023-06-21 09:47:32],
	710
	711	[NO,TRUE ,2, L,L,1,45,0.7,2023-06-21 09:48:44],
	712	)))
	713
101.29	714	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L-LB_LoRaWAN_Flow_Sensor_User_Manual/WebHome/image-20230626093703-3.png?width=894&height=156&rev=1.1\|\|alt="image-20230626093703-3.png"]]
101.11	715
	716
84.15	717	== 2.4 Test Uplink and Change Update Interval ==
	718
	719
80.4	720	By default, Sensor will send uplinks (% style="color:blue" %)every 2 hours(%%) & AT+NOUD=8
1.1	721
80.4	722	User can use below commands to change the (% style="color:blue" %)uplink interval.
1.1	723
82.2	724	(% style="color:#037691" %)AT+TDC=600 (%%) ~/~/ Set Update Interval to 600s
1.1	725
80.3	726	User can also push the button for more than 1 seconds to activate an uplink.
1.1	727
	728
84.15	729	== 2.5 Multi-Samplings and One uplink ==
39.5	730
80.4	731
101.10	732	To save battery life, SW3L-NB will sample Distance data every 15 minutes and send one uplink every 2 hours. So each uplink it will include 8 stored data + 1 real-time data. They are defined by:
1.1	733
82.6	734	* (% style="color:#037691" %)AT+TR=900 (%%) ~/~/ The unit is seconds, and the default is to record data once every 900 seconds (15 minutes, the minimum can be set to 180 seconds)
1.1	735
82.12	736	* (% style="color:#037691" %)AT+NOUD=8 (%%)~/~/ The device uploads 8 sets of recorded data by default. Up to 32 sets of record data can be uploaded.
1.1	737
80.3	738	The diagram below explains the relationship between TR, NOUD, and TDC more clearly:
1.1	739
82.2	740	[[image:1692424376354-959.png]]
1.1	741
	742
84.15	743	== 2.6 Trggier an uplink by external interrupt ==
1.1	744
80.5	745
101.10	746	SW3L-NB has an external trigger interrupt function. Users can use the PB15 pin to trigger the upload of data packets.
39.5	747
80.5	748	(% style="color:blue" %)AT command:
46.1	749
82.6	750	* (% style="color:#037691" %)AT+INTMOD (%%) ~/~/ Set the trigger interrupt mode
46.1	751
82.6	752	* (% style="color:#037691" %)AT+INTMOD=0 (%%) ~/~/ Disable Interrupt
1.1	753
82.6	754	* (% style="color:#037691" %)AT+INTMOD=1 (%%) ~/~/ Trigger by rising and falling edge
80.5	755
82.6	756	* (% style="color:#037691" %)AT+INTMOD=2 (%%) ~/~/ Trigger by falling edge
80.5	757
82.6	758	* (% style="color:#037691" %)AT+INTMOD=3 (%%) ~/~/ Trigger by rising edge
80.5	759
101.12	760	== 2.7 Alarm for continuously water flow ==
	761
	762
	763	(((
	764	This feature is to monitor and send Alarm for continuously water flow.
	765	)))
	766
	767	(((
	768	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.
	769	)))
	770
	771	(((
	772	To monitor this faulty and send alarm, there are two settings:
	773	)))
	774
	775	* (((
	776	(% style="color:blue" %)Stop Duration: Unit: Second
	777	)))
	778
	779	(((
101.13	780	Default: 15s, If SW3L-NB didn't see any water flow in 15s, SW3L-NB will consider stop of water flow event.
101.12	781	)))
	782
	783	* (((
	784	(% style="color:blue" %)Alarm Timer: Units: Minute; Default 0 minutes (means Alarm disable)
	785	)))
	786
	787	(((
101.13	788	Example: 3 minutes, if SW3L-NB detect a start of water flow event and didn't detect a stop event within Alarm timer, SW3L-NB will send an Alarm to indicate a water flow abnormal alarm.
101.12	789	)))
	790
	791	(((
	792	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.
	793	)))
	794
	795	(((
	796	(% 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.
	797	)))
	798
	799	(((
	800	(% style="color:blue" %)AT Command to configure:
	801	)))
	802
	803	* (((
	804	AT+PTRIG=15,3 ~-~-> Set Stop duration: 15s, Alarm Timer: 3 minutes.
	805	)))
	806
	807	* (((
	808	AT+ PTRIG=15,0 ~-~-> Default Value, disable water waste Alarm.
	809	)))
	810
	811	(((
	812	(% style="color:blue" %)Downlink Command to configure:
	813	)))
	814
	815	(((
	816	Command: 0xAA aa bb cc
	817	)))
	818
	819	(((
	820	AA: Command Type Code
	821	)))
	822
	823	(((
	824	aa: Stop duration
	825	)))
	826
	827	(((
	828	bb cc: Alarm Timer
	829	)))
	830
	831	(((
	832	If user send 0xAA 0F 00 03: equal to AT+PTRIG=15,3
	833	)))
	834
	835
	836	== 2.8 Set the calculate flag ==
	837
	838
	839	Feature: Set the calculate flag
	840
	841	(% style="color:blue" %)AT Command: AT+CALCFLAG
	842
	843	(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:461px" %)
101.21	844	\|=(% 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
101.12	845	\|(% style="width:158px" %)AT+CALCFLAG =1\|(% style="width:192px" %)Set the calculate flag to 1.\|(% style="width:109px" %)OK
	846	\|(% style="width:158px" %)AT+CALCFLAG =2\|(% style="width:192px" %)Set the calculate flag to 2.\|(% style="width:109px" %)OK
	847
	848	(% style="color:blue" %)Downlink Command:
	849
	850	* Example: 0XA501 ~/~/ Same as AT+CALCFLAG =1
	851
	852	== 2.9 Set count number ==
	853
	854
	855	Feature: Manually set the count number
	856
	857	(% style="color:blue" %)AT Command: AT+SETCNT
	858
	859	(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:479px" %)
101.21	860	\|=(% 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
101.12	861	\|(% style="width:160px" %)AT+ SETCNT =0\|(% style="width:221px" %)Set the count number to 0.\|(% style="width:95px" %)OK
	862	\|(% style="width:160px" %)AT+ SETCNT =100\|(% style="width:221px" %)Set the count number to 100.\|(% style="width:95px" %)OK
	863
	864	(% style="color:blue" %)Downlink Command:
	865
	866	* Example: 0xA6000001 ~/~/ Same as AT+ SETCNT =1
	867
	868	* Example: 0xA6000064 ~/~/ Same as AT+ SETCNT =100
	869
101.17	870	== 2.10 Set Transmit Interval Time ==
	871
	872
	873	(((
101.18	874	Feature: Change NB-IoT End Node Transmit Interval.
101.17	875	)))
	876
	877	(((
	878	(% style="color:blue" %)AT Command: AT+TDC
	879	)))
	880
	881	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
101.21	882	\|=(% 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
101.17	883	\|(% style="width:156px" %)AT+TDC=?\|(% style="width:137px" %)Show current transmit Interval\|(((
	884	30000
	885	OK
	886	the interval is 30000ms = 30s
	887	)))
	888	\|(% style="width:156px" %)AT+TDC=60000\|(% style="width:137px" %)Set Transmit Interval\|(((
	889	OK
	890	Set transmit interval to 60000ms = 60 seconds
	891	)))
	892
	893	(((
	894	(% style="color:blue" %)Downlink Command: 0x01
	895	)))
	896
	897	(((
	898	Format: Command Code (0x01) followed by 3 bytes time value.
	899	)))
	900
	901	(((
	902	If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01.
	903	)))
	904
	905	* (((
	906	Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds
	907	)))
	908	* (((
	909	Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
	910	)))
	911
101.10	912	= 3. Configure SW3L-NB =
1.1	913
16.4	914	== 3.1 Configure Methods ==
1.1	915
	916
101.10	917	SW3L-NB supports below configure method:
1.1	918
	919	* AT Command via Bluetooth Connection (Recommended): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
80.6	920
11.1	921	* 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]].
80.6	922
82.8	923	== 3.2 AT Commands Set ==
1.1	924
	925
82.8	926	AT+<CMD>? : Help on <CMD>
1.1	927
82.8	928	AT+<CMD> : Run <CMD>
1.1	929
82.8	930	AT+<CMD>=<value> : Set the value
1.1	931
82.8	932	AT+<CMD>=? : Get the value
1.1	933
	934
82.10	935	(% style="color:blue" %)General Commands
1.1	936
82.8	937	AT : Attention
1.1	938
82.9	939	AT? : Short Help
1.1	940
82.9	941	ATZ : MCU Reset
1.1	942
82.9	943	AT+TDC : Application Data Transmission Interval
1.1	944
82.9	945	AT+CFG : Print all configurations
1.1	946
82.8	947	AT+CFGMOD : Working mode selection
1.1	948
82.9	949	AT+DEUI : Get or set the Device ID
1.1	950
82.8	951	AT+INTMOD : Set the trigger interrupt mode
1.1	952
82.8	953	AT+5VT : Set extend the time of 5V power
1.1	954
82.8	955	AT+PRO : Choose agreement
1.1	956
82.9	957	AT+RXDL : Extend the sending and receiving time
1.1	958
82.9	959	AT+DNSCFG : Get or Set DNS Server
1.1	960
82.8	961	AT+GETSENSORVALUE : Returns the current sensor measurement
1.1	962
82.9	963	AT+NOUD : Get or Set the number of data to be uploaded
1.1	964
82.8	965	AT+CDP : Read or Clear cached data
1.1	966
82.9	967	AT+SHTEMP: Get or Set alarm of temp
1.1	968
82.9	969	AT+SHHUM: Get or Set alarm of moisture
1.1	970
82.9	971	AT+SERVADDR : Server Address
1.1	972
82.9	973
82.10	974	(% style="color:blue" %)UDP Management
1.1	975
82.9	976	AT+CFM : Upload confirmation mode (only valid for UDP)
1.1	977
39.6	978
82.10	979	(% style="color:blue" %)MQTT Management
1.1	980
82.8	981	AT+CLIENT : Get or Set MQTT client
1.1	982
82.8	983	AT+UNAME : Get or Set MQTT Username
1.1	984
82.8	985	AT+PWD : Get or Set MQTT password
1.1	986
82.9	987	AT+PUBTOPIC : Get or Set MQTT publish topic
1.1	988
82.9	989	AT+SUBTOPIC : Get or Set MQTT subscription topic
1.1	990
	991
82.10	992	(% style="color:blue" %)Information
1.1	993
82.9	994	AT+FDR : Factory Data Reset
1.1	995
82.9	996	AT+PWORD : Serial Access Password
1.1	997
82.9	998	AT+LDATA : Get the last upload data
39.6	999
82.9	1000	AT+CDP : Read or Clear cached data
1.1	1001
82.9	1002
16.4	1003	= 4. Battery & Power Consumption =
14.45	1004
1.1	1005
101.10	1006	SW3L-NB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
1.1	1007
	1008	[[Battery Info & Power Consumption Analyze>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
	1009
	1010
82.11	1011	= 5. Firmware update =
1.1	1012
	1013
82.11	1014	User can change device firmware to::
1.1	1015
13.1	1016	* Update with new features.
82.11	1017
13.1	1018	* Fix bugs.
1.1	1019
86.10	1020	Firmware and changelog can be downloaded from : [[Firmware download link>>https://www.dropbox.com/sh/l0bszumyrmil3yv/AAAg8LYGeAgDsD_ycCnweD72a?dl=0]]
1.1	1021
31.1	1022	Methods to Update Firmware:
1.1	1023
82.12	1024	* (Recommended way) OTA firmware update via BLE: [[Instruction>>url:http://wiki.dragino.com/xwiki/bin/view/Main/BLE_Firmware_Update_NB_Sensors_BC660K-GL/]].
82.14	1025
64.2	1026	* 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	1027
31.1	1028	= 6. FAQ =
1.1	1029
82.15	1030	== 6.1 How can I access t BC660K-GL AT Commands? ==
1.1	1031
	1032
82.15	1033	User can access to BC660K-GL directly and send AT Commands.
1.1	1034
82.15	1035	[[See BC660K-GL AT Command set>>url:https://www.dropbox.com/sh/5f6ssda5fum8rvs/AABT68l8ZzWOvZ5eg2qwOoFda?dl=0]]
1.1	1036
	1037
101.23	1038	= 7. Order Info =
1.1	1039
	1040
101.10	1041	Part Number: (% style="color:blue" %)SW3L-NB-XX-YY
1.1	1042
82.15	1043	(% style="color:red" %)XX(%%):
1.1	1044
82.15	1045	* (% style="color:#037691" %)GE(%%): General version ( Exclude SIM card)
1.1	1046
82.15	1047	* (% style="color:#037691" %)1D(%%): with 1NCE* 10 years 500MB SIM card and Pre-configure to DataCake server
1.1	1048
82.31	1049	(% style="color:#037691" %)1NCE SIM Card NB-IoT network coverage(%%): Austria, Belgium, Bulgaria, Croatia, Czech Republic, Denmark, Finland, Germany, Great Britain, Greece, Hungary, Ireland, Italy, Latvia, Malta, Netherlands, Norway, Puerto Rico, Russia, Slovak , Republic, Slovenia, Spain, Sweden, Switzerland, Taiwan, USA, US Virgin Islands
1.1	1050
101.10	1051	(((
	1052	(% style="color:blue" %)YY(%%): Flow Sensor Model:
	1053	)))
1.1	1054
101.10	1055	(((
	1056	004: DW-004 Flow Sensor: diameter: G1/2” / DN15. 450 pulse = 1 L
	1057	)))
	1058
	1059	(((
	1060	006: DW-006 Flow Sensor: diameter: G3/4” / DN20. 390 pulse = 1 L
	1061	)))
	1062
	1063	(((
	1064	010: DW-010 Flow Sensor: diameter: G 1” / DN25. 64 pulse = 1 L
	1065	)))
	1066
	1067	* (((
	1068	calculate flag=0: for SW3L-004 Flow Sensor: 450 pulse = 1 L
	1069	)))
	1070
	1071	* (((
	1072	calculate flag=1: for SW3L-006 Flow Sensor: 390 pulse = 1 L
	1073	)))
	1074
	1075	* (((
	1076	calculate flag=2: for SW3L-010 Flow Sensor: 64 pulse = 1 L
	1077
	1078
	1079
	1080	)))
	1081
101.23	1082	= 8. Packing Info =
1.1	1083
39.6	1084
39.1	1085	(% style="color:#037691" %)Package Includes:
1.1	1086
101.10	1087	* SW3L-NB NB-IoT Distance Detection sensor x 1
1.1	1088
82.16	1089	* External antenna x 1
	1090
39.1	1091	(% style="color:#037691" %)Dimension and weight:
1.1	1092
82.24	1093	* Device Size: 13.0 x 5 x 4.5 cm
1.1	1094
82.24	1095	* Device Weight: 150g
1.1	1096
82.24	1097	* Package Size / pcs : 14.0 x 8x 5 cm
1.1	1098
82.24	1099	* Weight / pcs : 180g
1.1	1100
101.23	1101	= 9. Support =
1.1	1102
	1103
31.1	1104	* 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	1105
	1106	* 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]].
75.2	1107
80.9	1108	(% style="display:none" %) (%%)

Wiki source code of SW3L-NB -- NB-IoT Flow Sensor User Manual

Applications