Wiki source code of DDS20-NB_NB-IoT_Ultrasonic_Liquid_Level_Sensor_User_Manual
Show last authors
author | version | line-number | content |
---|---|---|---|
1 | (% style="text-align:center" %) | ||
2 | [[image:image-20230819102136-3.png]] | ||
3 | |||
4 | |||
5 | |||
6 | **Table of Contents:** | ||
7 | |||
8 | {{toc/}} | ||
9 | |||
10 | |||
11 | |||
12 | |||
13 | |||
14 | |||
15 | = 1. Introduction = | ||
16 | |||
17 | == 1.1 What is S31x-NB NB-IoT Temperature & Humidity Sensor == | ||
18 | |||
19 | |||
20 | The Dragino S31-NB and S31B-NB are (% style="color:blue" %)**NB-IoT Temperature and Humidity Sensor**(%%) for Internet of Things solution. It is used to measure the surrounding (% style="color:blue" %)**environment temperature and relative air humidity precisely**(%%), and then upload to IoT server via NB-IoT network*. | ||
21 | |||
22 | The temperature & humidity sensor used in S31-NB is SHT31, which is fully calibrated, linearized, and temperature compensated digital output from Sensirion, it provides a strong reliability and long-term stability. The SHT31 is fixed in a (% style="color:blue" %)**waterproof anti-condensation casing**(%%) for long term use. | ||
23 | |||
24 | S31-NB supports different uplink methods include (% style="color:blue" %)**TCP, MQTT, UDP**(%%) for different application requirement. and Support Uplinks to various IoT Servers. | ||
25 | |||
26 | S31-NB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), It is designed for long term use up to several years. (Real-world battery life depends on the use environment, update period and uplink method. Please check related Power Analyze report). | ||
27 | |||
28 | *make sure you have NB-IoT coverage locally. | ||
29 | |||
30 | |||
31 | [[image:1692411831805-116.png]] | ||
32 | |||
33 | |||
34 | == 1.2 Features == | ||
35 | |||
36 | |||
37 | * NB-IoT Bands: B1/B2/B3/B4/B5/B8/B12/B13/B17/B18/B19/B20/B25/B28/B66/B70/B85 @H-FDD | ||
38 | * Ultra-low power consumption | ||
39 | * External 3 meters SHT31 probe (For S31-NB) | ||
40 | * Measure range -40°C ~~ 85°C | ||
41 | * Temperature & Humidity alarm | ||
42 | * Multiply Sampling and one uplink | ||
43 | * Support Bluetooth v5.1 remote configure and update firmware | ||
44 | * Uplink on periodically | ||
45 | * Downlink to change configure | ||
46 | * 8500mAh Battery for long term use | ||
47 | * Nano SIM card slot for NB-IoT SIM | ||
48 | |||
49 | |||
50 | == 1.3 Specification == | ||
51 | |||
52 | |||
53 | (% style="color:blue" %)**Common DC Characteristics:** | ||
54 | |||
55 | * Supply Voltage: 2.1v ~~ 3.6v | ||
56 | * Operating Temperature: -40 ~~ 85°C | ||
57 | |||
58 | (% style="color:blue" %)**Temperature Sensor:** | ||
59 | |||
60 | * Range: -40 to + 80°C | ||
61 | * Accuracy: ±0.2 @ 0-90 °C | ||
62 | * Resolution: 0.1°C | ||
63 | * Long Term Shift: <0.03 °C/yr | ||
64 | |||
65 | (% style="color:blue" %)**Humidity Sensor: ** | ||
66 | |||
67 | * Range: 0 ~~ 99.9% RH | ||
68 | * Accuracy: ± 2%RH ( 0 ~~ 100%RH) | ||
69 | * Resolution: 0.01% RH | ||
70 | * Long Term Shift: <0.25 %RH/yr | ||
71 | |||
72 | (% style="color:blue" %)**NB-IoT Spec:** | ||
73 | |||
74 | (% style="color:#037691" %)**NB-IoT Module: BC660K-GL** | ||
75 | |||
76 | (% style="color:#037691" %)**Support Bands:** | ||
77 | |||
78 | * B1 @H-FDD: 2100MHz | ||
79 | * B2 @H-FDD: 1900MHz | ||
80 | * B3 @H-FDD: 1800MHz | ||
81 | * B4 @H-FDD: 2100MHz | ||
82 | * B5 @H-FDD: 860MHz | ||
83 | * B8 @H-FDD: 900MHz | ||
84 | * B12 @H-FDD: 720MHz | ||
85 | * B13 @H-FDD: 740MHz | ||
86 | * B17 @H-FDD: 730MHz | ||
87 | * B18 @H-FDD: 870MHz | ||
88 | * B19 @H-FDD: 870MHz | ||
89 | * B20 @H-FDD: 790MHz | ||
90 | * B25 @H-FDD: 1900MHz | ||
91 | * B28 @H-FDD: 750MHz | ||
92 | * B66 @H-FDD: 2000MHz | ||
93 | * B70 @H-FDD: 2000MHz | ||
94 | * B85 @H-FDD: 700MHz | ||
95 | |||
96 | (% style="color:blue" %)**Battery:** | ||
97 | |||
98 | * Li/SOCI2 un-chargeable battery | ||
99 | * Capacity: 8500mAh | ||
100 | * Self Discharge: <1% / Year @ 25°C | ||
101 | * Max continuously current: 130mA | ||
102 | * Max boost current: 2A, 1 second | ||
103 | |||
104 | (% style="color:blue" %)**Power Consumption** | ||
105 | |||
106 | * STOP Mode: 10uA @ 3.3v | ||
107 | * Max transmit power: 350mA@3.3v | ||
108 | |||
109 | |||
110 | == 1.4 Applications == | ||
111 | |||
112 | |||
113 | * Smart Buildings & Home Automation | ||
114 | * Logistics and Supply Chain Management | ||
115 | * Smart Metering | ||
116 | * Smart Agriculture | ||
117 | * Smart Cities | ||
118 | * Smart Factory | ||
119 | |||
120 | |||
121 | == 1.5 Sleep mode and working mode == | ||
122 | |||
123 | |||
124 | (% style="color:blue" %)**Deep Sleep Mode: **(%%)Sensor doesn't have any LoRaWAN activate. This mode is used for storage and shipping to save battery life. | ||
125 | |||
126 | (% style="color:blue" %)**Working Mode:** (%%)In this mode, Sensor will work as LoRaWAN Sensor to Join LoRaWAN network and send out sensor data to server. Between each sampling/tx/rx periodically, sensor will be in IDLE mode), in IDLE mode, sensor has the same power consumption as Deep Sleep mode. | ||
127 | |||
128 | |||
129 | == 1.6 Button & LEDs == | ||
130 | |||
131 | |||
132 | [[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675071855856-879.png]] | ||
133 | |||
134 | |||
135 | (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) | ||
136 | |=(% 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** | ||
137 | |(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:117px" %)Send an uplink|(% style="width:225px" %)((( | ||
138 | If sensor has already attached to NB-IoT network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once. | ||
139 | Meanwhile, BLE module will be active and user can connect via BLE to configure device. | ||
140 | ))) | ||
141 | |(% style="width:167px" %)Pressing ACT for more than 3s|(% style="width:117px" %)Active Device|(% style="width:225px" %)((( | ||
142 | (% 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. | ||
143 | (% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network. | ||
144 | 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. | ||
145 | ))) | ||
146 | |(% 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. | ||
147 | |||
148 | |||
149 | == 1.7 BLE connection == | ||
150 | |||
151 | |||
152 | S31x-NB support BLE remote configure and firmware update. | ||
153 | |||
154 | |||
155 | 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: | ||
156 | |||
157 | * Press button to send an uplink | ||
158 | * Press button to active device. | ||
159 | * Device Power on or reset. | ||
160 | |||
161 | If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode. | ||
162 | |||
163 | |||
164 | == 1.8 Pin Definitions & Switch == | ||
165 | |||
166 | |||
167 | S31x-NB use the mother board from S31-NB which as below. | ||
168 | |||
169 | [[image:image-20230819104805-5.png]] | ||
170 | |||
171 | |||
172 | === 1.8.1 Jumper JP2 === | ||
173 | |||
174 | |||
175 | Power on Device when put this jumper. | ||
176 | |||
177 | |||
178 | === 1.8.2 BOOT MODE / SW1 === | ||
179 | |||
180 | |||
181 | **1)** (% style="color:blue" %)**ISP**(%%): upgrade mode, device won't have any signal in this mode. but ready for upgrade firmware. LED won't work. Firmware won't run. | ||
182 | |||
183 | **2)** (% style="color:blue" %)**Flash**(%%): work mode, device starts to work and send out console output for further debug | ||
184 | |||
185 | |||
186 | === 1.8.3 Reset Button === | ||
187 | |||
188 | |||
189 | Press to reboot the device. | ||
190 | |||
191 | |||
192 | == 1.9 Hardware Variant == | ||
193 | |||
194 | |||
195 | (% border="1" cellspacing="5" style="width:410px" %) | ||
196 | |=(% style="width: 102px;background-color:#4F81BD;color:white" %)Model|=(% style="width: 126px; background-color:#4F81BD;color:white" %)Photo|=(% style="width: 179px;background-color:#4F81BD;color:white" %)Probe Info | ||
197 | |(% style="width:102px" %)((( | ||
198 | S31-NB | ||
199 | )))|(% style="width:126px" %)((( | ||
200 | (% style="text-align:center" %) | ||
201 | [[image:image-20230819110632-6.png||height="130" width="104"]] | ||
202 | )))|(% style="width:179px" %)((( | ||
203 | 1 x SHT31 Probe | ||
204 | |||
205 | Cable Length : 3 meters | ||
206 | |||
207 | |||
208 | ))) | ||
209 | |(% style="width:102px" %)((( | ||
210 | S31B-NB | ||
211 | )))|(% style="width:126px" %)((( | ||
212 | (% style="text-align:center" %) | ||
213 | [[image:image-20230819110702-7.png||height="164" width="90"]] | ||
214 | )))|(% style="width:179px" %)((( | ||
215 | 1 x SHT31 Probe | ||
216 | |||
217 | Installed in device. | ||
218 | ))) | ||
219 | |||
220 | (% style="display:none" %) | ||
221 | |||
222 | |||
223 | |||
224 | = 2. Use S31-NB to communicate with IoT Server = | ||
225 | |||
226 | == 2.1 Send data to IoT server via NB-IoT network == | ||
227 | |||
228 | |||
229 | The S31-NB is equipped with a NB-IoT module, the pre-loaded firmware in S31-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 S31-NB. | ||
230 | |||
231 | |||
232 | Below shows the network structure: | ||
233 | |||
234 | [[image:1692415924540-357.png]] | ||
235 | |||
236 | |||
237 | There are two version: (% style="color:blue" %)**-GE**(%%) and (% style="color:blue" %)**-1D**(%%) version of S31-NB. | ||
238 | |||
239 | |||
240 | (% 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 S31-NB send data to IoT server. | ||
241 | |||
242 | * 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]]. | ||
243 | |||
244 | * 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]]. | ||
245 | |||
246 | Below shows result of different server as a glance. | ||
247 | |||
248 | (% border="1" cellspacing="4" style="width:515px" %) | ||
249 | |(% 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** | ||
250 | |(% 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" %)((( | ||
251 | (% style="text-align:center" %) | ||
252 | [[image:image-20230819113244-8.png||height="183" width="367"]] | ||
253 | )))|(% style="width:170px" %) | ||
254 | |(% 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" %)((( | ||
255 | (% style="text-align:center" %) | ||
256 | [[image:image-20230819113244-9.png||height="119" width="367"]] | ||
257 | )))|(% style="width:170px" %) | ||
258 | |(% 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" %) | ||
259 | |(% 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" %) | ||
260 | |(% 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" %) | ||
261 | |(% 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" %)((( | ||
262 | (% style="text-align:center" %) | ||
263 | [[image:image-20230819113244-10.png||height="104" width="367"]] | ||
264 | )))|(% style="width:170px" %) | ||
265 | |(% 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" %)((( | ||
266 | (% style="text-align:center" %) | ||
267 | [[image:image-20230819113244-11.png||height="141" width="367"]] | ||
268 | )))|(% style="width:170px" %) | ||
269 | |||
270 | (% 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 S31-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]]. | ||
271 | |||
272 | |||
273 | == 2.2 Payload Types == | ||
274 | |||
275 | |||
276 | To meet different server requirement, S31-NB supports different payload type. | ||
277 | |||
278 | **Includes:** | ||
279 | |||
280 | * [[General JSON format payload>>||anchor="H2.2.1GeneralJsonFormat28Type3D529"]]. (Type=5) | ||
281 | |||
282 | * [[HEX format Payload>>||anchor="H2.2.2HEXformatPayload28Type3D029"]]. (Type=0) | ||
283 | |||
284 | * [[ThingSpeak Format>>||anchor="H2.2.4ThingSpeakPayload28Type3D129"]]. (Type=1) | ||
285 | |||
286 | * [[ThingsBoard Format>>||anchor="H2.2.3ThingsBoardPayload28Type3D329"]]. (Type=3) | ||
287 | |||
288 | User can specify the payload type when choose the connection protocol. Example: | ||
289 | |||
290 | (% style="color:#037691" %)**AT+PRO=2,0** (%%) ~/~/ Use UDP Connection & hex Payload | ||
291 | |||
292 | (% style="color:#037691" %)**AT+PRO=2,5** (%%) ~/~/ Use UDP Connection & Json Payload | ||
293 | |||
294 | (% style="color:#037691" %)**AT+PRO=3,5 ** (%%) ~/~/ Use MQTT Connection & Json Payload | ||
295 | |||
296 | |||
297 | === 2.2.1 General Json Format(Type~=5) === | ||
298 | |||
299 | |||
300 | This is the General Json Format. As below: | ||
301 | |||
302 | (% style="color:#4472c4" %)**{"IMEI":866207053462762,"temperature":29.2,"humidity":54.2,"battery":3.27,"signal":24,"Model":S31x-NB, "1":{28.2,48.3,2023/08/10 08:00:37},"2":{28.1,49.1,2023/08/10 07:57:37},"3":{28.1,48.5,2023/08/10 07:54:37},"4":{28.2,48.6,2023/08/10 07:51:37},"5":{28.1,48.9,2023/08/10 07:48:37},"6":{28.2,48.8,2023/08/10 07:45:37},"7":{28.2,48.8,2023/08/10 07:42:37},"8":{28.0,48.8,2023/08/10 07:39:37}}** | ||
303 | |||
304 | |||
305 | (% style="color:red" %)**Notice, from above payload:** | ||
306 | |||
307 | * Temperature , Humidity , Battery & Signal are the value at uplink time. | ||
308 | |||
309 | * 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): Temperature, Humidity, Sampling time. | ||
310 | |||
311 | |||
312 | === 2.2.2 HEX format Payload(Type~=0) === | ||
313 | |||
314 | |||
315 | This is the HEX Format. As below: | ||
316 | |||
317 | (% style="color:#4472c4" %)**f86620705346276200640cba16010000000011011801e864d49c2d011a01e364d49925011901eb64d49871011901e564d497bd011a01e664d49709011901e964d49655011a01e864d495a1011a01e864d494ed011801e864d49439** | ||
318 | |||
319 | [[image:1692424009971-458.png]] | ||
320 | |||
321 | |||
322 | (% style="color:blue" %)**Version:** | ||
323 | |||
324 | These bytes include the hardware and software version. | ||
325 | |||
326 | (% style="color:#037691" %)**Higher byte:**(%%) Specify Sensor Model: 0x00 for S31B-NB & S31-NB | ||
327 | |||
328 | (% style="color:#037691" %)**Lower byte:**(%%) Specify the software version: 0x64=100, means firmware version 100 | ||
329 | |||
330 | |||
331 | (% style="color:blue" %)**BAT (Battery Info):** | ||
332 | |||
333 | Ex1: 0x0CBA = 3258mV | ||
334 | |||
335 | |||
336 | (% style="color:blue" %)**Signal Strength:** | ||
337 | |||
338 | NB-IoT Network signal Strength. | ||
339 | |||
340 | **Ex1: 0x16 = 22** | ||
341 | |||
342 | **0** -113dBm or less | ||
343 | |||
344 | **1** -111dBm | ||
345 | |||
346 | **2...30** -109dBm... -53dBm | ||
347 | |||
348 | **31** -51dBm or greater | ||
349 | |||
350 | **99** Not known or not detectable | ||
351 | |||
352 | |||
353 | (% style="color:blue" %)**Temperature: ** | ||
354 | |||
355 | If payload is: 0105H: (0105 & 8000 == 0), temp = 0105H /10 = 26.1 degree | ||
356 | |||
357 | If payload is: FF3FH : (FF3F & 8000 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees. | ||
358 | |||
359 | (FF3F & 8000: Judge whether the highest bit is 1, when the highest bit is 1, it is negative) | ||
360 | |||
361 | |||
362 | (% style="color:blue" %)**Humidity: ** | ||
363 | |||
364 | Read:0295(H)=661(D) Value: 661 / 10=66.1, So 66.1% | ||
365 | |||
366 | |||
367 | (% style="color:blue" %)**TimeStamp: ** | ||
368 | |||
369 | Unit TimeStamp Example: 64d49439(H) = 1691653177(D) | ||
370 | |||
371 | Put the decimal value into this link(https:~/~/www.epochconverter.com/) to get the time. | ||
372 | |||
373 | |||
374 | === 2.2.3 ThingsBoard Payload(Type~=3) === | ||
375 | |||
376 | |||
377 | Type3 payload special design for ThingsBoard, it will also configure other default server to ThingsBoard. | ||
378 | |||
379 | (% style="color:#4472c4" %)**{"IMEI":866207053462762,"temperature":29.2,"humidity":54.2,"battery":3.27,"signal":24}** | ||
380 | |||
381 | |||
382 | === 2.2.4 ThingSpeak Payload(Type~=1) === | ||
383 | |||
384 | |||
385 | This payload meets ThingSpeak platform requirement. It includes only four fields. Form 1~~4 are: | ||
386 | |||
387 | Temperature, Humidity, Battery & Signal. This payload type only valid for ThingsSpeak Platform | ||
388 | |||
389 | As below: | ||
390 | |||
391 | (% style="color:#4472c4" %)**field1=27.9&field2=49.9&field3=3.23&field4=28** | ||
392 | |||
393 | |||
394 | == 2.3 Test Uplink and Change Update Interval == | ||
395 | |||
396 | |||
397 | By default, Sensor will send uplinks (% style="color:blue" %)**every 2 hours**(%%) & AT+NOUD=8 | ||
398 | |||
399 | User can use below commands to change the (% style="color:blue" %)**uplink interval**. | ||
400 | |||
401 | (% style="color:#037691" %)**AT+TDC=600 ** (%%) ~/~/ Set Update Interval to 600s | ||
402 | |||
403 | User can also push the button for more than 1 seconds to activate an uplink. | ||
404 | |||
405 | |||
406 | == 2.4 Multi-Samplings and One uplink == | ||
407 | |||
408 | |||
409 | To save battery life, S31-NB will sample temperature & humidity 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: | ||
410 | |||
411 | * (% 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) | ||
412 | |||
413 | * (% 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. | ||
414 | |||
415 | The diagram below explains the relationship between TR, NOUD, and TDC more clearly: | ||
416 | |||
417 | [[image:1692424376354-959.png]] | ||
418 | |||
419 | |||
420 | == 2.5 Humidity and Temperature alarm function == | ||
421 | |||
422 | |||
423 | On each sampling define by AT+TR ( default 900s or 15 minutes), when the value exceed the range, it will trigger an Alarm and immediately sends a uplink. | ||
424 | |||
425 | |||
426 | (% style="color:blue" %)**AT Commands:** | ||
427 | |||
428 | (% style="color:#037691" %)**AT+ SHHUM=min,max** | ||
429 | |||
430 | Example: AT+ SHHUM=50,80 ~/~/ Alarm when humidity lower than 50 or higher than 80. | ||
431 | |||
432 | |||
433 | (% style="color:#037691" %)**AT+ SHTEMP=min,max** | ||
434 | |||
435 | Example: AT+ SHTEMP=20,30 ~/~/ Alarm when temperature lower than 20 or higher than 30 | ||
436 | |||
437 | |||
438 | (% style="color:red" %)**Notice:** | ||
439 | |||
440 | * To disable Alarm, user can set min and max to same value , such as (% style="color:#037691" %)**AT+SHTEMP=0,0.** | ||
441 | |||
442 | * If user only want to send only min or max, user can set the alarm to a value that device won’t reach. For example: (% style="color:#037691" %)**AT+SHTEMP=-80,0.** | ||
443 | |||
444 | |||
445 | == 2.6 Trggier an uplink by external interrupt == | ||
446 | |||
447 | |||
448 | S31-NB has an external trigger interrupt function. Users can use the PB15 pin to trigger the upload of data packets. | ||
449 | |||
450 | (% style="color:blue" %)**AT command:** | ||
451 | |||
452 | * (% style="color:#037691" %)**AT+INTMOD **(%%) ~/~/ Set the trigger interrupt mode | ||
453 | |||
454 | * (% style="color:#037691" %)**AT+INTMOD=0 **(%%) ~/~/ Disable Interrupt | ||
455 | |||
456 | * (% style="color:#037691" %)**AT+INTMOD=1 **(%%) ~/~/ Trigger by rising and falling edge | ||
457 | |||
458 | * (% style="color:#037691" %)**AT+INTMOD=2 **(%%) ~/~/ Trigger by falling edge | ||
459 | |||
460 | * (% style="color:#037691" %)**AT+INTMOD=3 **(%%) ~/~/ Trigger by rising edge | ||
461 | |||
462 | |||
463 | = 3. Configure S31x-NB = | ||
464 | |||
465 | == 3.1 Configure Methods == | ||
466 | |||
467 | |||
468 | S31x-NB supports below configure method: | ||
469 | |||
470 | * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]]. | ||
471 | |||
472 | * 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]]. | ||
473 | |||
474 | |||
475 | == 3.2 AT Commands Set == | ||
476 | |||
477 | |||
478 | AT+<CMD>? : Help on <CMD> | ||
479 | |||
480 | AT+<CMD> : Run <CMD> | ||
481 | |||
482 | AT+<CMD>=<value> : Set the value | ||
483 | |||
484 | AT+<CMD>=? : Get the value | ||
485 | |||
486 | |||
487 | (% style="color:blue" %)**General Commands** | ||
488 | |||
489 | AT : Attention | ||
490 | |||
491 | AT? : Short Help | ||
492 | |||
493 | ATZ : MCU Reset | ||
494 | |||
495 | AT+TDC : Application Data Transmission Interval | ||
496 | |||
497 | AT+CFG : Print all configurations | ||
498 | |||
499 | AT+CFGMOD : Working mode selection | ||
500 | |||
501 | AT+DEUI : Get or set the Device ID | ||
502 | |||
503 | AT+INTMOD : Set the trigger interrupt mode | ||
504 | |||
505 | AT+5VT : Set extend the time of 5V power | ||
506 | |||
507 | AT+PRO : Choose agreement | ||
508 | |||
509 | AT+RXDL : Extend the sending and receiving time | ||
510 | |||
511 | AT+DNSCFG : Get or Set DNS Server | ||
512 | |||
513 | AT+GETSENSORVALUE : Returns the current sensor measurement | ||
514 | |||
515 | AT+NOUD : Get or Set the number of data to be uploaded | ||
516 | |||
517 | AT+CDP : Read or Clear cached data | ||
518 | |||
519 | AT+SHTEMP: Get or Set alarm of temp | ||
520 | |||
521 | AT+SHHUM: Get or Set alarm of moisture | ||
522 | |||
523 | AT+SERVADDR : Server Address | ||
524 | |||
525 | |||
526 | (% style="color:blue" %)**UDP Management** | ||
527 | |||
528 | AT+CFM : Upload confirmation mode (only valid for UDP) | ||
529 | |||
530 | |||
531 | (% style="color:blue" %)**MQTT Management** | ||
532 | |||
533 | AT+CLIENT : Get or Set MQTT client | ||
534 | |||
535 | AT+UNAME : Get or Set MQTT Username | ||
536 | |||
537 | AT+PWD : Get or Set MQTT password | ||
538 | |||
539 | AT+PUBTOPIC : Get or Set MQTT publish topic | ||
540 | |||
541 | AT+SUBTOPIC : Get or Set MQTT subscription topic | ||
542 | |||
543 | |||
544 | (% style="color:blue" %)**Information** | ||
545 | |||
546 | AT+FDR : Factory Data Reset | ||
547 | |||
548 | AT+PWORD : Serial Access Password | ||
549 | |||
550 | AT+LDATA : Get the last upload data | ||
551 | |||
552 | AT+CDP : Read or Clear cached data | ||
553 | |||
554 | |||
555 | = 4. Battery & Power Consumption = | ||
556 | |||
557 | |||
558 | S31x-NB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace. | ||
559 | |||
560 | [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] . | ||
561 | |||
562 | |||
563 | = 5. Firmware update = | ||
564 | |||
565 | |||
566 | User can change device firmware to:: | ||
567 | |||
568 | * Update with new features. | ||
569 | |||
570 | * Fix bugs. | ||
571 | |||
572 | Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/fhb3uyl4gt6clru/AAAiZVTFcxrfE1JOOyfcgO9ha?dl=0]]** | ||
573 | |||
574 | Methods to Update Firmware: | ||
575 | |||
576 | * (Recommended way) OTA firmware update via BLE: [[**Instruction**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/BLE_Firmware_Update_NB_Sensors_BC660K-GL/]]. | ||
577 | |||
578 | * Update through UART TTL interface : **[[Instruction>>url:http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H1.LoRaSTv4baseHardware]]**. | ||
579 | |||
580 | |||
581 | = 6. FAQ = | ||
582 | |||
583 | == 6.1 How can I access t BC660K-GL AT Commands? == | ||
584 | |||
585 | |||
586 | User can access to BC660K-GL directly and send AT Commands. | ||
587 | |||
588 | [[See BC660K-GL AT Command set>>url:https://www.dropbox.com/sh/5f6ssda5fum8rvs/AABT68l8ZzWOvZ5eg2qwOoFda?dl=0]] | ||
589 | |||
590 | |||
591 | = 7. Order Info = | ||
592 | |||
593 | |||
594 | Part Number: (% style="color:blue" %)**S31-NB-XX / S31B-NB-XX** | ||
595 | |||
596 | (% style="color:red" %)**XX**(%%): | ||
597 | |||
598 | * (% style="color:#037691" %)**GE**(%%): General version ( Exclude SIM card) | ||
599 | |||
600 | * (% style="color:#037691" %)**1D**(%%): with 1NCE* 10 years 500MB SIM card and Pre-configure to DataCake server | ||
601 | |||
602 | (% 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 | ||
603 | |||
604 | |||
605 | = 8. Packing Info = | ||
606 | |||
607 | |||
608 | (% style="color:#037691" %)**Package Includes**: | ||
609 | |||
610 | * S31-NB or S31-NB NB-IoT Sensor Node x 1 | ||
611 | |||
612 | * External antenna x 1 | ||
613 | |||
614 | (% style="color:#037691" %)**Dimension and weight**: | ||
615 | |||
616 | * Device Size: 13.0 x 5 x 4.5 cm | ||
617 | |||
618 | * Device Weight: 150g | ||
619 | |||
620 | * Package Size / pcs : 14.0 x 8x 5 cm | ||
621 | |||
622 | * Weight / pcs : 180g | ||
623 | |||
624 | |||
625 | = 9. Support = | ||
626 | |||
627 | |||
628 | * 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. | ||
629 | |||
630 | * 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]]. | ||
631 | |||
632 | (% style="display:none" %) (%%) |