Changes for page wiki_test

Last modified by Mengting Qiu on 2024/09/05 17:35

From version 82.24
edited by Xiaoling
on 2023/08/19 14:54
Change comment: There is no comment for this version
To version 80.2
edited by Xiaoling
on 2023/08/19 11:33
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -3,7 +3,7 @@
3 3  
4 4  
5 5  
6 -**Table of Contents:**
6 +**Table of Contents**
7 7  
8 8  {{toc/}}
9 9  
... ... @@ -21,7 +21,7 @@
21 21  
22 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 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.
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 25  
26 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 27  
... ... @@ -115,6 +115,8 @@
115 115  * Smart Cities
116 116  * Smart Factory
117 117  
118 +
119 +
118 118  == 1.5 Sleep mode and working mode ==
119 119  
120 120  
... ... @@ -131,7 +131,7 @@
131 131  
132 132  
133 133  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
134 -|=(% 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**
136 +|=(% style="width: 167px;background-color:#D9E2F3;color:#0070C0" %)**Behavior on ACT**|=(% style="width: 117px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 225px;background-color:#D9E2F3;color:#0070C0" %)**Action**
135 135  |(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:117px" %)Send an uplink|(% style="width:225px" %)(((
136 136  If sensor has already attached to NB-IoT network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once.
137 137  Meanwhile, BLE module will be active and user can connect via BLE to configure device.
... ... @@ -166,6 +166,7 @@
166 166  [[image:image-20230819104805-5.png]]
167 167  
168 168  
171 +
169 169  === 1.8.1 Jumper JP2 ===
170 170  
171 171  
... ... @@ -186,13 +186,14 @@
186 186  Press to reboot the device.
187 187  
188 188  
192 +
189 189  == 1.9 Hardware Variant ==
190 190  
191 191  
192 192  (% border="1" cellspacing="5" style="width:410px" %)
193 -|=(% 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;background-color:#D9E2F3;color:#0070C0" %)Model|=(% style="width: 126px; background-color: rgb(217, 226, 243); color: rgb(0, 112, 192);" %)Photo|=(% style="width: 179px; background-color: rgb(217, 226, 243); color: rgb(0, 112, 192);" %)Probe Info
194 194  |(% style="width:102px" %)(((
195 -S31-NB
199 +S31-LB
196 196  )))|(% style="width:126px" %)(((
197 197  (% style="text-align:center" %)
198 198  [[image:image-20230819110632-6.png||height="130" width="104"]]
... ... @@ -204,7 +204,7 @@
204 204  
205 205  )))
206 206  |(% style="width:102px" %)(((
207 -S31B-NB
211 +S31B-LB
208 208  )))|(% style="width:126px" %)(((
209 209  (% style="text-align:center" %)
210 210  [[image:image-20230819110702-7.png||height="164" width="90"]]
... ... @@ -232,391 +232,678 @@
232 232  [[image:1692415924540-357.png]]
233 233  
234 234  
235 -There are two version: (% style="color:blue" %)**-GE**(%%) and (% style="color:blue" %)**-1D**(%%) version of S31-NB.
239 +There are two version: **-GE** and **-1D** version of S31-NB.
236 236  
237 237  
238 -(% style="color:blue" %)**GE Version**(%%): This version doesn't include SIM card or point to any IoT server. User needs to use AT Commands to configure below two steps to set S31-NB send data to IoT server.
242 +**GE Version**: This version doesnt 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.
239 239  
240 -* Install NB-IoT SIM card and configure APN. See instruction of [[Attach Network>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H2.AttachNetwork]].
244 +1. 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]].
245 +1. 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 241  
242 -* Set up sensor to point to IoT Server. See instruction of [[Configure to Connect Different Servers>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.Configuretoconnecttodifferentservers]]. 
243 -
244 244  Below shows result of different server as a glance.
245 245  
246 -(% border="1" cellspacing="4" style="width:515px" %)
247 -|(% style="background-color:#4f81bd; color:white; width:100px" %)**Servers**|(% style="background-color:#4f81bd; color:white; width:300px" %)**Dash Board**|(% style="background-color:#4f81bd; color:white; width:115px" %)**Comments**
248 -|(% style="width:127px" %)[[Node-Red>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.5A0Node-RedA028viaA0MQTT29]]|(% style="width:385px" %)(((
249 -(% style="text-align:center" %)
250 -[[image:image-20230819113244-8.png||height="183" width="367"]]
251 -)))|(% style="width:170px" %)
252 -|(% style="width:127px" %)[[DataCake>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.4Datacake]]|(% style="width:385px" %)(((
253 -(% style="text-align:center" %)
254 -[[image:image-20230819113244-9.png||height="120" width="369"]]
255 -)))|(% style="width:170px" %)
256 -|(% style="width:127px" %)[[Tago.IO>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.7A0Tago.ioA028viaA0MQTT29]]|(% style="width:385px" %) |(% style="width:170px" %)
257 -|(% style="width:127px" %)[[General UDP>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.1GeneralA0UDPA0Connection]]|(% style="width:385px" %)Raw Payload. Need Developer to design Dash Board|(% style="width:170px" %)
258 -|(% style="width:127px" %)[[General MQTT>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.2GeneralA0MQTTA0Connection]]|(% style="width:385px" %)Raw Payload. Need Developer to design Dash Board|(% style="width:170px" %)
259 -|(% style="width:127px" %)[[ThingSpeak>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.3A0ThingSpeakA028viaA0MQTT29]]|(% style="width:385px" %)(((
260 -(% style="text-align:center" %)
261 -[[image:image-20230819113244-10.png||height="82" width="291"]]
262 -)))|(% style="width:170px" %)
263 -|(% style="width:127px" %)[[ThingsBoard>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.6A0ThingsBoard.CloudA028viaA0MQTT29]]|(% style="width:385px" %)(((
264 -(% style="text-align:center" %)
265 -[[image:image-20230819113244-11.png||height="113" width="293"]]
266 -)))|(% style="width:170px" %)
267 267  
268 -(% style="color:blue" %)**1D Version**(%%): This version has 1NCE SIM card pre-installed and configure to send value to DataCake. User Just need to select the sensor type in DataCake and Activate 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]].
250 +|**Servers**|**Dash Board**|**Comments**
251 +|[[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]]|[[image:image-20230819113244-8.png]]|
252 +|[[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]]|[[image:image-20230819113244-9.png]]|
253 +|[[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]]| |
254 +|[[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]]|Raw Payload. Need Developer to design Dash Board|
255 +|[[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]]|Raw Payload. Need Developer to design Dash Board|
256 +|[[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]]|[[image:image-20230819113244-10.png]]|
257 +|[[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]]|[[image:image-20230819113244-11.png]]|
258 +| | |
269 269  
270 270  
261 +
262 +**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]].
263 +
264 +
271 271  == 2.2 ​Payload Types ==
272 272  
273 273  
274 -To meet different server requirement, S31-NB supports different payload type.
268 +Following is an example for how to join the [[TTN v3 LoRaWAN Network>>url:https://console.cloud.thethings.network/]]. Below is the network structure; we use the [[LPS8v2>>url:https://www.dragino.com/products/lora-lorawan-gateway/item/228-lps8v2.html]] as a LoRaWAN gateway in this example.
275 275  
276 -**Includes:**
270 +The LPS8V2 is already set to connected to [[TTN network >>url:https://console.cloud.thethings.network/]], so what we need to now is configure the TTN server.
277 277  
278 -* [[General JSON format payload>>||anchor="H2.2.1GeneralJsonFormat28Type3D529"]]. (Type=5)
279 279  
280 -* [[HEX format Payload>>||anchor="H2.2.2HEXformatPayload28Type3D029"]]. (Type=0)
273 +(% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from S31x-LB.
281 281  
282 -* [[ThingSpeak Format>>||anchor="H2.2.4ThingSpeakPayload28Type3D129"]]. (Type=1)
275 +Each S31x-LB is shipped with a sticker with the default device EUI as below:
283 283  
284 -* [[ThingsBoard Format>>||anchor="H2.2.3ThingsBoardPayload28Type3D329"]]. (Type=3)
277 +[[image:image-20230426084152-1.png||alt="图片-20230426084152-1.png" height="233" width="502"]]
285 285  
286 -User can specify the payload type when choose the connection protocol. Example:
287 287  
288 -(% style="color:#037691" %)**AT+PRO=2,0**  (%%) ~/~/ Use UDP Connection & hex Payload
280 +You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
289 289  
290 -(% style="color:#037691" %)**AT+PRO=2,5**   (%%) ~/~/ Use UDP Connection & Json Payload
291 291  
292 -(% style="color:#037691" %)**AT+PRO=3,5 ** (%%) ~/~/ Use MQTT Connection & Json Payload
283 +(% style="color:blue" %)**Register the device**
293 293  
285 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50v2-S31-S31B%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20User%20Manual/WebHome/1654935135620-998.png?rev=1.1||alt="1654935135620-998.png"]]
294 294  
295 -=== 2.2.1 General Json Format(Type~=5) ===
296 296  
288 +(% style="color:blue" %)**Add APP EUI and DEV EUI**
297 297  
298 -This is the General Json Format. As below:
290 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50v2-S31-S31B%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20User%20Manual/WebHome/image-20220611161308-4.png?width=753&height=551&rev=1.1||alt="图片-20220611161308-4.png"]]
299 299  
300 -(% 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}}**
301 301  
293 +(% style="color:blue" %)**Add APP EUI in the application**
302 302  
303 -(% style="color:red" %)**Notice, from above payload:**
304 304  
305 -* Temperature , Humidity , Battery & Signal are the value at uplink time.
296 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50v2-S31-S31B%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20User%20Manual/WebHome/image-20220611161308-5.png?width=742&height=601&rev=1.1||alt="图片-20220611161308-5.png"]]
306 306  
307 -* 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.
308 308  
309 -=== 2.2.2 HEX format Payload(Type~=0) ===
299 +(% style="color:blue" %)**Add APP KEY**
310 310  
301 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50v2-S31-S31B%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20User%20Manual/WebHome/image-20220611161308-6.png?width=744&height=485&rev=1.1||alt="图片-20220611161308-6.png"]]
311 311  
312 -This is the HEX Format. As below:
313 313  
314 -(% style="color:#4472c4" %)**f86620705346276200640cba16010000000011011801e864d49c2d011a01e364d49925011901eb64d49871011901e564d497bd011a01e664d49709011901e964d49655011a01e864d495a1011a01e864d494ed011801e864d49439**
304 +(% style="color:blue" %)**Step 2:**(%%) Activate on S31x-LB
315 315  
316 -[[image:1692424009971-458.png]]
317 317  
307 +Press the button for 5 seconds to activate the S31x-LB.
318 318  
319 -(% style="color:blue" %)**Version:**
309 +(% style="color:green" %)**Green led**(%%) will fast blink 5 times, device will enter (% style="color:blue" %)**OTA mode**(%%) for 3 seconds. And then start to JOIN LoRaWAN network. (% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network.
320 320  
321 -These bytes include the hardware and software version.
311 +After join success, it will start to upload messages to TTN and you can see the messages in the panel.
322 322  
323 -(% style="color:#037691" %)**Higher byte:**(%%) Specify Sensor Model: 0x00 for S31B-NB & S31-NB
324 324  
325 -(% style="color:#037691" %)**Lower byte:**(%%) Specify the software version: 0x64=100, means firmware version 100
314 +== 2.3 ​Uplink Payload ==
326 326  
316 +=== 2.3.1 Device Status, FPORT~=5 ===
327 327  
328 -(% style="color:blue" %)**BAT (Battery Info):**
329 329  
330 -Ex1: 0x0CBA = 3258mV
319 +Users can use the downlink command(**0x26 01**) to ask S31x-LB to send device configure detail, include device configure status. S31x-LB will uplink a payload via FPort=5 to server.
331 331  
321 +The Payload format is as below.
332 332  
333 -(% style="color:blue" %)**Signal Strength:**
334 334  
335 -NB-IoT Network signal Strength.
324 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
325 +|(% colspan="6" style="background-color:#d9e2f3; color:#0070c0" %)**Device Status (FPORT=5)**
326 +|(% style="width:103px" %)**Size (bytes)**|(% style="width:72px" %)**1**|**2**|(% style="width:91px" %)**1**|(% style="width:86px" %)**1**|(% style="width:44px" %)**2**
327 +|(% style="width:103px" %)**Value**|(% style="width:72px" %)Sensor Model|Firmware Version|(% style="width:91px" %)Frequency Band|(% style="width:86px" %)Sub-band|(% style="width:44px" %)BAT
336 336  
337 -**Ex1: 0x16 = 22**
329 +Example parse in TTNv3
338 338  
339 -**0**  -113dBm or less
331 +[[image:image-20230524144422-1.png||height="174" width="1080"]]
340 340  
341 -**1**  -111dBm
342 342  
343 -**2...30** -109dBm... -53dBm
334 +(% style="color:#037691" %)**Sensor Model**(%%): For S31x-LB, this value is 0x0A
344 344  
345 -**31**   -51dBm or greater
336 +(% style="color:#037691" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version
346 346  
347 -**99**    Not known or not detectable
338 +(% style="color:#037691" %)**Frequency Band**:
348 348  
340 +0x01: EU868
349 349  
350 -(% style="color:blue" %)**Temperature: **
342 +0x02: US915
351 351  
344 +0x03: IN865
345 +
346 +0x04: AU915
347 +
348 +0x05: KZ865
349 +
350 +0x06: RU864
351 +
352 +0x07: AS923
353 +
354 +0x08: AS923-1
355 +
356 +0x09: AS923-2
357 +
358 +0x0a: AS923-3
359 +
360 +0x0b: CN470
361 +
362 +0x0c: EU433
363 +
364 +0x0d: KR920
365 +
366 +0x0e: MA869
367 +
368 +
369 +(% style="color:#037691" %)**Sub-Band**:
370 +
371 +AU915 and US915:value 0x00 ~~ 0x08
372 +
373 +CN470: value 0x0B ~~ 0x0C
374 +
375 +Other Bands: Always 0x00
376 +
377 +
378 +(% style="color:#037691" %)**Battery Info**:
379 +
380 +Check the battery voltage.
381 +
382 +Ex1: 0x0B45 = 2885mV
383 +
384 +Ex2: 0x0B49 = 2889mV
385 +
386 +
387 +=== 2.3.2  Sensor Data. FPORT~=2 ===
388 +
389 +
390 +Sensor Data is uplink via FPORT=2
391 +
392 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:500px" %)
393 +|=(% style="width: 60px;background-color:#D9E2F3;color:#0070C0" %)(((
394 +**Size(bytes)**
395 +)))|=(% style="width: 40px;background-color:#D9E2F3;color:#0070C0" %)2|=(% style="width: 90px;background-color:#D9E2F3;color:#0070C0" %)4|=(% style="width: 150px; background-color: #D9E2F3;color:#0070C0" %)1|=(% style="width: 80px; background-color: #D9E2F3;color:#0070C0" %)**2**|=(% style="width: 80px; background-color: #D9E2F3;color:#0070C0" %)2
396 +|(% style="width:99px" %)Value|(% style="width:69px" %)(((
397 +Battery
398 +)))|(% style="width:130px" %)(((
399 +Unix TimeStamp
400 +)))|(% style="width:194px" %)(((
401 +Alarm Flag & MOD& Level of PA8
402 +)))|(% style="width:106px" %)(((
403 +Temperature
404 +)))|(% style="width:97px" %)(((
405 +Humidity
406 +)))
407 +
408 +[[image:image-20230524144456-2.png||height="180" width="1142"]]
409 +
410 +
411 +==== (% style="color:#4472c4" %)**Battery**(%%) ====
412 +
413 +Sensor Battery Level.
414 +
415 +Ex1: 0x0B45 = 2885mV
416 +
417 +Ex2: 0x0B49 = 2889mV
418 +
419 +
420 +==== (% style="color:#4472c4" %)**Temperature**(%%) ====
421 +
422 +**Example**:
423 +
352 352  If payload is: 0105H:  (0105 & 8000 == 0), temp = 0105H /10 = 26.1 degree
353 353  
354 354  If payload is: FF3FH :  (FF3F & 8000 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
355 355  
356 -(FF3F & 8000:Judge whether the highest bit is 1, when the highest bit is 1, it is negative)
428 +FF3F & 8000:Judge whether the highest bit is 1, when the highest bit is 1, it is negative
357 357  
358 358  
359 -(% style="color:blue" %)**Humidity:   **
431 +==== (% style="color:#4472c4" %)**Humidity**(%%) ====
360 360  
361 -Read:0295(H)=661(D)    Value:  661 / 10=66.1, So 66.1%
362 362  
434 +Read:0x(0197)=412    Value:  412 / 10=41.2, So 41.2%
363 363  
364 -(% style="color:blue" %)**TimeStamp:   **
365 365  
366 -Unit TimeStamp Example: 64d49439(H) = 1691653177(D)
437 +==== (% style="color:#4472c4" %)**Alarm Flag & MOD & Level of PA8**(%%) ====
367 367  
368 -Put the decimal value into this link(https:~/~/www.epochconverter.com/) to get the time.
369 369  
440 +**Example:**
370 370  
371 -=== 2.2.3 ThingsBoard Payload(Type~=3) ===
442 +If payload & 0x01 = 0x01  **~-~->** This is an Alarm Message.It means that the temperature and humidity exceed the alarm value or trigger an interrupt.
372 372  
444 +If payload & 0x01 = 0x00  **~-~->** This is a normal uplink message, no alarm.
373 373  
374 -Type3 payload special design for ThingsBoard, it will also configure other default server to ThingsBoard.
446 +If payload & 0x80>>7 = 0x01  **~-~->** The PA8 is low level.
375 375  
376 -(% style="color:#4472c4" %)**{"IMEI":866207053462762,"temperature":29.2,"humidity":54.2,"battery":3.27,"signal":24}**
448 +If payload & 0x80>>7 =0x00  **~-~->** The PA8 is high level.
377 377  
450 +If payload >> 2 = 0x00  **~-~->**  means MOD=1, This is a sampling uplink message.
378 378  
379 -=== 2.2.4 ThingSpeak Payload(Type~=1) ===
452 +If payload >> 2 = 0x31  **~-~->**  means MOD=31, this message is a reply message for polling, this message contains the alarm settings. see [[this link>>path:#HPolltheAlarmsettings:]] for detail. 
380 380  
381 381  
382 -This payload meets ThingSpeak platform requirement. It includes only four fields. Form 1~~4 are:
455 +== 2.4 Payload Decoder file ==
383 383  
384 -Temperature, Humidity, Battery & Signal. This payload type only valid for ThingsSpeak Platform
385 385  
386 -As below:
458 +In TTN, use can add a custom payload so it shows friendly reading
387 387  
388 -(% style="color:#4472c4" %)**field1=27.9&field2=49.9&field3=3.23&field4=28**
460 +In the page (% style="color:#037691" %)**Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder**(%%) to add the decoder from:
389 389  
462 +[[https:~~/~~/github.com/dragino/dragino-end-node-decoder/tree/main/S31-LB%26S31B-LB>>https://github.com/dragino/dragino-end-node-decoder/tree/main/S31-LB%26S31B-LB]]
390 390  
391 -== 2.3 Test Uplink and Change Update Interval ==
392 392  
465 +== 2.5 Datalog Feature ==
393 393  
394 -By default, Sensor will send uplinks (% style="color:blue" %)**every 2 hours**(%%) & AT+NOUD=8
395 395  
396 -User can use below commands to change the (% style="color:blue" %)**uplink interval**.
468 +Datalog Feature is to ensure IoT Server can get all sampling data from Sensor even if the LoRaWAN network is down. For each sampling, S31x-LB will store the reading for future retrieving purposes.
397 397  
398 -(% style="color:#037691" %)**AT+TDC=600 ** (%%) ~/~/ Set Update Interval to 600s
399 399  
400 -User can also push the button for more than 1 seconds to activate an uplink.
471 +=== 2.5.1 Ways to get datalog via LoRaWAN ===
401 401  
402 402  
403 -== 2.4 Multi-Samplings and One uplink ==
474 +Set [[PNACKMD=1>>||anchor="H2.5.4DatalogUplinkpayload28FPORT3D329"]], S31x-LB will wait for ACK for every uplink, when there is no LoRaWAN network,S31x-LB will mark these records with non-ack messages and store the sensor data, and it will send all messages (10s interval) after the network recovery.
404 404  
476 +* (((
477 +a) S31x-LB will do an ACK check for data records sending to make sure every data arrive server.
478 +)))
479 +* (((
480 +b) S31x-LB will send data in **CONFIRMED Mode** when PNACKMD=1, but S31x-LB won't re-transmit the packet if it doesn't get ACK, it will just mark it as a NONE-ACK message. In a future uplink if S31x-LB gets a ACK, S31x-LB will consider there is a network connection and resend all NONE-ACK messages.
481 +)))
405 405  
406 -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:
483 +Below is the typical case for the auto-update datalog feature (Set PNACKMD=1)
407 407  
408 -* (% 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)
485 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/WebHome/image-20220703111700-2.png?width=1119&height=381&rev=1.1||alt="图片-20220703111700-2.png" height="381" width="1119"]]
409 409  
410 -* (% 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.
411 411  
412 -The diagram below explains the relationship between TR, NOUD, and TDC more clearly:
488 +=== 2.5.2 Unix TimeStamp ===
413 413  
414 -[[image:1692424376354-959.png]]
415 415  
491 +S31x-LB uses Unix TimeStamp format based on
416 416  
417 -== 2.5 Humidity and Temperature alarm function ==
493 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/WebHome/image-20220523001219-11.png?width=627&height=97&rev=1.1||alt="图片-20220523001219-11.png" height="97" width="627"]]
418 418  
495 +User can get this time from link:  [[https:~~/~~/www.epochconverter.com/>>url:https://www.epochconverter.com/]] :
419 419  
420 -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.
497 +Below is the converter example
421 421  
499 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/WebHome/image-20220523001219-12.png?width=720&height=298&rev=1.1||alt="图片-20220523001219-12.png" height="298" width="720"]]
422 422  
423 -(% style="color:blue" %)**AT Commands:**
424 424  
425 -(% style="color:#037691" %)**AT+ SHHUM=min,max**
502 +So, we can use AT+TIMESTAMP=1611889405 or downlink 3060137afd00 to set the current time 2021 – Jan ~-~- 29 Friday 03:03:25
426 426  
427 -Example: AT+ SHHUM=50,80  ~/~/ Alarm when humidity lower than 50 or higher than 80.
428 428  
505 +=== 2.5.3 Set Device Time ===
429 429  
430 -(% style="color:#037691" %)**AT+ SHTEMP=min,max**
431 431  
432 -Example: AT+ SHTEMP=20,30  ~/~/ Alarm when temperature lower than 20 or higher than 30
508 +User need to set (% style="color:blue" %)**SYNCMOD=1**(%%) to enable sync time via MAC command.
433 433  
510 +Once S31x-LB Joined LoRaWAN network, it will send the MAC command (DeviceTimeReq) and the server will reply with (DeviceTimeAns) to send the current time to S31x-LB. If S31x-LB fails to get the time from the server, S31x-LB will use the internal time and wait for next time request (AT+SYNCTDC to set the time request period, default is 10 days).
434 434  
435 -(% style="color:red" %)**Notice:**
512 +(% style="color:red" %)**Note: LoRaWAN Server need to support LoRaWAN v1.0.3(MAC v1.0.3) or higher to support this MAC command feature, Chirpstack,TTN V3 v3 and loriot support but TTN V3 v2 doesn't support. If server doesn't support this command, it will through away uplink packet with this command, so user will lose the packet with time request for TTN V3 v2 if SYNCMOD=1.**
436 436  
437 -* To disable Alarm, user can set min and max to same value , such as (% style="color:#037691" %)**AT+SHTEMP=0,0.**
438 438  
439 -* 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.**
515 +=== 2.5.4 Datalog Uplink payload (FPORT~=3) ===
440 440  
441 -== 2.6 Trggier an uplink by external interrupt ==
442 442  
518 +The Datalog uplinks will use below payload format.
443 443  
444 -S31-NB has an external trigger interrupt function. Users can use the PB15 pin to trigger the upload of data packets.
520 +**Retrieval data payload:**
445 445  
446 -(% style="color:blue" %)**AT command:**
522 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:500px" %)
523 +|=(% style="width: 60px;background-color:#D9E2F3;color:#0070C0" %)(((
524 +**Size(bytes)**
525 +)))|=(% style="width: 40px; background-color:#D9E2F3;color:#0070C0" %)**2**|=(% style="width: 55px; background-color:#D9E2F3;color:#0070C0" %)**2**|=(% style="width: 65px; background-color:#D9E2F3;color:#0070C0" %)**2**|=(% style="width: 180px; background-color:#D9E2F3;color:#0070C0" %)**1**|=(% style="width: 100px; background-color:#D9E2F3;color:#0070C0" %)**4**
526 +|(% style="width:103px" %)Value|(% style="width:68px" %)(((
527 +ignore
528 +)))|(% style="width:104px" %)(((
529 +(((
530 +Humidity
531 +)))
447 447  
448 -* (% style="color:#037691" %)**AT+INTMOD **(%%) ~/~/ Set the trigger interrupt mode
533 +(((
534 +
535 +)))
536 +)))|(% style="width:87px" %)(((
537 +Temperature
538 +)))|(% style="width:178px" %)(((
539 +Poll message flag & Alarm Flag& Level of PA8
540 +)))|(% style="width:137px" %)Unix Time Stamp
449 449  
450 -* (% style="color:#037691" %)**AT+INTMOD=0 **(%%) ~/~/ Disable Interrupt
542 +**Poll message flag & Alarm Flag & Level of PA8:**
451 451  
452 -* (% style="color:#037691" %)**AT+INTMOD=1 **(%%) ~/~/ Trigger by rising and falling edge
544 +[[image:image-20230524114302-1.png||height="115" width="736"]]
453 453  
454 -* (% style="color:#037691" %)**AT+INTMOD=2 **(%%) ~/~/ Trigger by falling edge
455 455  
456 -* (% style="color:#037691" %)**AT+INTMOD=3  **(%%) ~/~/ Trigger by rising edge
547 +**No ACK Message**:  1: This message means this payload is fromn Uplink Message which doesn't get ACK from the server before ( for **PNACKMD=1** feature)
457 457  
458 -= 3. Configure S31x-NB =
549 +**Poll Message Flag**: 1: This message is a poll message reply.
459 459  
551 +* Poll Message Flag is set to 1.
552 +
553 +* Each data entry is 11 bytes, to save airtime and battery, devices will send max bytes according to the current DR and Frequency bands.
554 +
555 +For example, in US915 band, the max payload for different DR is:
556 +
557 +**a) DR0:** max is 11 bytes so one entry of data
558 +
559 +**b) DR1:** max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
560 +
561 +**c) DR2:** total payload includes 11 entries of data
562 +
563 +**d) DR3: **total payload includes 22 entries of data.
564 +
565 +If devise doesn't have any data in the polling time. Device will uplink 11 bytes of 0   
566 +
567 +**Example:**
568 +
569 +If S31x-LB has below data inside Flash:
570 +
571 +[[image:image-20230524114654-2.png]]
572 +
573 +
574 +If user sends below downlink command: 31646D84E1646D856C05
575 +
576 +Where : Start time: 646D84E1 = time 23/5/24 03:30:41
577 +
578 + Stop time: 646D856C= time 23/5/24 03:33:00
579 +
580 +
581 +**S31x-LB will uplink this payload.**
582 +
583 +[[image:image-20230524114826-3.png||height="448" width="1244"]]
584 +
585 +(((
586 +00 00 02 36 01 10 40 64 6D 84 E1 00 00 02 37 01 10 40 64 6D 84 F8 00 00 02 37 01 0F 40 64 6D 85 04 00 00 02 3A 01 0F 40 64 6D 85 18 00 00 02 3C 01 0F 40 64 6D 85 36 00 00 02 3D 01 0E 40 64 6D 85 3F 00 00 02 3F 01 0E 40 64 6D 85 60 00 00 02 40 01 0E 40 64 6D 85 6A
587 +)))
588 +
589 +(((
590 +Where the first 11 bytes is for the first entry:
591 +)))
592 +
593 +(((
594 +00 00 02 36 01 10 40 64 6D 84 E1
595 +)))
596 +
597 +(((
598 +**Hum**=0x0236/10=56.6
599 +)))
600 +
601 +(((
602 +**Temp**=0x0110/10=27.2
603 +)))
604 +
605 +(((
606 +**poll message flag & Alarm Flag & Level of PA8**=0x40,means reply data,sampling uplink message,the PA8 is low level.
607 +)))
608 +
609 +(((
610 +**Unix time** is 0x646D84E1=1684899041s=23/5/24 03:30:41
611 +)))
612 +
613 +
614 +(% aria-label="数据 URI 图像图像小部件" contenteditable="false" role="region" style="background-image:url(http://wiki1.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" tabindex="-1" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||alt="数据 URI 图片" data-widget="image" draggable="true" height="15" role="presentation" title="单击并拖动以移动" width="15"]](% aria-label="数据 URI 图像图像小部件" contenteditable="false" role="region" style="background-image:url(http://wiki1.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" tabindex="-1" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||alt="数据 URI 图片" draggable="true" height="15" role="presentation" title="单击并拖动以移动" width="15"]](% aria-label="数据 URI 图像图像小部件" contenteditable="false" role="region" style="background-image:url(http://wiki1.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" tabindex="-1" title="单击并拖动以调整大小" %)的(% aria-label="数据 URI 图像图像小部件" contenteditable="false" role="region" style="background-image:url(http://wiki1.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" tabindex="-1" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||alt="数据 URI 图片" data-widget="image" draggable="true" height="15" role="presentation" title="单击并拖动以移动" width="15"]](% aria-label="数据 URI 图像图像小部件" contenteditable="false" role="region" style="background-image:url(http://wiki1.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" tabindex="-1" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||alt="数据 URI 图片" draggable="true" height="15" role="presentation" title="单击并拖动以移动" width="15"]](% aria-label="数据 URI 图像图像小部件" contenteditable="false" role="region" style="background-image:url(http://wiki1.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" tabindex="-1" title="单击并拖动以调整大小" %)的
615 +
616 +== 2.6 Temperature Alarm Feature ==
617 +
618 +
619 +S31x-LB work flow with Alarm feature.
620 +
621 +
622 +[[image:image-20230524110125-3.png||height="768" width="1115"]]
623 +
624 +
625 +
626 +== 2.7 Frequency Plans ==
627 +
628 +
629 +The S31x-LB uses OTAA mode and below frequency plans by default. If user want to use it with different frequency plan, please refer the AT command sets.
630 +
631 +[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]]
632 +
633 +
634 +== 2.8 ​Firmware Change Log ==
635 +
636 +
637 +**Firmware download link: **[[https:~~/~~/www.dropbox.com/sh/fis3g6nmhv0eokg/AAC6BcCZaX4BdqZkduUvZ3jIa?dl=0>>https://www.dropbox.com/sh/fis3g6nmhv0eokg/AAC6BcCZaX4BdqZkduUvZ3jIa?dl=0]]
638 +
639 +
640 += 3. Configure S31x-LB =
641 +
460 460  == 3.1 Configure Methods ==
461 461  
462 462  
463 -S31x-NB supports below configure method:
645 +S31x-LB supports below configure method:
464 464  
465 465  * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
466 -
467 467  * 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]].
649 +* LoRaWAN Downlink.  Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
468 468  
469 -== 3.2 AT Commands Set ==
651 +== 3.2 General Commands ==
470 470  
471 471  
472 -AT+<CMD>?        : Help on <CMD>
654 +These commands are to configure:
473 473  
474 -AT+<CMD>         : Run <CMD>
656 +* General system settings like: uplink interval.
657 +* LoRaWAN protocol & radio related command.
475 475  
476 -AT+<CMD>=<value> : Set the value
659 +They are same for all Dragino Devices which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki:
477 477  
478 -AT+<CMD>=?       : Get the value
661 +[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/]]
479 479  
480 480  
481 -(% style="color:blue" %)**General Commands**      
664 +== 3.3 Commands special design for S31x-LB ==
482 482  
483 -AT                    : Attention       
484 484  
485 -AT : Short Help     
667 +These commands only valid for S31x-LB, as below:
486 486  
487 -ATZ  : MCU Reset    
488 488  
489 -AT+TDC  : Application Data Transmission Interval
670 +=== 3.3.1 Set Transmit Interval Time ===
490 490  
491 -AT+CFG  : Print all configurations
492 492  
493 -AT+CFGMOD           : Working mode selection
673 +Feature: Change LoRaWAN End Node Transmit Interval.
494 494  
495 -AT+DEUI  : Get or set the Device ID
675 +(% style="color:blue" %)**AT Command: AT+TDC**
496 496  
497 -AT+INTMOD            : Set the trigger interrupt mode
677 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
678 +|=(% style="width: 156px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 137px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="background-color:#D9E2F3;color:#0070C0" %)**Response**
679 +|(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|(((
680 +30000
681 +OK
682 +the interval is 30000ms = 30s
683 +)))
684 +|(% style="width:156px" %)AT+TDC=60000|(% style="width:137px" %)Set Transmit Interval|(((
685 +OK
686 +Set transmit interval to 60000ms = 60 seconds
687 +)))
498 498  
499 -AT+5VT           : Set extend the time of 5V power  
689 +(% style="color:blue" %)**Downlink Command: 0x01**
500 500  
501 -AT+PRO          : Choose agreement
691 +Format: Command Code (0x01) followed by 3 bytes time value.
502 502  
503 -AT+RXDL  : Extend the sending and receiving time
693 +If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01.
504 504  
505 -AT+DNSCFG  : Get or Set DNS Server
695 +* Example 1: Downlink Payload: 0100001E  ~/~/  Set Transmit Interval (TDC) = 30 seconds
696 +* Example 2: Downlink Payload: 0100003C  ~/~/  Set Transmit Interval (TDC) = 60 seconds
506 506  
507 -AT+GETSENSORVALUE   : Returns the current sensor measurement
698 +=== 3.3.2 Get Device Status ===
508 508  
509 -AT+NOUD  : Get or Set the number of data to be uploaded
510 510  
511 -AT+CDP     : Read or Clear cached data
701 +Send a LoRaWAN downlink to ask device send Alarm settings.
512 512  
513 -AT+SHTEMP:  Get or Set alarm of temp
703 +(% style="color:blue" %)**Downlink Payload:  **(%%)0x26 01
514 514  
515 -AT+SHHUM:  Get or Set alarm of moisture
705 +Sensor will upload Device Status via FPORT=5. See payload section for detail.
516 516  
517 -AT+SERVADDR :  Server Address
518 518  
708 +=== 3.3.3 Set Temperature Alarm Threshold ===
519 519  
520 -(% style="color:blue" %)**UDP Management**
521 521  
522 -AT+CFM  Upload confirmation mode (only valid for UDP)
711 +* (% style="color:blue" %)**AT Command:**
523 523  
713 +(% style="color:#037691" %)**AT+SHTEMP=min,max**
524 524  
525 -(% style="color:blue" %)**MQTT Management**
715 +* When min=0, and max≠0, Alarm higher than max
716 +* When min≠0, and max=0, Alarm lower than min
717 +* When min≠0 and max≠0, Alarm higher than max or lower than min
526 526  
527 -AT+CLIENT               : Get or Set MQTT client
719 +Example:
528 528  
529 -AT+UNAME              : Get or Set MQTT Username
721 + AT+SHTEMP=0,30   ~/~/ Alarm when temperature higher than 30.
530 530  
531 -AT+PWD                  : Get or Set MQTT password
723 +* (% style="color:blue" %)**Downlink Payload:**
532 532  
533 -AT+PUBTOPIC  : Get or Set MQTT publish topic
725 +(% style="color:#037691" %)**0x(0C 01 00 1E)**  (%%) ~/~/ Set AT+SHTEMP=0,30
534 534  
535 -AT+SUBTOPIC  : Get or Set MQTT subscription topic
727 +(% style="color:red" %)**(note: 3^^rd^^ byte= 0x00 for low limit(not set), 4^^th^^ byte = 0x1E for high limit: 30)**
536 536  
537 537  
538 -(% style="color:blue" %)**Information**          
730 +=== 3.3.4 Set Humidity Alarm Threshold ===
539 539  
540 -AT+FDR  : Factory Data Reset
541 541  
542 -AT+PWORD  : Serial Access Password
733 +* (% style="color:blue" %)**AT Command:**
543 543  
544 -AT+LDATA  : Get the last upload data
735 +(% style="color:#037691" %)**AT+SHHUM=min,max**
545 545  
546 -AT+CDP  : Read or Clear cached data
737 +* When min=0, and max≠0, Alarm higher than max
738 +* When min≠0, and max=0, Alarm lower than min
739 +* When min≠0 and max≠0, Alarm higher than max or lower than min
547 547  
741 +Example:
548 548  
743 + AT+SHHUM=70,0  ~/~/ Alarm when humidity lower than 70%.
744 +
745 +* (% style="color:blue" %)**Downlink Payload:**
746 +
747 +(% style="color:#037691" %)**0x(0C 02 46 00)**(%%)  ~/~/ Set AT+SHTHUM=70,0
748 +
749 +(% style="color:red" %)**(note: 3^^rd^^ byte= 0x46 for low limit (70%), 4^^th^^ byte = 0x00 for high limit (not set))**
750 +
751 +
752 +=== 3.3.5 Set Alarm Interval ===
753 +
754 +
755 +The shortest time of two Alarm packet. (unit: min)
756 +
757 +* (% style="color:blue" %)**AT Command:**
758 +
759 +(% style="color:#037691" %)**AT+ATDC=30** (%%) ~/~/ The shortest interval of two Alarm packets is 30 minutes, Means is there is an alarm packet uplink, there won't be another one in the next 30 minutes.
760 +
761 +* (% style="color:blue" %)**Downlink Payload:**
762 +
763 +(% style="color:#037691" %)**0x(0D 00 1E)**(%%)     **~-~--> ** Set AT+ATDC=0x 00 1E = 30 minutes
764 +
765 +
766 +=== 3.3.6 Get Alarm settings ===
767 +
768 +
769 +Send a LoRaWAN downlink to ask device send Alarm settings.
770 +
771 +* (% style="color:#037691" %)**Downlink Payload:  **(%%)0x0E 01
772 +
773 +**Example:**
774 +
775 +[[image:image-20230524110211-4.png]]
776 +
777 +**Explain:**
778 +
779 +* Alarm & MOD bit is 0x7C, 0x7C >> 2 = 0x31: Means this message is the Alarm settings message.
780 +
781 +=== 3.3.7 Set Interrupt Mode ===
782 +
783 +
784 +Feature, Set Interrupt mode for PA8 of pin.
785 +
786 +When AT+INTMOD=0 is set, PA8 is used as a digital input port.
787 +
788 +(% style="color:blue" %)**AT Command: AT+INTMOD**
789 +
790 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
791 +|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 197px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 158px;background-color:#D9E2F3;color:#0070C0" %)**Response**
792 +|(% style="width:154px" %)AT+INTMOD=?|(% style="width:196px" %)Show current interrupt mode|(% style="width:157px" %)(((
793 +0
794 +OK
795 +the mode is 0 =Disable Interrupt
796 +)))
797 +|(% style="width:154px" %)AT+INTMOD=2|(% style="width:196px" %)(((
798 +Set Transmit Interval
799 +0. (Disable Interrupt),
800 +~1. (Trigger by rising and falling edge)
801 +2. (Trigger by falling edge)
802 +3. (Trigger by rising edge)
803 +)))|(% style="width:157px" %)OK
804 +
805 +(% style="color:blue" %)**Downlink Command: 0x06**
806 +
807 +Format: Command Code (0x06) followed by 3 bytes.
808 +
809 +This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
810 +
811 +* Example 1: Downlink Payload: 06000000  ~/~/  Turn off interrupt mode
812 +* Example 2: Downlink Payload: 06000003  ~/~/  Set the interrupt mode to rising edge trigger
813 +
814 +=== 3.3.8 Set Power Output Duration ===
815 +
816 +
817 +Control the output duration 5V . Before each sampling, device will
818 +
819 +~1. first enable the power output to external sensor,
820 +
821 +2. keep it on as per duration, read sensor value and construct uplink payload
822 +
823 +3. final, close the power output.
824 +
825 +(% style="color:blue" %)**AT Command: AT+5VT**
826 +
827 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
828 +|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 197px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 158px;background-color:#D9E2F3;color:#0070C0" %)**Response**
829 +|(% style="width:154px" %)AT+5VT=?|(% style="width:196px" %)Show 5V open time.|(% style="width:157px" %)0 (default)
830 +OK
831 +|(% style="width:154px" %)AT+5VT=1000|(% style="width:196px" %)Close after a delay of 1000 milliseconds.|(% style="width:157px" %)OK
832 +
833 +(% style="color:blue" %)**Downlink Command: 0x07**
834 +
835 +Format: Command Code (0x07) followed by 2 bytes.
836 +
837 +The first and second bytes are the time to turn on.
838 +
839 +* Example 1: Downlink Payload: 070000  **~-~-->**  AT+5VT=0
840 +* Example 2: Downlink Payload: 0701F4  **~-~-->**  AT+5VT=500
841 +
549 549  = 4. Battery & Power Consumption =
550 550  
551 551  
552 -S31x-NB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
845 +S31x-LB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
553 553  
554 554  [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
555 555  
556 556  
557 -= 5. Firmware update =
850 += 5. OTA Firmware update =
558 558  
559 559  
560 -User can change device firmware to::
853 +(% class="wikigeneratedid" %)
854 +User can change firmware S31x-LB to:
561 561  
856 +* Change Frequency band/ region.
562 562  * Update with new features.
563 -
564 564  * Fix bugs.
565 565  
566 -Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/fhb3uyl4gt6clru/AAAiZVTFcxrfE1JOOyfcgO9ha?dl=0]]**
860 +Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/fis3g6nmhv0eokg/AAC6BcCZaX4BdqZkduUvZ3jIa?dl=0]]**
567 567  
862 +
568 568  Methods to Update Firmware:
569 569  
570 -* (Recommended way) OTA firmware update via BLE: [[**Instruction**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/BLE_Firmware_Update_NB_Sensors_BC660K-GL/]].
571 -
865 +* (Recommanded way) OTA firmware update via wireless : **[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/]]**
572 572  * 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]]**.
573 573  
574 -
575 575  = 6. FAQ =
576 576  
577 -== 6.1 How can I access t BC660K-GL AT Commands? ==
578 578  
579 579  
580 -User can access to BC660K-GL directly and send AT Commands.
872 += 7. Order Info =
581 581  
582 -[[See BC660K-GL AT Command set>>url:https://www.dropbox.com/sh/5f6ssda5fum8rvs/AABT68l8ZzWOvZ5eg2qwOoFda?dl=0]]
583 583  
875 +Part Number: (% style="color:blue" %)**S31-LB-XX  / S31B-LB-XX**
584 584  
877 +(% style="color:red" %)**XX**(%%): The default frequency band
585 585  
586 -= 7. Order Info =
879 +* (% style="color:red" %)**AS923**(%%): LoRaWAN AS923 band
587 587  
881 +* (% style="color:red" %)**AU915**(%%): LoRaWAN AU915 band
588 588  
589 -Part Number: (% style="color:blue" %)**S31-NB-XX  / S31B-NB-XX**
883 +* (% style="color:red" %)**EU433**(%%): LoRaWAN EU433 band
590 590  
591 -(% style="color:red" %)**XX**(%%):
885 +* (% style="color:red" %)**EU868**(%%): LoRaWAN EU868 band
592 592  
593 -* (% style="color:#037691" %)**GE**(%%): General version ( Exclude SIM card)
887 +* (% style="color:red" %)**KR920**(%%): LoRaWAN KR920 band
594 594  
595 -* (% style="color:#037691" %)**1D**(%%): with 1NCE* 10 years 500MB SIM card and Pre-configure to DataCake server
889 +* (% style="color:red" %)**US915**(%%): LoRaWAN US915 band
596 596  
597 -(% 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
891 +* (% style="color:red" %)**IN865**(%%): LoRaWAN IN865 band
598 598  
893 +* (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
599 599  
600 -
601 601  = 8. ​Packing Info =
602 602  
603 603  
604 604  (% style="color:#037691" %)**Package Includes**:
605 605  
606 -* S31-NB or S31-NB NB-IoT Sensor Node x 1
900 +* S31x-LB LoRaWAN Temperature & Humidity Sensor
607 607  
608 -* External antenna x 1
609 -
610 -
611 611  (% style="color:#037691" %)**Dimension and weight**:
612 612  
613 -* Device Size: 13.0 x 5 x 4.5 cm
904 +* Device Size: cm
614 614  
615 -* Device Weight: 150g
906 +* Device Weight: g
616 616  
617 -* Package Size / pcs : 14.0 x 8x 5 cm
908 +* Package Size / pcs : cm
618 618  
619 -* Weight / pcs : 180g
910 +* Weight / pcs : g
620 620  
621 621  = 9. Support =
622 622  
... ... @@ -625,4 +625,4 @@
625 625  
626 626  * 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]].
627 627  
628 -(% style="display:none" %) (%%)
919 +(% style="display:none" %) (%%)
1692424009971-458.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -147.4 KB
Content
1692424376354-959.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -146.1 KB
Content