Wiki source code of WL03A-NB -- NB-IoT None Position Rope Type Water Leak Controller User Manual
Version 136.1 by Mengting Qiu on 2024/02/04 09:35
Show last authors
author | version | line-number | content |
---|---|---|---|
1 | |||
2 | |||
3 | (% aria-label="image-20231019090514-1.png image widget" contenteditable="false" role="region" tabindex="-1" %) | ||
4 | ((( | ||
5 | (% data-widget="image" style="text-align:center" %) | ||
6 | [[image:image-20231019090514-1.png||height="563" width="826"]](% 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"]] | ||
9 | ))) | ||
10 | |||
11 | |||
12 | |||
13 | |||
14 | |||
15 | |||
16 | |||
17 | **Table of Contents:** | ||
18 | |||
19 | (% aria-label="macro:toc widget" contenteditable="false" role="region" tabindex="-1" %) | ||
20 | ((( | ||
21 | {{toc/}} | ||
22 | |||
23 | (% 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"]] | ||
24 | ))) | ||
25 | |||
26 | |||
27 | |||
28 | |||
29 | |||
30 | |||
31 | = 1. Introduction = | ||
32 | |||
33 | == 1.1 What is WL03A-NB NB-IoT None-Position Rope Type Water Leak Controller == | ||
34 | |||
35 | |||
36 | The Dragino WL03A-NB is a (% style="color:blue" %)**NB-IoT None-Position Rope Type Water Leak Controller**(%%). User can lay the (% style="color:blue" %)**WL03A-NB + Water Leak Cable**(%%) on the ground to detect water leakage. The water leak cable is sensitivity, when there is water over the leak cable. WL03A-NB will indicates a (% style="color:blue" %)**water leak event**(%%) and uplink to IoT server via NB-IoT network. | ||
37 | |||
38 | The WL03A-NB will send periodically data every 2 hours as well as for each water leak event. It also counts the water leak times and calculate last water leak duration. | ||
39 | |||
40 | WL03A-NB supports different uplink methods including (% style="color:blue" %)**MQTT, MQTTs, UDP & TCP**(%%) for different application requirement, and support uplinks to various IoT Servers. | ||
41 | |||
42 | WL03A-NB (% style="color:blue" %)**supports BLE configure **(%%)and(% style="color:blue" %)** OTA update**(%%) which make user easy to use. | ||
43 | |||
44 | WL03A-NB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long-term use up to several years. | ||
45 | |||
46 | WL03A-NB has optional built-in SIM card and default IoT server connection version. Which makes it works with simple configuration. | ||
47 | |||
48 | (% aria-label="image-20231019180455-1.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20231019180455-1.png||data-widget="image" height="304" width="883"]](% 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" %) | ||
49 | |||
50 | |||
51 | == 1.2 Features == | ||
52 | |||
53 | |||
54 | * NB-IoT Bands: B1/B2/B3/B4/B5/B8/B12/B13/B17/B18/B19/B20/B25/B28/B66/B70/B85 @H-FDD | ||
55 | * Ultra-low power consumption | ||
56 | * Upload water flow volume | ||
57 | * Water Leak detect | ||
58 | * Multiply Sampling and one uplink | ||
59 | * Support Bluetooth v5.1 remote configure and update firmware | ||
60 | * Uplink on periodically | ||
61 | * Downlink to change configure | ||
62 | * 8500mAh Battery for long term use | ||
63 | * Nano SIM card slot for NB-IoT SIM | ||
64 | |||
65 | (% style="display:none" %) | ||
66 | |||
67 | |||
68 | == 1.3 Specification == | ||
69 | |||
70 | |||
71 | (% style="color:blue" %)**Common DC Characteristics:** | ||
72 | |||
73 | * Supply Voltage: 2.5v ~~ 3.6v | ||
74 | * Operating Temperature: -40 ~~ 85°C | ||
75 | |||
76 | (% style="color:blue" %)**NB-IoT Spec:** | ||
77 | |||
78 | (% style="color:#037691" %)**NB-IoT Module: BC660K-GL** | ||
79 | |||
80 | (% style="color:#037691" %)**Support Bands:** | ||
81 | |||
82 | * B1 @H-FDD: 2100MHz | ||
83 | * B2 @H-FDD: 1900MHz | ||
84 | * B3 @H-FDD: 1800MHz | ||
85 | * B4 @H-FDD: 2100MHz | ||
86 | * B5 @H-FDD: 860MHz | ||
87 | * B8 @H-FDD: 900MHz | ||
88 | * B12 @H-FDD: 720MHz | ||
89 | * B13 @H-FDD: 740MHz | ||
90 | * B17 @H-FDD: 730MHz | ||
91 | * B18 @H-FDD: 870MHz | ||
92 | * B19 @H-FDD: 870MHz | ||
93 | * B20 @H-FDD: 790MHz | ||
94 | * B25 @H-FDD: 1900MHz | ||
95 | * B28 @H-FDD: 750MHz | ||
96 | * B66 @H-FDD: 2000MHz | ||
97 | * B70 @H-FDD: 2000MHz | ||
98 | * B85 @H-FDD: 700MHz | ||
99 | |||
100 | (% style="color:blue" %)**Battery:** | ||
101 | |||
102 | * Li/SOCI2 un-chargeable battery | ||
103 | * Capacity: 8500mAh | ||
104 | * Self Discharge: <1% / Year @ 25°C | ||
105 | * Max continuously current: 130mA | ||
106 | * Max boost current: 2A, 1 second | ||
107 | |||
108 | (% style="color:blue" %)**Power Consumption** | ||
109 | |||
110 | * STOP Mode: 10uA @ 3.3v | ||
111 | * Max transmit power: 350mA@3.3v | ||
112 | |||
113 | (% style="display:none" %) (%%) | ||
114 | |||
115 | == 1.4 Applications == | ||
116 | |||
117 | |||
118 | * Smart Buildings & Home Automation | ||
119 | * Smart Cities | ||
120 | * Smart Factory | ||
121 | |||
122 | (% style="display:none" %) (%%) | ||
123 | |||
124 | == 1.5 Sleep mode and working mode == | ||
125 | |||
126 | |||
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. | ||
128 | |||
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. | ||
130 | |||
131 | |||
132 | == 1.6 Button & LEDs == | ||
133 | |||
134 | |||
135 | (% 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" %) | ||
136 | |||
137 | |||
138 | (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) | ||
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** | ||
140 | |(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:117px" %)Send an uplink|(% style="width:225px" %)((( | ||
141 | If sensor has already attached to NB-IoT network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once. | ||
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" %)((( | ||
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. | ||
146 | (% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network. | ||
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. | ||
148 | ))) | ||
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. | ||
150 | |||
151 | (% 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.** | ||
152 | |||
153 | |||
154 | == 1.7 BLE connection == | ||
155 | |||
156 | |||
157 | WL03A-NB support BLE remote configure and firmware update. | ||
158 | |||
159 | |||
160 | 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: | ||
161 | |||
162 | * Press button to send an uplink | ||
163 | * Press button to active device. | ||
164 | * Device Power on or reset. | ||
165 | |||
166 | If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode. | ||
167 | |||
168 | |||
169 | == 1.8 Pin Definitions , Switch & SIM Direction == | ||
170 | |||
171 | |||
172 | (% 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" %) | ||
173 | |||
174 | |||
175 | === 1.8.1 Jumper JP2 === | ||
176 | |||
177 | |||
178 | Power on Device when put this jumper. | ||
179 | |||
180 | |||
181 | === 1.8.2 BOOT MODE / SW1 === | ||
182 | |||
183 | |||
184 | **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. | ||
185 | |||
186 | **2)** (% style="color:blue" %)**Flash**(%%): work mode, device starts to work and send out console output for further debug | ||
187 | |||
188 | |||
189 | === 1.8.3 Reset Button === | ||
190 | |||
191 | |||
192 | Press to reboot the device. | ||
193 | |||
194 | |||
195 | === 1.8.4 SIM Card Direction === | ||
196 | |||
197 | |||
198 | 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]]. | ||
199 | |||
200 | |||
201 | == 1.9 Mechanical == | ||
202 | |||
203 | (% 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" %) | ||
204 | |||
205 | (% 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" %) | ||
206 | |||
207 | (% 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" %) | ||
208 | |||
209 | |||
210 | == 1.10 Installation == | ||
211 | |||
212 | |||
213 | (% aria-label="image-20230522111349-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/WL03A-LB_LoRaWAN_None-Position_Rope_Type_Water_Leak_Controller_User_Manual/WebHome/image-20230522111349-3.png?width=676&height=790&rev=1.1||alt="image-20230522111349-3.png" data-widget="image" height="708" width="606"]](% 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" %) | ||
214 | |||
215 | |||
216 | |||
217 | (% aria-label="image-20230522112514-4.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/WL03A-LB_LoRaWAN_None-Position_Rope_Type_Water_Leak_Controller_User_Manual/WebHome/image-20230522112514-4.png?width=775&height=560&rev=1.1||alt="image-20230522112514-4.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" %) | ||
218 | |||
219 | |||
220 | = 2. Use WL03A-NB to communicate with IoT Server = | ||
221 | |||
222 | == 2.1 Send data to IoT server via NB-IoT network == | ||
223 | |||
224 | |||
225 | The WL03A-NB is equipped with a NB-IoT module, the pre-loaded firmware in WL03A-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 WL03A-NB. | ||
226 | |||
227 | |||
228 | Below shows the network structure: | ||
229 | |||
230 | (% aria-label="image-20231019180455-1.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20231019180455-1.png||data-widget="image" height="304" width="883"]](% 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" %) | ||
231 | |||
232 | |||
233 | There are two version: (% style="color:blue" %)**-GE**(%%) and (% style="color:blue" %)**-1D**(%%) version of WL03A-NB. | ||
234 | |||
235 | |||
236 | (% 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 WL03A-NB send data to IoT server. | ||
237 | |||
238 | * 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]]. | ||
239 | |||
240 | * 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]]. | ||
241 | |||
242 | Below shows result of different server as a glance. | ||
243 | |||
244 | (% border="1" cellspacing="4" style="width:515px" %) | ||
245 | |(% 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** | ||
246 | |(% 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" %)((( | ||
247 | (% aria-label="image-20230819113244-8.png image widget" contenteditable="false" role="region" tabindex="-1" %) | ||
248 | ((( | ||
249 | (% data-widget="image" style="text-align:center" %) | ||
250 | [[image:image-20230819113244-8.png||height="183" width="367"]](% title="Click and drag to resize" %) | ||
251 | |||
252 | (% 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"]] | ||
253 | ))) | ||
254 | )))|(% style="width:170px" %) | ||
255 | |(% 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" %)((( | ||
256 | (% aria-label="image-20230819113244-9.png image widget" contenteditable="false" role="region" tabindex="-1" %) | ||
257 | ((( | ||
258 | (% data-widget="image" style="text-align:center" %) | ||
259 | [[image:image-20230819113244-9.png||height="119" width="367"]](% title="Click and drag to resize" %) | ||
260 | |||
261 | (% 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"]] | ||
262 | ))) | ||
263 | )))|(% style="width:170px" %) | ||
264 | |(% 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" %) | ||
265 | |(% 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" %) | ||
266 | |(% 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" %) | ||
267 | |(% 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" %)((( | ||
268 | (% aria-label="image-20230819113244-10.png image widget" contenteditable="false" role="region" tabindex="-1" %) | ||
269 | ((( | ||
270 | (% data-widget="image" style="text-align:center" %) | ||
271 | [[image:image-20230819113244-10.png||height="104" width="367"]](% title="Click and drag to resize" %) | ||
272 | |||
273 | (% 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"]] | ||
274 | ))) | ||
275 | )))|(% style="width:170px" %) | ||
276 | |(% 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" %)((( | ||
277 | (% aria-label="image-20230819113244-11.png image widget" contenteditable="false" role="region" tabindex="-1" %) | ||
278 | ((( | ||
279 | (% data-widget="image" style="text-align:center" %) | ||
280 | [[image:image-20230819113244-11.png||height="141" width="367"]](% title="Click and drag to resize" %) | ||
281 | |||
282 | (% 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"]] | ||
283 | ))) | ||
284 | )))|(% style="width:170px" %) | ||
285 | |||
286 | (% 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 WL03A-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]]. | ||
287 | |||
288 | |||
289 | == 2.2 Payload Types == | ||
290 | |||
291 | |||
292 | To meet different server requirement, WL03A-NB supports different payload type. | ||
293 | |||
294 | **Includes:** | ||
295 | |||
296 | * [[General JSON format payload>>||anchor="H2.2.1GeneralJsonFormat28Type3D529"]]. (Type=5) | ||
297 | |||
298 | * [[HEX format Payload>>||anchor="H2.2.2HEXformatPayload28Type3D029"]]. (Type=0) | ||
299 | |||
300 | * [[ThingSpeak Format>>||anchor="H2.2.4ThingSpeakPayload28Type3D129"]]. (Type=1) | ||
301 | |||
302 | * [[ThingsBoard Format>>||anchor="H2.2.3ThingsBoardPayload28Type3D329"]]. (Type=3) | ||
303 | |||
304 | User can specify the payload type when choose the connection protocol. Example: | ||
305 | |||
306 | (% style="color:#037691" %)**AT+PRO=2,0** (%%) ~/~/ Use UDP Connection & hex Payload | ||
307 | |||
308 | (% style="color:#037691" %)**AT+PRO=2,5**(%%) ~/~/ Use UDP Connection & Json Payload | ||
309 | |||
310 | (% style="color:#037691" %)**AT+PRO=3,0** (%%)** ** ~/~/ Use MQTT Connection & Json Payload | ||
311 | |||
312 | (% style="color:#037691" %)**AT+PRO=3,1** (%%) ~/~/ Use MQTT Connection & ThingSpeak | ||
313 | |||
314 | (% style="color:#037691" %)**AT+PRO=3,3** (%%)** ** ~/~/ Use MQTT Connection & ThingsBoard | ||
315 | |||
316 | (% style="color:#037691" %)**AT+PRO=3,5**(%%)** ** ~/~/ Use MQTT Connection & Json Payload | ||
317 | |||
318 | (% style="color:#037691" %)**AT+PRO=4,0**(%%) ~/~/ Use TDP Connection & hex Payload | ||
319 | |||
320 | (% style="color:#037691" %)**AT+PRO=4,5**(%%) ~/~/ Use TDP Connection & Json Payload | ||
321 | |||
322 | |||
323 | === 2.2.1 General Json Format(Type~=5) === | ||
324 | |||
325 | |||
326 | This is the General Json Format. As below: | ||
327 | |||
328 | (% style="color:#4472c4" %)**{"IMEI":"866207058378443","Model":"WL03A-NB","status":0,"leak_times":6,"last_leak_time":4,"battery":3.431,"signal":22,"1":{0,1581823333,4,2023/11/16 08:32:47},"2":{0,1581823333,4,2023/11/16 08:17:47},"3":{0,1682486617,4,2023/11/16 08:02:47},"4":{0,1699263831,0,2023/11/16 07:47:46},"5":{0,1699263831,0,2023/11/16 07:32:46},"6":{0,1699263831,0,2023/11/16 07:17:46},"7":{0,1699263831,0,2023/11/16 07:02:46},"8":{0,0,0,1970/01/01 00:00:11}}** | ||
329 | |||
330 | |||
331 | (% style="display:none" %) (%%) (% aria-label="image-20231116164938-3.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20231116164938-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" %) | ||
332 | |||
333 | |||
334 | (% style="color:red" %)**Notice, from above payload:** | ||
335 | |||
336 | * Leak_status, Leak_times, Last_leak_time, Battery & Signal are the value at uplink time. | ||
337 | |||
338 | * 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): Leak_times, Last_leak_time & Sampling time. | ||
339 | |||
340 | (% style="display:none" %) (%%) | ||
341 | |||
342 | === 2.2.2 HEX format Payload(Type~=0) === | ||
343 | |||
344 | |||
345 | This is the HEX Format. As below: | ||
346 | |||
347 | (% style="color:#4472c4" %)**f86620705837844314640d65170000010010000000006555d8180110000000006555d3af0000010000036555d02a0000020000036555d02b0000010000036555102c0000010000036555d02c0000010000036555e02c0000010000036555d02f** | ||
348 | |||
349 | (% aria-label="image-20231116135353-1.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20231116135353-1.png||data-widget="image" height="171" width="1056"]](% 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" %) | ||
350 | |||
351 | |||
352 | (% aria-label="image-20231116165643-4.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20231116165643-4.png||data-widget="image" height="896" width="940"]](% 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" %) | ||
353 | |||
354 | |||
355 | (% style="color:blue" %)**Version:** | ||
356 | |||
357 | These bytes include the hardware and software version. | ||
358 | |||
359 | (% style="color:#037691" %)**Higher byte:**(%%) Specify Sensor Model: 0x14 for WL03A-NB | ||
360 | |||
361 | (% style="color:#037691" %)**Lower byte:**(%%) Specify the software version: 0x64=100, means firmware version 1.0.0 | ||
362 | |||
363 | |||
364 | (% style="color:blue" %)**BAT (Battery Info):** | ||
365 | |||
366 | Ex1: 0x0dda = 3546mV | ||
367 | |||
368 | |||
369 | (% style="color:blue" %)**Signal Strength:** | ||
370 | |||
371 | NB-IoT Network signal Strength. | ||
372 | |||
373 | **Ex1: 0x15 = 21** | ||
374 | |||
375 | **0** -113dBm or less | ||
376 | |||
377 | **1** -111dBm | ||
378 | |||
379 | **2...30** -109dBm... -53dBm | ||
380 | |||
381 | **31** -51dBm or greater | ||
382 | |||
383 | **99** Not known or not detectable | ||
384 | |||
385 | |||
386 | ((( | ||
387 | (% style="color:blue" %)**Alarm:** | ||
388 | ))) | ||
389 | |||
390 | See 2.9 Alarm Base on Timeout. | ||
391 | |||
392 | |||
393 | ((( | ||
394 | (% style="color:blue" %)**Count mod:Default=0** | ||
395 | ))) | ||
396 | |||
397 | 0 ~-~-> Uplink total leak times since factory | ||
398 | |||
399 | 1 ~-~-> Uplink total leak times since last uplink. | ||
400 | |||
401 | |||
402 | (% style="color:blue" %)**TDC_flag:** | ||
403 | |||
404 | 0 ~-~-> It is not an uplink sent when TDC or Leakalarm. | ||
405 | |||
406 | 1 ~-~->It is an uplink sent when TDC or Leakalarm. | ||
407 | |||
408 | |||
409 | ((( | ||
410 | (% style="color:blue" %)**Leak status:** | ||
411 | ))) | ||
412 | |||
413 | This byte is 1 when the leak sensor is leak and 0 when it is no leak. | ||
414 | |||
415 | |||
416 | ((( | ||
417 | (% style="color:blue" %)**Leak times:** | ||
418 | ))) | ||
419 | |||
420 | Total pulse/counting base on leak. | ||
421 | |||
422 | Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215 | ||
423 | |||
424 | |||
425 | ((( | ||
426 | (% style="color:blue" %)**Last leak duration:** | ||
427 | ))) | ||
428 | |||
429 | Leak sensor last leak duration. | ||
430 | |||
431 | Unit: sec. | ||
432 | |||
433 | (% aria-label="image-20230701102155-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/WL03A-LB_LoRaWAN_None-Position_Rope_Type_Water_Leak_Controller_User_Manual/WebHome/image-20230701102155-1.png?width=837&height=176&rev=1.1||alt="image-20230701102155-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" %) | ||
434 | |||
435 | |||
436 | (% style="color:blue" %)**Timestamp: ** | ||
437 | |||
438 | Unit Timestamp Example: 650abc40(H) = 1695202368(D) | ||
439 | |||
440 | Put the decimal value into this link([[https:~~/~~/www.epochconverter.com)>>https://www.epochconverter.com]]) to get the time. | ||
441 | |||
442 | |||
443 | === 2.2.3 ThingsBoard Payload(Type~=3) === | ||
444 | |||
445 | |||
446 | Type3 payload special design for ThingsBoard, it will also configure other default server to ThingsBoard. | ||
447 | |||
448 | (% style="color:#4472c4" %)** { | ||
449 | "IMEI": "866207058378443", | ||
450 | "Model": "WL03A-NB", | ||
451 | "status": 1, | ||
452 | "leak_times": 20, | ||
453 | "last_leak_time": 1, | ||
454 | "battery": 3.401, | ||
455 | "signal": 21 | ||
456 | }** | ||
457 | |||
458 | (% aria-label="image-20231116180056-6.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20231116180056-6.png||data-widget="image" height="589" width="1178"]](% 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" %) | ||
459 | |||
460 | |||
461 | === 2.2.4 ThingSpeak Payload(Type~=1) === | ||
462 | |||
463 | |||
464 | This payload meets ThingSpeak platform requirement. It includes only five fields. Form 1~~5are: | ||
465 | |||
466 | Status, Leak_times, Last_leak_time, Battery & Signal. This payload type only valid for ThingsSpeak Platform. | ||
467 | |||
468 | As below: | ||
469 | |||
470 | (% style="color:#4472c4" %)**field1=Leak_status value&field2=Leak_times value&field3=Last_leak_time value&field4=Battery value&field5=Singal value** | ||
471 | |||
472 | (% aria-label="image-20231114170715-3.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20231114170715-3.png||data-widget="image" height="928" width="1095"]](% 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" %) | ||
473 | |||
474 | |||
475 | == 2.3 Test Uplink and Change Update Interval == | ||
476 | |||
477 | |||
478 | By default, Sensor will send uplinks (% style="color:blue" %)**every 2 hours**(%%) & AT+NOUD=8 | ||
479 | |||
480 | User can use below commands to change the (% style="color:blue" %)**uplink interval**. | ||
481 | |||
482 | (% style="color:#037691" %)**AT+TDC=600 ** (%%) ~/~/ Set Update Interval to 600s | ||
483 | |||
484 | User can also push the button for more than 1 seconds to activate an uplink. | ||
485 | |||
486 | |||
487 | == 2.4 Multi-Samplings and One uplink == | ||
488 | |||
489 | |||
490 | (% style="color:red" %)**Note: When WL03A-NB is reset and AT+COUNTMOD=0, the leak times will be read from the latest recorded data as the initial value.** | ||
491 | |||
492 | To save battery life, WL03A-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: | ||
493 | |||
494 | * (% 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) | ||
495 | |||
496 | * (% 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. | ||
497 | |||
498 | The diagram below explains the relationship between TR, NOUD, and TDC more clearly: | ||
499 | |||
500 | (% 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" %) | ||
501 | |||
502 | |||
503 | == 2.5 Enable / Disable Alarm == | ||
504 | |||
505 | |||
506 | Feature: Enable/Disable Alarm for open/close event. Default value 0. | ||
507 | |||
508 | (% style="color:blue" %)**AT Command:** | ||
509 | |||
510 | (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:500px" %) | ||
511 | |=(% style="width: 157px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 257px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 86px;background-color:#4F81BD;color:white" %)**Response** | ||
512 | |(% style="width:157px" %)AT+DISALARM=1|(% style="width:257px" %)End node will only send packet in TDC time.|OK | ||
513 | |(% style="width:157px" %)AT+DISALARM=0|(% style="width:257px" %)End node will send packet in TDC time or status change for water leak sensor|OK | ||
514 | |||
515 | (% style="display:none" %) (%%) | ||
516 | |||
517 | == 2.6 Alarm Base on Timeout == | ||
518 | |||
519 | |||
520 | WL03A-NB can monitor the timeout for a status change, this feature can be used to monitor some events such as door opening too long etc. | ||
521 | |||
522 | User configure this feature by using: | ||
523 | |||
524 | (% style="color:blue" %)**AT Command to configure:** | ||
525 | |||
526 | * (% style="color:red" %)**AT+TTRIG=1,30** (%%) **~-~->** When status change from no leak to leak, and device keep in leak status for more than 30 seconds. WL03A-NB will send an uplink packet, the Alarm bit (the second bit of 1^^st^^ byte of payload) on this uplink packet is set to 1. | ||
527 | |||
528 | * (% style="color:red" %)**AT+TTRIG=0,30**(%%) **~-~->** When status change from leak to no leak, and device keep in no leak status for more than 30 seconds. WL03A-NB will send an uplink packet, the Alarm bit (the second bit of 1^^st^^ byte of payload) on this uplink packet is set to 1. | ||
529 | |||
530 | * ((( | ||
531 | (% style="color:red" %)**AT+TTRIG=0,0** (%%) **~-~-> ** Default Value, disable timeout Alarm. | ||
532 | ))) | ||
533 | |||
534 | (% style="display:none" %) (%%) | ||
535 | |||
536 | == 2.7 The working mode of the total water leakage event == | ||
537 | |||
538 | |||
539 | Feature:Counting mode | ||
540 | |||
541 | (% style="color:blue" %)**AT Command to configure:** | ||
542 | |||
543 | * (% style="color:red" %)**AT+COUNTMOD=0** (%%)**~-~->** Default Value, Total leak events since factory. | ||
544 | |||
545 | * (% style="color:red" %)**AT+COUNTMOD=1** (%%)**~-~->** Total leak events since last TDC uplink. | ||
546 | |||
547 | (% style="display:none" %) (%%) | ||
548 | |||
549 | == 2.8 Regularly update a uplink when water leaks == | ||
550 | |||
551 | |||
552 | Feature: The interval between each uplink delivery when there is water leakage. | ||
553 | |||
554 | (% style="color:blue" %)**AT Command to configure:** | ||
555 | |||
556 | * (% style="color:red" %)**AT+LEAKALARM=10** (%%)**~-~->** Default Value, A periodically update at every 10 minutes when in water leak. | ||
557 | |||
558 | * (% style="color:red" %)**AT+LEAKALARM=0** (%%)**~-~->** Disable a periodically update when in water leak. | ||
559 | |||
560 | (% style="display:none" %) (%%) | ||
561 | |||
562 | == 2.9 Delay time for state changes to take effectEdit == | ||
563 | |||
564 | |||
565 | Feature: Sensitivity settings for water leak detection | ||
566 | |||
567 | (% style="color:blue" %)**AT Command to configure:** | ||
568 | |||
569 | * (% style="color:red" %)**AT+DETEDELAY=50**(%%) **~-~->** Default Value, Set state change, valid signal is 50ms. | ||
570 | |||
571 | * (% style="color:red" %)**AT+DETEDELAY=0**(%%) **~-~->** Disable valid signal detection. | ||
572 | |||
573 | (% style="display:none" %) (%%) | ||
574 | |||
575 | == 2.10 Clear the leak count and the duration of the last leak == | ||
576 | |||
577 | |||
578 | Feature: Clear last duration and count values. | ||
579 | |||
580 | (% style="color:blue" %)**AT Command:** | ||
581 | |||
582 | (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:500px" %) | ||
583 | |=(% style="background-color: #4F81BD;color:white; width: 160px;" %)**Command Example**|=(% style="background-color: #4F81BD;color:white; width: 254px;" %)**Function**|=(% style="background-color:#4F81BD;color:white" %)**Response** | ||
584 | |(% style="width:160px" %)AT+CLRC|(% style="width:254px" %)clear the leak count and the duration of the last leak.|OK | ||
585 | |||
586 | (% style="display:none" %) (%%) | ||
587 | |||
588 | == 2.11 Set the count value of the number of leaks == | ||
589 | |||
590 | |||
591 | Feature: This setting can clear the pulse count to 0 or set it to a custom value. | ||
592 | |||
593 | (% style="color:blue" %)**AT Command:** | ||
594 | |||
595 | (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:500px" %) | ||
596 | |=(% style="background-color:#4F81BD;color:white; width: 160px;" %)**Command Example**|=(% style="background-color:#4F81BD;color:white; width: 254px;" %)**Function**|=(% style="background-color:#4F81BD;color:white" %)**Response** | ||
597 | |(% style="width:160px" %)AT+ SETCNT =0|(% style="width:254px" %)Clear the leak count value to 0.|OK | ||
598 | |(% style="width:160px" %)AT+SETCNT=100|(% style="width:254px" %)Set the leak count value to 100|OK | ||
599 | |||
600 | (% style="display:none" %) (%%) | ||
601 | |||
602 | = 3. Configure WL03A-NB = | ||
603 | |||
604 | == 3.1 Configure Methods == | ||
605 | |||
606 | |||
607 | WL03A-NB supports below configure method: | ||
608 | |||
609 | * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]]. | ||
610 | |||
611 | * 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]]. | ||
612 | |||
613 | (% style="display:none" %) (%%) | ||
614 | |||
615 | == 3.2 AT Commands Set == | ||
616 | |||
617 | |||
618 | AT+<CMD>? : Help on <CMD> | ||
619 | |||
620 | AT+<CMD> : Run <CMD> | ||
621 | |||
622 | AT+<CMD>=<value> : Set the value | ||
623 | |||
624 | AT+<CMD>=? : Get the value | ||
625 | |||
626 | |||
627 | (% style="color:blue" %)**General Commands** | ||
628 | |||
629 | AT : Attention | ||
630 | |||
631 | AT? : Short Help | ||
632 | |||
633 | ATZ : MCU Reset | ||
634 | |||
635 | AT+TDC : Application Data Transmission Interval | ||
636 | |||
637 | AT+CFG : Print all configurations | ||
638 | |||
639 | AT+CFGMOD : Working mode selection | ||
640 | |||
641 | AT+DEUI : Get or set the Device ID | ||
642 | |||
643 | AT+5VT : Set extend the time of 5V power | ||
644 | |||
645 | AT+CLRC : Clear the leak count and the duration of the last leak | ||
646 | |||
647 | AT+SETCNT : Get or set the count at present | ||
648 | |||
649 | AT+DISALARM : Enable/Disable Alarm for door open/close or water leak event | ||
650 | |||
651 | AT+LEAKALARM : Get or Set the alarm interval for water leakage | ||
652 | |||
653 | AT+DETEDELAY : Get or Set the detection delay of pin | ||
654 | |||
655 | AT+COUNTMOD : Get or Set the count mode of water leakage | ||
656 | |||
657 | AT+TTRIG : Get or Set Alarm Base on Timeout(PA8) | ||
658 | |||
659 | AT+PRO : Choose agreement | ||
660 | |||
661 | AT+RXDL : Extend the sending and receiving time | ||
662 | |||
663 | AT+DNSCFG : Get or Set DNS Server | ||
664 | |||
665 | AT+GETSENSORVALUE : Returns the current sensor measurement | ||
666 | |||
667 | AT+NOUD : Get or Set the number of data to be uploaded | ||
668 | |||
669 | AT+CDP : Read or Clear cached data | ||
670 | |||
671 | AT+SERVADDR : Server Address | ||
672 | |||
673 | |||
674 | (% style="color:blue" %)**UDP Management** | ||
675 | |||
676 | AT+CFM : Upload confirmation mode (only valid for UDP) | ||
677 | |||
678 | |||
679 | (% style="color:blue" %)**MQTT Management** | ||
680 | |||
681 | AT+CLIENT : Get or Set MQTT client | ||
682 | |||
683 | AT+UNAME : Get or Set MQTT Username | ||
684 | |||
685 | AT+PWD : Get or Set MQTT password | ||
686 | |||
687 | AT+PUBTOPIC : Get or Set MQTT publish topic | ||
688 | |||
689 | AT+SUBTOPIC : Get or Set MQTT subscription topic | ||
690 | |||
691 | |||
692 | (% style="color:blue" %)**Information** | ||
693 | |||
694 | AT+FDR : Factory Data Reset | ||
695 | |||
696 | AT+PWORD : Serial Access Password | ||
697 | |||
698 | AT+LDATA : Get the last upload data | ||
699 | |||
700 | AT+CDP : Read or Clear cached data | ||
701 | |||
702 | |||
703 | = 4. Battery & Power Consumption = | ||
704 | |||
705 | |||
706 | WL03A-NB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace. | ||
707 | |||
708 | [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] . | ||
709 | |||
710 | |||
711 | = 5. Firmware update = | ||
712 | |||
713 | |||
714 | User can change device firmware to:: | ||
715 | |||
716 | * Update with new features. | ||
717 | |||
718 | * Fix bugs. | ||
719 | |||
720 | Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/7jx2wm9qii596qt/AAAVck4GLw6KV8NXdDDmXXJya?dl=0]]** | ||
721 | |||
722 | Methods to Update Firmware: | ||
723 | |||
724 | * (Recommended way) OTA firmware update via BLE: [[**Instruction**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/BLE_Firmware_Update_NB_Sensors_BC660K-GL/]]. | ||
725 | |||
726 | * Update through UART TTL interface : **[[Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/UART_Access_for_NB_ST_BC660K-GL/#H4.2UpdateFirmware28Assumethedevicealreadyhaveabootloader29]]**. | ||
727 | |||
728 | (% style="display:none" %) (%%) | ||
729 | |||
730 | = 6. FAQ = | ||
731 | |||
732 | == 6.1 How can I access t BC660K-GL AT Commands? == | ||
733 | |||
734 | |||
735 | User can access to BC660K-GL directly and send AT Commands. | ||
736 | |||
737 | [[See BC660K-GL AT Command set>>url:https://www.dropbox.com/sh/5f6ssda5fum8rvs/AABT68l8ZzWOvZ5eg2qwOoFda?dl=0]] | ||
738 | |||
739 | |||
740 | == 6.2 How to configure the device through the MQTT subscription function? == | ||
741 | |||
742 | |||
743 | Subscription content: {AT COMMAND} | ||
744 | |||
745 | (% style="color:#037691" %)**Example:** | ||
746 | |||
747 | Setting AT+5VT=500 through Node-RED requires MQTT to send the content {AT+5VT=500}. | ||
748 | |||
749 | (% 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" %) | ||
750 | |||
751 | The serial port displays: | ||
752 | |||
753 | (% 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" %) | ||
754 | |||
755 | |||
756 | = 7. Order Info = | ||
757 | |||
758 | |||
759 | **Part Number: (% style="color:blue" %)WL03A-NB-XX(%%)** | ||
760 | |||
761 | (% style="color:red" %)**XX**(%%): | ||
762 | |||
763 | * (% style="color:#037691" %)**GE**(%%): General version ( Exclude SIM card) | ||
764 | |||
765 | * (% style="color:#037691" %)**1D**(%%): with 1NCE* 10 years 500MB SIM card and Pre-configure to DataCake server | ||
766 | |||
767 | (% 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 | ||
768 | |||
769 | (% style="color:red" %)**Notice: WL03A-NB includes a one meter water leak cable, If user want to extend the lenght, please choose Water Leak Cable DR-WLN-XX.** | ||
770 | |||
771 | |||
772 | **Water Leak Cable Part Number: (% style="color:blue" %)DR-WLN-XX(%%)** | ||
773 | |||
774 | (% style="color:blue" %)**XX:** | ||
775 | |||
776 | * (% style="color:red" %)**1M : **(%%)1 meter water leak cable | ||
777 | |||
778 | * (% style="color:red" %)**5M : **(%%)5 meters water leak cable | ||
779 | |||
780 | * (% style="color:red" %)**10M: **(%%)10 meters water leak cable | ||
781 | |||
782 | (% style="display:none" %) (%%) | ||
783 | |||
784 | = 8. Packing Info = | ||
785 | |||
786 | |||
787 | (% style="color:#037691" %)**Package Includes**: | ||
788 | |||
789 | * 1 x WL03A-NB NB-IoT None-Position Rope Type Water Leak Controller | ||
790 | |||
791 | * 1 x 1m water lead cable | ||
792 | |||
793 | * 1 x termination end | ||
794 | |||
795 | (% style="color:#037691" %)**Dimension and weight**: | ||
796 | |||
797 | * Device Size: 13.0 x 5 x 4.5 cm | ||
798 | |||
799 | * Device Weight: 150g | ||
800 | |||
801 | * Package Size / pcs : 14.0 x 8x 5 cm | ||
802 | |||
803 | * Weight / pcs : 180g | ||
804 | |||
805 | (% style="display:none" %) (%%) | ||
806 | |||
807 | = 9. Support = | ||
808 | |||
809 | |||
810 | * 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. | ||
811 | |||
812 | * 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]]. |