Skip to Content

Changes for page wiki_test

Last modified by Mengting Qiu on 2024/09/05 17:35
From version 82.8
edited by Xiaoling
on 2023/08/19 14:00
Change comment: There is no comment for this version
To version 80.3
edited by Xiaoling
on 2023/08/19 11:37
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -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.
... ... @@ -192,7 +192,7 @@
192 192  
193 193  
194 194  (% border="1" cellspacing="5" style="width:410px" %)
195 -|=(% 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
196 196  |(% style="width:102px" %)(((
197 197  S31-LB
198 198  )))|(% style="width:126px" %)(((
... ... @@ -234,97 +234,101 @@
234 234  [[image:1692415924540-357.png]]
235 235  
236 236  
237 -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.
238 238  
239 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.
242 +**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 241  
242 242  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]].
243 243  
244 -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]]. 
245 -
246 246  Below shows result of different server as a glance.
247 247  
248 248  
249 -(% border="1" cellspacing="4" style="width:515px" %)
250 -|(% 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**
251 -|(% 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" %)[[image:image-20230819113244-8.png||height="183" width="367"]]|(% 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" %)[[image:image-20230819113244-9.png||height="120" width="369"]]|(% style="width:170px" %)
253 -|(% 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" %)
254 -|(% 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" %)
255 -|(% 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" %)
256 -|(% 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" %)[[image:image-20230819113244-10.png||height="82" width="291"]]|(% style="width:170px" %)
257 -|(% 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" %)[[image:image-20230819113244-11.png||height="113" width="293"]]|(% style="width:170px" %)
258 -|(% style="width:127px" %) |(% style="width:385px" %) |(% style="width:170px" %)
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 +| | |
259 259  
260 -(% 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]].
261 261  
262 262  
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 +
263 263  == 2.2 ​Payload Types ==
264 264  
265 265  
266 266  To meet different server requirement, S31-NB supports different payload type.
267 267  
268 -**Includes:**
270 +Includes:
269 269  
270 270  * [[General JSON format payload>>path:#General_Json]]. (Type=5)
271 -
272 272  * [[HEX format Payload>>path:#HEX_Payload]]. (Type=0)
273 -
274 274  * [[ThingSpeak Format>>path:#ThingSpeak_Payload]]. (Type=1)
275 -
276 276  * [[ThingsBoard Format>>path:#ThingsBoard_Payload]]. (Type=3)
277 277  
277 +
278 278  User can specify the payload type when choose the connection protocol. Example:
279 279  
280 -(% style="color:#037691" %)**AT+PRO=2,0**  (%%) ~/~/ Use UDP Connection & hex Payload
280 +**AT+PRO=2,0** ~/~/Use UDP Connection & hex Payload
281 281  
282 -(% style="color:#037691" %)**AT+PRO=2,5**   (%%) ~/~/ Use UDP Connection & Json Payload
282 +**AT+PRO=2,5** ~/~/ Use UDP Connection & Json Payload
283 283  
284 -(% style="color:#037691" %)**AT+PRO=3,5 ** (%%) ~/~/ Use MQTT Connection & Json Payload
284 +**AT+PRO=3,5 **~/~/ Use MQTT Connection & Json Payload
285 285  
286 286  
287 -=== 2.2.1 General Json Format (Type~=5) ===
287 +1.
288 +11.
289 +111. General Json Format (Type=5)
288 288  
289 -
290 290  This is the General Json Format. As below:
291 291  
292 -(% 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}}**
293 293  
294 +**{"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}}**
294 294  
295 -(% style="color:red" %)**Notice, from above payload:**
296 296  
297 +
298 +Notice, from above payload:
299 +
297 297  * Temperature , Humidity , Battery & Signal are the value at uplink time.
301 +* Json entry 1 ~~ 8 are the last 1 ~~ 8 sampling data as specify by **AT+NOUD=8 **Command**.** Each entry includes (from left to right): Temperature, Humidity, Sampling time.
298 298  
299 -* 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.
300 300  
301 301  
302 302  
303 -=== 2.2.2 HEX format Payload(Type~=0) ===
306 +1.
307 +11.
308 +111. HEX format Payload(Type=0)
304 304  
305 305  
306 306  This is the HEX Format. As below:
307 307  
308 -(% style="color:#4472c4" %)**f86620705346276200640cba16010000000011011801e864d49c2d011a01e364d49925011901eb64d49871011901e564d497bd011a01e664d49709011901e964d49655011a01e864d495a1011a01e864d494ed011801e864d49439**
313 +**f86620705346276200640cba16010000000011011801e864d49c2d011a01e364d49925011901eb64d49871011901e564d497bd011a01e664d49709011901e964d49655011a01e864d495a1011a01e864d494ed011801e864d49439**
309 309  
310 -[[image:1692424009971-458.png]]
311 311  
316 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image001.png]]
312 312  
313 -(% style="color:blue" %)**Version:**
314 314  
319 +**Version:**
320 +
315 315  These bytes include the hardware and software version.
316 316  
317 -(% style="color:#037691" %)**Higher byte:**(%%) Specify Sensor Model: 0x00 for S31B-NB & S31-NB
323 +**Higher byte:** Specify Sensor Model: 0x00 for S31B-NB & S31-NB
318 318  
319 -(% style="color:#037691" %)**Lower byte:**(%%) Specify the software version: 0x64=100, means firmware version 100
325 +**Lower byte:** Specify the software version: 0x64=100, means firmware version 100
320 320  
321 321  
322 -(% style="color:blue" %)**BAT (Battery Info):**
328 +**BAT (Battery Info)**
323 323  
324 324  Ex1: 0x0CBA = 3258mV
325 325  
326 326  
327 -(% style="color:blue" %)**Signal Strength:**
333 +**Signal Strength**
328 328  
329 329  NB-IoT Network signal Strength.
330 330  
... ... @@ -341,7 +341,7 @@
341 341  **99**    Not known or not detectable
342 342  
343 343  
344 -(% style="color:blue" %)**Temperature: **
350 +**Temperature: **
345 345  
346 346  If payload is: 0105H:  (0105 & 8000 == 0), temp = 0105H /10 = 26.1 degree
347 347  
... ... @@ -350,12 +350,13 @@
350 350  (FF3F & 8000：Judge whether the highest bit is 1, when the highest bit is 1, it is negative)
351 351  
352 352  
353 -(% style="color:blue" %)**Humidity:   **
354 354  
360 +**Humidity:   **
361 +
355 355  Read:0295(H)=661(D)    Value:  661 / 10=66.1, So 66.1%
356 356  
357 357  
358 -(% style="color:blue" %)**TimeStamp:   **
365 +**TimeStamp:   **
359 359  
360 360  Unit TimeStamp Example: 64d49439(H) = 1691653177(D)
361 361  
... ... @@ -362,185 +362,300 @@
362 362  Put the decimal value into this link(https:~/~/www.epochconverter.com/) to get the time.
363 363  
364 364  
365 -=== 2.2.3 ThingsBoard Payload(Type~=3) ===
372 +1.
373 +11.
374 +111. ThingsBoard Payload(Type=3)
366 366  
367 -
368 368  Type3 payload special design for ThingsBoard, it will also configure other default server to ThingsBoard.
369 369  
370 -(% style="color:#4472c4" %)**{"IMEI":866207053462762,"temperature":29.2,"humidity":54.2,"battery":3.27,"signal":24}**
371 371  
379 +**{"IMEI":866207053462762,"temperature":29.2,"humidity":54.2,"battery":3.27,"signal":24}**
372 372  
373 -=== 2.2.4 ThingSpeak Payload(Type~=1) ===
374 374  
382 +1.
383 +11.
384 +111. ThingSpeak Payload(Type=1)
375 375  
376 376  This payload meets ThingSpeak platform requirement. It includes only four fields. Form 1~~4 are:
377 377  
378 378  Temperature, Humidity, Battery & Signal. This payload type only valid for ThingsSpeak Platform
379 379  
390 +
380 380  As below:
381 381  
382 -(% style="color:#4472c4" %)**field1=27.9&field2=49.9&field3=3.23&field4=28**
393 +**field1=27.9&field2=49.9&field3=3.23&field4=28**
383 383  
384 384  
385 -== 2.3 Test Uplink and Change Update Interval ==
396 +1.
397 +11. Test Uplink and Change Update Interval
386 386  
399 +By default, Sensor will send uplinks **every 2 hours** & AT+NOUD=8
387 387  
388 -By default, Sensor will send uplinks (% style="color:blue" %)**every 2 hours**(%%) & AT+NOUD=8
389 389  
390 -User can use below commands to change the (% style="color:blue" %)**uplink interval**.
402 +User can use below commands to change the **uplink interval**.
391 391  
392 -(% style="color:#037691" %)**AT+TDC=600 ** (%%) ~/~/ Set Update Interval to 600s
404 +**~ AT+TDC=600      **~/~/ Set Update Interval to 600s
393 393  
406 +
394 394  User can also push the button for more than 1 seconds to activate an uplink.
395 395  
396 396  
397 -== 2.4 Multi-Samplings and One uplink ==
398 398  
399 399  
412 +1.
413 +11. Multi-Samplings and One uplink
414 +
400 400  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:
401 401  
402 -* (% 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)
417 +* **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)
418 +* **AT+NOUD=8**  ~/~/   The device uploads 8 sets of recorded data by default. Up to 32 sets of record data can be uploaded.
403 403  
404 -* (% 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.
405 405  
406 406  The diagram below explains the relationship between TR, NOUD, and TDC more clearly:
407 407  
408 -[[image:1692424376354-959.png]]
423 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image001.png||alt="IMG_256"]]
409 409  
410 410  
411 -== 2.5 Humidity and Temperature alarm function ==
426 +1.
427 +11. Humidity and Temperature alarm function
412 412  
413 -
414 414  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.
415 415  
416 416  
417 -(% style="color:blue" %)**AT Commands:**
432 +AT Commands:
418 418  
419 -(% style="color:#037691" %)**AT+ SHHUM=min,max**
434 +**AT+ SHHUM=min,max**
420 420  
421 -Example: AT+ SHHUM=50,80  ~/~/ Alarm when humidity lower than 50 or higher than 80.
436 +Example: AT+ SHHUM=50,80 ~/~/ Alarm when humidity lower than 50 or higher than 80.
422 422  
423 423  
424 -(% style="color:#037691" %)**AT+ SHTEMP=min,max**
439 +**AT+ SHTEMP=min,max**
425 425  
426 -Example: AT+ SHTEMP=20,30  ~/~/ Alarm when temperature lower than 20 or higher than 30
441 +Example: AT+ SHTEMP=20,30 ~/~/ Alarm when temperature lower than 20 or higher than 30
427 427  
428 428  
429 -(% style="color:red" %)**Notice:**
444 +Notice:
430 430  
431 -* To disable Alarm, user can set min and max to same value , such as (% style="color:#037691" %)**AT+SHTEMP=0,0.**
446 +* To disable Alarm, user can set min and max to same value , such as **AT+SHTEMP=0,0.**
447 +* 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: **AT+SHTEMP=-80,0.**
432 432  
433 -* 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.**
434 434  
450 +1.
451 +11. Trggier an uplink by external interrupt
435 435  
453 +S31-NB has an external trigger interrupt function. Users can use the PB15 pin to trigger the upload of data packets.
436 436  
437 -== 2.6 Trggier an uplink by external interrupt ==
455 +AT command:
438 438  
457 +* AT+INTMOD   ~/~/ Set the trigger interrupt mode
458 +* AT+INTMOD=0    ~/~/Disable Interrupt
459 +* AT+INTMOD=1   ~/~/Trigger by rising and falling edge
460 +* AT+INTMOD=2   ~/~/Trigger by falling edge
461 +* AT+INTMOD=3    ~/~/Trigger by rising edge
439 439  
440 -S31-NB has an external trigger interrupt function. Users can use the PB15 pin to trigger the upload of data packets.
441 441  
442 -(% style="color:blue" %)**AT command:**
464 += 3. Configure S31x-LB =
443 443  
444 -* (% style="color:#037691" %)**AT+INTMOD **(%%) ~/~/ Set the trigger interrupt mode
466 +== 3.1 Configure Methods ==
445 445  
446 -* (% style="color:#037691" %)**AT+INTMOD=0 **(%%) ~/~/ Disable Interrupt
447 447  
448 -* (% style="color:#037691" %)**AT+INTMOD=1 **(%%) ~/~/ Trigger by rising and falling edge
469 +S31x-LB supports below configure method:
449 449  
450 -* (% style="color:#037691" %)**AT+INTMOD=2 **(%%) ~/~/ Trigger by falling edge
471 +* AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
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 +* LoRaWAN Downlink.  Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
451 451  
452 -* (% style="color:#037691" %)**AT+INTMOD=3  **(%%) ~/~/ Trigger by rising edge
475 +== 3.2 General Commands ==
453 453  
454 454  
455 -= 3. Configure S31x-NB =
478 +These commands are to configure:
456 456  
457 -== 3.1 Configure Methods ==
480 +* General system settings like: uplink interval.
481 +* LoRaWAN protocol & radio related command.
458 458  
483 +They are same for all Dragino Devices which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki:
459 459  
460 -S31x-NB supports below configure method:
485 +[[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/]]
461 461  
462 -* AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
463 463  
464 -* 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]].
488 +== 3.3 Commands special design for S31x-LB ==
465 465  
466 -== 3.2 AT Commands Set ==
467 467  
491 +These commands only valid for S31x-LB, as below:
468 468  
469 -AT+<CMD>?        : Help on <CMD>
470 470  
471 -AT+<CMD>         : Run <CMD>
494 +=== 3.3.1 Set Transmit Interval Time ===
472 472  
473 -AT+<CMD>=<value> : Set the value
474 474  
475 -AT+<CMD>=?       : Get the value
497 +Feature: Change LoRaWAN End Node Transmit Interval.
476 476  
499 +(% style="color:blue" %)**AT Command: AT+TDC**
477 477  
478 -**General Commands**      
501 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
502 +|=(% 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**
503 +|(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|(((
504 +30000
505 +OK
506 +the interval is 30000ms = 30s
507 +)))
508 +|(% style="width:156px" %)AT+TDC=60000|(% style="width:137px" %)Set Transmit Interval|(((
509 +OK
510 +Set transmit interval to 60000ms = 60 seconds
511 +)))
479 479  
480 -AT                    : Attention       
513 +(% style="color:blue" %)**Downlink Command: 0x01**
481 481  
482 -AT?                            : Short Help     
515 +Format: Command Code (0x01) followed by 3 bytes time value.
483 483  
484 -ATZ                            : MCU Reset    
517 +If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01.
485 485  
486 -AT+TDC           : Application Data Transmission Interval
519 +* Example 1: Downlink Payload: 0100001E  ~/~/  Set Transmit Interval (TDC) = 30 seconds
520 +* Example 2: Downlink Payload: 0100003C  ~/~/  Set Transmit Interval (TDC) = 60 seconds
487 487  
488 -AT+CFG           : Print all configurations
522 +=== 3.3.2 Get Device Status ===
489 489  
490 -AT+CFGMOD           : Working mode selection
491 491  
492 -AT+DEUI                             : Get or set the Device ID
525 +Send a LoRaWAN downlink to ask device send Alarm settings.
493 493  
494 -AT+INTMOD            : Set the trigger interrupt mode
527 +(% style="color:blue" %)**Downlink Payload:  **(%%)0x26 01
495 495  
496 -AT+5VT           : Set extend the time of 5V power  
529 +Sensor will upload Device Status via FPORT=5. See payload section for detail.
497 497  
498 -AT+PRO          : Choose agreement
499 499  
500 -AT+RXDL                  : Extend the sending and receiving time
532 +=== 3.3.3 Set Temperature Alarm Threshold ===
501 501  
502 -AT+DNSCFG         :  Get or Set DNS Server
503 503  
504 -AT+GETSENSORVALUE   : Returns the current sensor measurement
535 +* (% style="color:blue" %)**AT Command:**
505 505  
506 -AT+NOUD      : Get or Set the number of data to be uploaded
537 +(% style="color:#037691" %)**AT+SHTEMP=min,max**
507 507  
508 -AT+CDP     : Read or Clear cached data
539 +* When min=0, and max≠0, Alarm higher than max
540 +* When min≠0, and max=0, Alarm lower than min
541 +* When min≠0 and max≠0, Alarm higher than max or lower than min
509 509  
510 -AT+SHTEMP: Get or Set alarm of temp
543 +Example:
511 511  
512 -AT+SHHUM: Get or Set alarm of moisture
545 + AT+SHTEMP=0,30   ~/~/ Alarm when temperature higher than 30.
513 513  
514 -AT+SERVADDR                 : Server Address
547 +* (% style="color:blue" %)**Downlink Payload:**
515 515  
516 -**UDP Management**
549 +(% style="color:#037691" %)**0x(0C 01 00 1E)**  (%%) ~/~/ Set AT+SHTEMP=0,30
517 517  
518 -AT+CFM          : Upload confirmation mode (only valid for UDP)
551 +(% style="color:red" %)**(note: 3^^rd^^ byte= 0x00 for low limit(not set), 4^^th^^ byte = 0x1E for high limit: 30)**
519 519  
520 520  
521 -**MQTT Management**
554 +=== 3.3.4 Set Humidity Alarm Threshold ===
522 522  
523 -AT+CLIENT               : Get or Set MQTT client
524 524  
525 -AT+UNAME              : Get or Set MQTT Username
557 +* (% style="color:blue" %)**AT Command:**
526 526  
527 -AT+PWD                  : Get or Set MQTT password
559 +(% style="color:#037691" %)**AT+SHHUM=min,max**
528 528  
529 -AT+PUBTOPIC                   : Get or Set MQTT publish topic
561 +* When min=0, and max≠0, Alarm higher than max
562 +* When min≠0, and max=0, Alarm lower than min
563 +* When min≠0 and max≠0, Alarm higher than max or lower than min
530 530  
531 -AT+SUBTOPIC                   : Get or Set MQTT subscription topic
565 +Example:
532 532  
567 + AT+SHHUM=70,0  ~/~/ Alarm when humidity lower than 70%.
533 533  
534 -**Information**          
569 +* (% style="color:blue" %)**Downlink Payload:**
535 535  
536 -AT+FDR           : Factory Data Reset
571 +(% style="color:#037691" %)**0x(0C 02 46 00)**(%%)  ~/~/ Set AT+SHTHUM=70,0
537 537  
538 -AT+PWORD             : Serial Access Password
573 +(% style="color:red" %)**(note: 3^^rd^^ byte= 0x46 for low limit (70%), 4^^th^^ byte = 0x00 for high limit (not set))**
539 539  
540 -AT+LDATA  : Get the last upload data
541 541  
542 -AT+CDP                              : Read or Clear cached data
576 +=== 3.3.5 Set Alarm Interval ===
543 543  
578 +
579 +The shortest time of two Alarm packet. (unit: min)
580 +
581 +* (% style="color:blue" %)**AT Command:**
582 +
583 +(% 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.
584 +
585 +* (% style="color:blue" %)**Downlink Payload:**
586 +
587 +(% style="color:#037691" %)**0x(0D 00 1E)**(%%)     **~-~--> ** Set AT+ATDC=0x 00 1E = 30 minutes
588 +
589 +
590 +=== 3.3.6 Get Alarm settings ===
591 +
592 +
593 +Send a LoRaWAN downlink to ask device send Alarm settings.
594 +
595 +* (% style="color:#037691" %)**Downlink Payload:  **(%%)0x0E 01
596 +
597 +**Example:**
598 +
599 +[[image:image-20230524110211-4.png]]
600 +
601 +**Explain:**
602 +
603 +* Alarm & MOD bit is 0x7C, 0x7C >> 2 = 0x31: Means this message is the Alarm settings message.
604 +
605 +=== 3.3.7 Set Interrupt Mode ===
606 +
607 +
608 +Feature, Set Interrupt mode for PA8 of pin.
609 +
610 +When AT+INTMOD=0 is set, PA8 is used as a digital input port.
611 +
612 +(% style="color:blue" %)**AT Command: AT+INTMOD**
613 +
614 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
615 +|=(% 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**
616 +|(% style="width:154px" %)AT+INTMOD=?|(% style="width:196px" %)Show current interrupt mode|(% style="width:157px" %)(((
617 +0
618 +OK
619 +the mode is 0 =Disable Interrupt
620 +)))
621 +|(% style="width:154px" %)AT+INTMOD=2|(% style="width:196px" %)(((
622 +Set Transmit Interval
623 +0. (Disable Interrupt),
624 +~1. (Trigger by rising and falling edge)
625 +2. (Trigger by falling edge)
626 +3. (Trigger by rising edge)
627 +)))|(% style="width:157px" %)OK
628 +
629 +(% style="color:blue" %)**Downlink Command: 0x06**
630 +
631 +Format: Command Code (0x06) followed by 3 bytes.
632 +
633 +This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
634 +
635 +* Example 1: Downlink Payload: 06000000  ~/~/  Turn off interrupt mode
636 +* Example 2: Downlink Payload: 06000003  ~/~/  Set the interrupt mode to rising edge trigger
637 +
638 +=== 3.3.8 Set Power Output Duration ===
639 +
640 +
641 +Control the output duration 5V . Before each sampling, device will
642 +
643 +~1. first enable the power output to external sensor,
644 +
645 +2. keep it on as per duration, read sensor value and construct uplink payload
646 +
647 +3. final, close the power output.
648 +
649 +(% style="color:blue" %)**AT Command: AT+5VT**
650 +
651 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
652 +|=(% 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**
653 +|(% style="width:154px" %)AT+5VT=?|(% style="width:196px" %)Show 5V open time.|(% style="width:157px" %)0 (default)
654 +OK
655 +|(% style="width:154px" %)AT+5VT=1000|(% style="width:196px" %)Close after a delay of 1000 milliseconds.|(% style="width:157px" %)OK
656 +
657 +(% style="color:blue" %)**Downlink Command: 0x07**
658 +
659 +Format: Command Code (0x07) followed by 2 bytes.
660 +
661 +The first and second bytes are the time to turn on.
662 +
663 +* Example 1: Downlink Payload: 070000  **~-~-->**  AT+5VT=0
664 +* Example 2: Downlink Payload: 0701F4  **~-~-->**  AT+5VT=500
665 +
544 544  = 4. Battery & Power Consumption =
545 545  
546 546  
... ... @@ -618,4 +618,4 @@
618 618  
619 619  * 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]].
620 620  
621 -(% style="display:none" %) (%%)
743 +(% 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