SW3L-NB -- NB-IoT Flow Sensor User Manual

(% aria-label="image-20231010090810-1.png image widget" contenteditable="false" role="region" tabindex="-1" %)

4

(((

5

(% data-widget="image" style="text-align:center" %)

6

[[image:image-20231010090810-1.png||height="379" width="614"]](% title="Click and drag to resize" %)

7

8

(% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||height="15" role="presentation" title="Click and drag to move" width="15"]]

)))

**Table of Contents:**

19

20

(% aria-label="macro:toc widget" contenteditable="false" role="region" tabindex="-1" %)

(((

(% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||height="15" role="presentation" title="Click and drag to move" width="15"]]

)))

= 1. Introduction =

== 1.1 What is SW3L-NB NB-IoT Flow Sensor ==

35

36

37

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**.

38

39

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.

40

41

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**.

42

43

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.

44

45

SW3L-NB (% style="color:blue" %)**supports BLE configure **(%%)and(% style="color:blue" %)** OTA update**(%%) which make user easy to use.

46

47

SW3L-NB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long-term use up to several years.

48

49

SW3L-NB has optional built-in SIM card and default IoT server connection version. Which makes it works with simple configuration.

50

51

(% aria-label="image-20231010091546-2.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20231010091546-2.png||data-widget="image" height="348" width="909"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)

== 1.2 Features ==

* NB-IoT Bands: B1/B2/B3/B4/B5/B8/B12/B13/B17/B18/B19/B20/B25/B28/B66/B70/B85 @H-FDD

58

* Ultra-low power consumption

59

* Upload water flow volume

60

* Monitor water waste

61

* Multiply Sampling and one uplink

62

* Support Bluetooth v5.1 remote configure and update firmware

63

* Uplink on periodically

64

* Downlink to change configure

65

* 8500mAh Battery for long term use

66

* Nano SIM card slot for NB-IoT SIM

67

(% style="display:none" %) (%%)

68

69

== 1.3 Specification ==

70

71

72

(% style="color:blue" %)**Common DC Characteristics:**

73

74

* Supply Voltage: 2.5v ~~ 3.6v

75

* Operating Temperature: -40 ~~ 85°C

76

77

(% style="color:blue" %)**NB-IoT Spec:**

78

79

(% style="color:#037691" %)**NB-IoT Module: BC660K-GL**

80

81

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

* B1 @H-FDD: 2100MHz

* B2 @H-FDD: 1900MHz

* B3 @H-FDD: 1800MHz

* B4 @H-FDD: 2100MHz

* B5 @H-FDD: 860MHz

* B8 @H-FDD: 900MHz

* B12 @H-FDD: 720MHz

* B13 @H-FDD: 740MHz

* B17 @H-FDD: 730MHz

* B18 @H-FDD: 870MHz

* B19 @H-FDD: 870MHz

* B20 @H-FDD: 790MHz

* B25 @H-FDD: 1900MHz

96

* B28 @H-FDD: 750MHz

97

* B66 @H-FDD: 2000MHz

98

* B70 @H-FDD: 2000MHz

99

* B85 @H-FDD: 700MHz

100

101

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

102

103

* Li/SOCI2 un-chargeable battery

104

* Capacity: 8500mAh

105

* Self Discharge: <1% / Year @ 25°C

106

* Max continuously current: 130mA

107

* Max boost current: 2A, 1 second

108

109

(% style="color:blue" %)**Power Consumption**

110

111

* STOP Mode: 10uA @ 3.3v

112

* Max transmit power: 350mA@3.3v

113

(% style="display:none" %) (%%)

114

115

== 1.4 Flow Sensor Spec ==

(((

(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:515px" %)

120

|=(% style="width: 103px; background-color:#4F81BD; color: white;" %)**Model**|=(% style="width: 103px; background-color:#4F81BD; color: white;" %)**SW3L-004**|=(% style="width: 103px; background-color:#4F81BD; color: white;" %)SW3L-006|=(% style="width: 103px; background-color:#4F81BD; color: white;" %)SW3L-010|=(% style="width: 103px; background-color:#4F81BD; color: white;" %)SW3L-020

|(% style="width:152px" %)**Power Consumption**|(% style="width:176px" %)1uA, 3.6v (Sensor Only)|(% style="width:173px" %)1uA, 3.6v (Sensor Only)|(% style="width:165px" %)1uA, 3.6v (Sensor Only)|(% style="width:190px" %)1uA, 3.6v (Sensor Only)

127

128

129

|(% style="width:152px" %)**Humidity Range**|(% style="width:176px" %)35%~~90%RH (no frost)|(% style="width:173px" %)35%~~90%RH (no frost)|(% style="width:165px" %)35%~~90%RH (no frost)|(% style="width:190px" %)35%~~90%RH (no frost)

)))

== 1.5 Applications ==

134

135

136

* Flow Sensor application

137

* Water Control

138

* Toilet Flow Sensor

139

* Monitor Waste water

140

(% style="display:none" %) (%%)

141

142

== 1.6 Sleep mode and working mode ==

143

144

145

(% 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.

146

147

(% 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.

148

149

150

== 1.7 Button & LEDs ==

151

152

153

(% aria-label="1675071855856-879.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675071855856-879.png||data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)

154

155

(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)

156

|=(% 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**

157

|(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:117px" %)Send an uplink|(% style="width:225px" %)(((

158

If sensor has already attached to NB-IoT network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once.

159

Meanwhile, BLE module will be active and user can connect via BLE to configure device.

160

)))

161

|(% style="width:167px" %)Pressing ACT for more than 3s|(% style="width:117px" %)Active Device|(% style="width:225px" %)(((

162

(% 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.

163

(% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network.

164

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.

165

)))

166

|(% 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.

167

168

(% style="color:red" %)**Note: When the device is executing a program, the buttons may become invalid. It is best to press the buttons after the device has completed the program execution.**

169

170

171

== 1.8 BLE connection ==

172

173

174

SW3L-NB support BLE remote configure and firmware update.

175

176

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:

177

178

* Press button to send an uplink

179

* Press button to active device.

180

* Device Power on or reset.

181

182

If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode.

183

184

185

== 1.9 Pin Definitions , Switch & SIM Direction ==

186

187

188

(% aria-label="image-20230819104805-5.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20230819104805-5.png||data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)

189

190

191

=== 1.9.1 Jumper JP2 ===

192

193

194

Power on Device when put this jumper.

195

196

197

=== 1.9.2 BOOT MODE / SW1 ===

198

199

200

**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.

201

202

**2)** (% style="color:blue" %)**Flash**(%%): work mode, device starts to work and send out console output for further debug

203

204

205

=== 1.9.3 Reset Button ===

206

207

208

Press to reboot the device.

209

210

(% style="display:none" %)

211

212

213

=== 1.9.4 SIM Card Direction ===

214

215

216

See this link. [[How to insert SIM Card>>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]].

217

218

219

== 1.10 Mechanical ==

220

221

(% aria-label="1675143884058-338.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[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" data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)

222

223

(% aria-label="1675143899218-599.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[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" data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)

224

225

(% aria-label="1675143909447-639.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[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" data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)

226

227

(% style="display:none" %) (%%)

228

229

**Probe Mechanical:**

230

231

232

(% style="color:blue" %)**004: DW-004 Flow Sensor: diameter: G1/2” / DN15. 450 pulse = 1 L**

233

234

(% aria-label="image-20220519091350-1.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[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" data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)

235

236

237

(% style="color:blue" %)**006: DW-006 Flow Sensor: diameter: G3/4” / DN20. 390 pulse = 1 L**

238

239

(% aria-label="image-20220519091423-2.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[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" data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)

240

241

242

(% style="color:blue" %)**010: DW-010 Flow Sensor: diameter: G 1” / DN25. 64 pulse = 1 L**

243

244

(% aria-label="image-20220519091423-3.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[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" data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)

245

246

247

(% style="color:blue" %)**020: DW-020 Flow Sensor: diameter: G 2”/ DN50. 12 pulse = 1 L**

248

249

(% aria-label="image-20231205170947-1.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20231205170947-1.png||data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)

250

251

252

= 2. Use SW3L-NB to communicate with IoT Server =

253

254

== 2.1 Send data to IoT server via NB-IoT network ==

255

256

257

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.

258

259

Below shows the network structure:

260

261

(% aria-label="image-20231010091546-2.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[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" data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)

262

263

264

There are two version: (% style="color:blue" %)**-GE**(%%) and (% style="color:blue" %)**-1D**(%%) version of SW3L-NB.

265

266

267

(% 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.

268

269

* 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]].

270

271

* 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]].

272

273

Below shows result of different server as a glance.

274

275

(% border="1" cellspacing="4" style="width:515px" %)

276

|(% 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**

277

|(% 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" %)(((

278

(% aria-label="image-20230819113244-8.png image widget" contenteditable="false" role="region" tabindex="-1" %)

279

(((

280

(% data-widget="image" style="text-align:center" %)

281

[[image:image-20230819113244-8.png||height="183" width="367"]](% title="Click and drag to resize" %)

282

283

(% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||height="15" role="presentation" title="Click and drag to move" width="15"]]

284

)))

285

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

286

|(% 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" %)(((

287

(% aria-label="image-20230819113244-9.png image widget" contenteditable="false" role="region" tabindex="-1" %)

288

(((

289

(% data-widget="image" style="text-align:center" %)

290

[[image:image-20230819113244-9.png||height="119" width="367"]](% title="Click and drag to resize" %)

291

292

(% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||height="15" role="presentation" title="Click and drag to move" width="15"]]

293

)))

294

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

295

|(% 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" %)

296

|(% 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" %)

297

|(% 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" %)

298

|(% 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" %)(((

299

(% aria-label="image-20230819113244-10.png image widget" contenteditable="false" role="region" tabindex="-1" %)

300

(((

301

(% data-widget="image" style="text-align:center" %)

302

[[image:image-20230819113244-10.png||height="104" width="367"]](% title="Click and drag to resize" %)

303

304

(% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||height="15" role="presentation" title="Click and drag to move" width="15"]]

305

)))

306

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

307

|(% 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" %)(((

308

(% aria-label="image-20230819113244-11.png image widget" contenteditable="false" role="region" tabindex="-1" %)

309

(((

310

(% data-widget="image" style="text-align:center" %)

311

[[image:image-20230819113244-11.png||height="141" width="367"]](% title="Click and drag to resize" %)

312

313

(% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||height="15" role="presentation" title="Click and drag to move" width="15"]]

314

)))

315

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

316

317

(% 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]].

318

319

320

== 2.2 Payload Types ==

321

322

323

To meet different server requirement, SW3L-NB supports different payload type.

**Includes:**

* [[General JSON format payload>>||anchor="H2.2.1GeneralJsonFormat28Type3D529"]]. (Type=5)

328

329

* [[HEX format Payload>>||anchor="H2.2.2HEXformatPayload28Type3D029"]]. (Type=0)

330

331

* [[ThingSpeak Format>>||anchor="H2.2.4ThingSpeakPayload28Type3D129"]]. (Type=1)

332

333

* [[ThingsBoard Format>>||anchor="H2.2.3ThingsBoardPayload28Type3D329"]]. (Type=3)

334

335

User can specify the payload type when choose the connection protocol. Example:

336

337

(% style="color:#037691" %)**AT+PRO=2,0** (%%) ~/~/ Use UDP Connection & hex Payload

338

339

(% style="color:#037691" %)**AT+PRO=2,5** (%%) ~/~/ Use UDP Connection & Json Payload

340

341

(% style="color:#037691" %)**AT+PRO=3,0 ** (%%) ~/~/ Use MQTT Connection & Json Payload

342

343

(% style="color:#037691" %)**AT+PRO=3,1** (%%) ~/~/ Use MQTT Connection & ThingSpeak

344

345

(% style="color:#037691" %)**AT+PRO=3,3 ** (%%) ~/~/ Use MQTT Connection & ThingsBoard

346

347

(% style="color:#037691" %)**AT+PRO=3,5 ** (%%) ~/~/ Use MQTT Connection & Json Payload

348

349

(% style="color:#037691" %)**AT+PRO=4,0** (%%) ~/~/ Use TDP Connection & hex Payload

350

351

(% style="color:#037691" %)**AT+PRO=4,5** (%%) ~/~/ Use TDP Connection & Json Payload

352

353

354

=== 2.2.1 General Json Format(Type~=5) ===

355

356

357

This is the General Json Format. As below:

358

359

(% style="color:#4472c4" %)**{"IMEI":"866207058378443","Model":"SW3L-NB","alarm:":0,"pulse":0,"water_flow":0.00,"battery":3.556,"signal":24,"1":{0.14,2023/10/20 06:35:40},"2":{0.14,2023/10/20 06:20:40},"3":{0.14,2023/10/20 06:05:40},"4":{11359.75,2023/10/20 03:50:05},"5":{11359.75,2023/10/18 08:32:45},"6":{11068.47,2023/10/18 08:17:45},"7":{21845.51,2023/10/18 08:02:45},"8":{21845.51,2023/10/18 07:47:45}}**

360

361

(% aria-label="image-20231020145016-2.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20231020145016-2.png||data-widget="image" height="873" width="1180"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)

362

363

364

(% style="color:red" %)**Notice, from above payload:**

365

366

* Alarm, Pulse, Water Flow , Battery & Signal are the value at uplink time.

367

368

* 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): Water Flow, Sampling time.

369

(% style="display:none" %) (%%)

370

371

=== 2.2.2 HEX format Payload(Type~=0) ===

372

373

374

This is the HEX Format. As below:

375

376

(% style="color:#4472c4" %)**f866207058378443 1164 0de4 14 00 00 00 00 01c2 0000003d 65321751 004e004e 6531f8ed 004e004e 652f982d 004c004c 652f94a9 0096004f 652f9125 0096004f 652f8da1 0092004f 652f89ce 0092004f 652f864a 004d004d 652f8065**

377

378

(% aria-label="image-20231023194515-1.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20231023194515-1.png||data-widget="image" height="189" width="1175"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)(% style="display:none" %)

379

380

381

If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NB sensor uplink data.

382

383

(% aria-label="image-20231020140858-1.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20231020140858-1.png||data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)

384

385

386

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

387

388

These bytes include the hardware and software version.

389

390

(% style="color:#037691" %)**Higher byte:**(%%) Specify Sensor Model: 0x11 for SW3L-NB

391

392

(% style="color:#037691" %)**Lower byte:**(%%) Specify the software version: 0x64=100, means firmware version 1.0.0

393

394

395

(% style="color:blue" %)**BAT (Battery Info):**

Ex1: 0x0dda = 3546mV

(% style="color:blue" %)**Signal Strength:**

401

402

NB-IoT Network signal Strength.

**Ex1: 0x15 = 21**

**0** -113dBm or less

**1** -111dBm

**2...30** -109dBm... -53dBm

411

412

**31** -51dBm or greater

413

414

**99** Not known or not detectable

415

416

417

(% style="color:blue" %)**PA4: Support digital level input below 3.3V**

418

419

(((

420

00 ~-~-> PA4 is at low level.

)))

(((

01 ~-~-> PA4 is at high level.

425

426

427

(% style="color:blue" %)**PB15: Support digital level input below 3.3V**

428

429

(((

430

00 ~-~-> PB15 is at low level.

)))

(((

01 ~-~-> PB15 is at high level.

(((

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

)))

(((

00~-~->Normal uplink.

443

444

01~-~->Water flow abnormal alarm.

445

446

447

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

448

449

(((

450

MOD=0 ~-~-> Uplink Total Pulse since factory

)))

(((

MOD=1 ~-~-> Uplink total pulse since last uplink.

)))

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

)))

)))

)))

(((

The calculate flag is a user defined field, total pulse divided by this mark is the converted water flow rate.

)))

(((

(% style="color:#037691" %)**Example:in the default payload:**

)))

* (((

calculate flag=450: for SW3L-004 Flow Sensor: 450 pulse = 1 L

474

)))

475

* (((

476

calculate flag=390: for SW3L-006 Flow Sensor: 390 pulse = 1 L

477

)))

478

* (((

479

calculate flag=64: for SW3L-010 Flow Sensor: 64 pulse = 1 L

)))

(((

Default value: 450.

)))

(((

)))

(((

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

)))

(((

The total pulse generated by the flow of water passing through the water meter.

)))

(((

)))

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

503

504

Unit Timestamp Example: 650abc40(H) = 1695202368(D)

505

506

Put the decimal value into this link([[https:~~/~~/www.epochconverter.com)>>https://www.epochconverter.com]]) to get the time.

507

508

509

=== 2.2.3 ThingsBoard Payload(Type~=3) ===

510

511

512

Type3 payload special design for ThingsBoard, it will also configure other default server to ThingsBoard.

513

514

(% style="color:#4472c4" %)** {"IMEI": "866207058378443","Model": "SW3L-NB","alarm:": 0, "pulse": 198,"water_flow": 0.44,"battery": 3.551, "signal": 22}**

515

516

(% aria-label="image-20231020145908-3.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20231020145908-3.png||data-widget="image" height="595" width="1182"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)

517

518

519

=== 2.2.4 ThingSpeak Payload(Type~=1) ===

520

521

522

This payload meets ThingSpeak platform requirement. It includes only five fields. Form 1~~5 are:

523

524

Distance, Battery & Signal. This payload type only valid for ThingsSpeak Platform

As below:

(% style="color:#4472c4" %)**field1=Total_pulse value&field2=Water_sum value&filed3=Alarm value&filed4=Battery value&field5=Singal value**

529

530

(% aria-label="image-20231025164530-1.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20231025164530-1.png||data-widget="image" height="765" width="815"]](% style="background:url(~"http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png~") rgba(220, 220, 220, 0.5); left:0px; top:-15px" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)

531

532

533

== 2.3 Test Uplink and Change Update Interval ==

534

535

536

By default, Sensor will send uplinks (% style="color:blue" %)**every 2 hours**(%%) & AT+NOUD=8

537

538

User can use below commands to change the (% style="color:blue" %)**uplink interval**.

539

540

(% style="color:#037691" %)**AT+TDC=600 ** (%%) ~/~/ Set Update Interval to 600s

541

542

User can also push the button for more than 1 seconds to activate an uplink.

543

544

545

== 2.4 Multi-Samplings and One uplink ==

546

547

548

(% style="color:red" %)**Notice: The AT+NOUD feature is upgraded to Clock Logging, please refer [[Clock Logging Feature>>||anchor="H2.9A0Clocklogging28Sincefirmwareversionv1.0.429"]].**

549

550

(% style="color:red" %)**Note:** **When SW3L-NB is reset and AT+MOD=0, the total pulse will be read from the latest recorded data as the initial value**.

551

552

To save battery life, SW3L-NB will sample Water Flow 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:

553

554

* (% 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)

555

556

* (% 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.

557

558

The diagram below explains the relationship between TR, NOUD, and TDC more clearly:

559

560

(% aria-label="1692424376354-959.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:1692424376354-959.png||data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)

561

562

563

== 2.5 Alarm for continuously water flow ==

(((

This feature is to monitor and send Alarm for continuously water flow.

)))

(((

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.

)))

(((

To monitor this faulty and send alarm, there are two settings:

)))

* (((

(% style="color:blue" %)**Stop Duration: Unit: Second**

)))

(((

Default: 15s, If SW3L-NB didn't see any water flow in 15s, SW3L-NB will consider stop of water flow event.

)))

* (((

(% style="color:blue" %)**Alarm Timer: Units: Minute; Default 0 minutes (means Alarm disable)**

)))

(((

**Example:** 10 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.

)))

(((

So for example, If we set stop duration=15s and Alarm Timer=10minutes. If the toilet water flow continuously for more than 10 minutes, Sensor will send an alarm to platform.

)))

(((

(% 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 10 minutes.**

)))

(((

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

)))

* (((

AT+PTRIG=15,10 ~-~-> Set Stop duration: 15s, Alarm Timer: 10 minutes.

)))

* (((

AT+ PTRIG=0,0 ~-~-> Default Value, disable water waste Alarm.

616

)))(% style="display:none" %) (%%)

617

618

== 2.6 Set Power Output Duration ==

619

620

621

Control the output duration 5V . Before each sampling, device will

622

623

~1. first enable the power output to external sensor,

624

625

2. keep it on as per duration, read sensor value and construct uplink payload

626

627

3. final, close the power output.

628

629

(% style="color:blue" %)**AT Command: AT+5VT**

630

631

(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:461px" %)

632

|=(% 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

633

|(% style="width:172px" %)AT+5VT=?|(% style="width:210px" %)Show 5V open time.|(% style="width:130px" %)0

634

OK

635

|(% style="width:172px" %)AT+5VT=0|(% style="width:210px" %)Normally closed 5V power supply.|(% style="width:130px" %)OK

636

default setting

637

|(% style="width:172px" %)AT+5VT=1000|(% style="width:210px" %)Close after a delay of 1000 milliseconds.|(% style="width:130px" %)(((

OK

)))

(% style="display:none" %) (%%)

644

645

== 2.7 Set the calculate flag ==

646

647

648

Feature: Set the calculate flag

649

650

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

651

652

(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:461px" %)

653

|=(% 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**

654

|(% style="width:172px" %)AT+CALCFLAG =450|(% style="width:210px" %)Set the calculate flag to 450.|(% style="width:130px" %)OK

655

|(% style="width:172px" %)AT+CALCFLAG =390|(% style="width:210px" %)Set the calculate flag to 390.|(% style="width:130px" %)OK

656

|(% style="width:172px" %)AT+CALCFLAG =64|(% style="width:210px" %)Set the calculate flag to 64.|(% style="width:130px" %)OK

657

|(% style="width:172px" %)AT+CALCFLAG =12|(% style="width:210px" %)Set the calculate flag to 12.|(% style="width:130px" %)OK

658

659

(% style="display:none" %) (%%)

660

661

== 2.8 Set count number ==

662

663

664

Feature: This setting can clear the pulse count to 0 or set it to a custom value.

665

666

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

667

668

(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:479px" %)

669

|=(% 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**

670

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

671

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

672

673

(% style="display:none" %) (%%)

674

675

676

== 2.9 Clock logging (Since firmware version v1.0.4) ==

677

678

679

Sometimes when we deploy lots of end nodes in field. We want all sensors sample data at the same time, and upload these data together for analyze. In such case, we can use clock loging feature.

680

681

We can use this command to set the start time of data recording and the time interval to meet the requirements of the specific collection time of data.

682

683

* (% style="color:blue" %)**AT Command: AT+CLOCKLOG=a,b,c,d**

684

685

(% style="color:blue" %)**a:**(%%)** 0:** Disable Clock logging. ** 1: **Enable Clock Logging

686

687

(% style="color:blue" %)**b: **(%%)Specify First sampling start second: range **(0 ~~ 3599, 65535) ** ~/~/ (% style="color:red" %)**Note:**(%%)** **If parameter b is set to 65535, the log period starts after the node accesses the network and sends packets.

688

689

(% style="color:blue" %)**c:**(%%)** **Specify the sampling interval: range **(0 ~~ 255 minutes)**

690

691

(% style="color:blue" %)**d: **(%%)How many entries should be uplink on every TDC **(max 32)**

692

693

(% aria-label="image-20240408084118-1.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/PS-NB-NA_NB-IoT_Analog_Sensor_User_Manual/WebHome/image-20240408084118-1.png?rev=1.1||alt="image-20240408084118-1.png" data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)

**Example:**

**AT+CLOCKLOG=1,65535,1,5**

698

699

After the node sends the first packet, data is recorded to the memory at intervals of 1 minute. For each TDC uplink, the uplink load will include: battery information + the last 5 memory records (payload + timestamp).

700

701

(% aria-label="image-20240422145554-3.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20240422145554-3.png||data-widget="image" height="489" width="997"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)

702

703

(% style="color:red" %)**Note: Users need to synchronize the server time before configuring this command. If the server time is not synchronized before this command is configured, the command takes effect only after the node is reset.**

704

705

706

== 2.10 Example Query saved historical records ==

707

708

709

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

710

711

This command can be used to search the saved history, recording up to 32 groups of data, each group of historical data contains a maximum of 100 bytes.

712

713

(% aria-label="image-20240422145238-1.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20240422145238-1.png||data-widget="image" height="683" width="887"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)

714

715

716

== 2.11 Uplink log query ==

717

718

719

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

720

721

This command can be used to query upstream logs of data packets.

722

723

(% aria-label="image-20240422145327-2.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20240422145327-2.png||data-widget="image" height="668" width="878"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)

724

725

726

== 2.12 Scheduled domain name resolution ==

727

728

729

This command is used to set up scheduled domain name resolution.

730

731

(% style="color:blue" %)**AT command:**

732

733

* (% style="color:#037691" %)**AT+DNSTIMER=XX **(%%)~/~/ Unit: hour

734

735

After setting this command, domain name resolution will be performed regularly.

736

737

738

= 3. Configure SW3L-NB =

739

740

== 3.1 Configure Methods ==

741

742

743

SW3L-NB supports below configure method:

744

745

* AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].

746

747

* 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]].

748

749

(% style="display:none" %) (%%)

750

751

== 3.2 AT Commands Set ==

752

753

754

AT+<CMD>? : Help on <CMD>

AT+<CMD> : Run <CMD>

AT+<CMD>=<value> : Set the value

759

760

AT+<CMD>=? : Get the value

761

762

763

(% style="color:blue" %)**General Commands**

AT : Attention

AT? : Short Help

ATZ : MCU Reset

AT+TDC : Application Data Transmission Interval

772

773

AT+CFG : Print all configurations

774

775

AT+MODEL :Get module information

776

777

AT+SLEEP :Get or set the sleep status

778

779

AT+DEUI : Get or set the Device ID

780

781

AT+APN : Get or set the APN

782

783

AT+5VT : Set extend the time of 5V power

784

785

AT+PTRIG : Get or Set Alarm for continuously water flow

786

787

AT+MOD : Get or Set the work mode of device

788

789

AT+CALCFLAG : Get or Set the calculate flag

790

791

AT+SETCNT : Get or set the count at present

792

793

AT+PRO : Choose agreement

794

795

AT+RXDL : Extend the sending and receiving time

796

797

AT+TR : Get or set data record time

798

799

AT+CDP : Read or Clear cached data

800

801

AT+NOUD : Get or Set the number of data to be uploaded

802

803

AT+DNSCFG : Get or Set DNS Server

804

805

AT+CSQTIME : Get or Set the time to join the network

806

807

AT+DNSTIMER : Get or Set the NDS timer

808

809

AT+TLSMOD : Get or Set the TLS mode

810

811

AT+GETSENSORVALUE : Returns the current sensor measurement

812

813

AT+SERVADDR : Server Address

814

815

816

(% style="color:blue" %)**MQTT Management**

817

818

AT+CLIENT : Get or Set MQTT client

819

820

AT+UNAME : Get or Set MQTT Username

821

822

AT+PWD : Get or Set MQTT password

823

824

AT+PUBTOPIC : Get or Set MQTT publish topic

825

826

AT+SUBTOPIC : Get or Set MQTT subscription topic

827

828

829

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

830

831

AT+FDR : Factory Data Reset

832

833

AT+PWORD : Serial Access Password

834

835

AT+LDATA : Get the last upload data

836

837

AT+CDP : Read or Clear cached data

838

839

840

= 4. Battery & Power Consumption =

841

842

843

SW3L-NB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.

844

845

[[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .

846

847

848

= 5. Firmware update =

849

850

851

User can change device firmware to::

852

853

* Update with new features.

* Fix bugs.

Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/sxrgszkac4ips0q/AABCplbUDBhAMazi2BGpcrCea/NB-IoT/SW3L-NB?dl=0&subfolder_nav_tracking=1]]**

858

859

Methods to Update Firmware:

860

861

* (Recommended way) OTA firmware update via BLE: [[**Instruction**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/BLE_Firmware_Update_NB_Sensors_BC660K-GL/]].

862

863

* Update through UART TTL interface : **[[Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/UART_Access_for_NB_ST_BC660K-GL/#H4.2UpdateFirmware28Assumethedevicealreadyhaveabootloader29]]**.

864

865

(% style="display:none" %) (%%)

= 6. FAQ =

== 6.1 How can I access t BC660K-GL AT Commands? ==

870

871

872

User can access to BC660K-GL directly and send AT Commands.

873

874

[[See BC660K-GL AT Command set>>url:https://www.dropbox.com/sh/5f6ssda5fum8rvs/AABT68l8ZzWOvZ5eg2qwOoFda?dl=0]]

875

876

877

== 6.2 How to configure the device through the MQTT subscription function? ==

878

879

880

Subscription content: {AT COMMAND}

881

882

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

883

884

Setting AT+5VT=500 through Node-RED requires MQTT to send the content {AT+5VT=500}.

885

886

(% aria-label="image-20231025162946-2.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:http://8.211.40.43/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/PS-NB-NA_NB-IoT_Analog_Sensor_User_Manual/WebHome/image-20231025162946-2.png?rev=1.1||alt="image-20231025162946-2.png" data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)

887

888

The serial port displays:

889

890

(% aria-label="image-20231025162958-3.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:http://8.211.40.43/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/PS-NB-NA_NB-IoT_Analog_Sensor_User_Manual/WebHome/image-20231025162958-3.png?rev=1.1||alt="image-20231025162958-3.png" data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)

= 7. Order Info =

Part Number: (% style="color:blue" %)**SW3L-NB-XX-YY**

897

898

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

899

900

* (% style="color:#037691" %)**GE**(%%): General version ( Exclude SIM card)

901

902

* (% style="color:#037691" %)**1D**(%%): with 1NCE* 10 years 500MB SIM card and Pre-configure to DataCake server

903

904

(% 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

905

906

(((

907

(% style="color:blue" %)**YY**(%%): Flow Sensor Model:

)))

(((

* **004:** DW-004 Flow Sensor: diameter: G1/2”/ DN15. 450 pulse = 1 L

)))

(((

* **006:** DW-006 Flow Sensor: diameter: G3/4”/ DN20. 390 pulse = 1 L

)))

(((

* **010:** DW-010 Flow Sensor: diameter: G1”/ DN25. 64 pulse = 1 L

)))

(((

* **020:** DW-020 Flow Sensor: diameter: G2”/ DN50. 12 pulse = 1 L

924

)))

925

926

(% style="display:none" %) (%%)

= 8. Packing Info =

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

932

933

* SW3L-NB NB-IoT Flow sensor x 1

934

935

* External antenna x 1

936

937

(% style="color:#037691" %)**Dimension and weight**:

938

939

* Device Size: 13.0 x 5 x 4.5 cm

940

941

* Device Weight: 150g

942

943

* Package Size / pcs : 14.0 x 8x 5 cm

944

945

* Weight / pcs : 180g

946

947

(% style="display:none" %) (%%)

= 9. Support =

* Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8. Due to different timezones we cannot offer live support. However, your questions will be answered as soon as possible in the before-mentioned schedule.

953

954

* 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-NB -- NB-IoT Flow Sensor User Manual

Applications

Navigation