Changes for page wiki_test
Last modified by Mengting Qiu on 2024/09/05 17:35
Summary
-
Page properties (2 modified, 0 added, 0 removed)
-
Attachments (0 modified, 0 added, 3 removed)
Details
- Page properties
-
- Title
-
... ... @@ -1,1 +1,1 @@ 1 - DDS20-NB-NB-IoTUltrasonicLiquidLevelSensor User Manual1 +S31-NB/S31B-NB_BN-IoT Outdoor Temperature & Humidity Sensor User Manual - Content
-
... ... @@ -1,9 +1,10 @@ 1 1 (% style="text-align:center" %) 2 -[[image:image-20230911 134259-1.png||height="570" width="570"]]2 +[[image:image-20230819102136-3.png]] 3 3 4 4 5 -**Table of Contents:** 6 6 6 +**Table of Contents:** 7 + 7 7 {{toc/}} 8 8 9 9 ... ... @@ -13,7 +13,7 @@ 13 13 14 14 = 1. Introduction = 15 15 16 -== 1.1 What is DDS20-NB NB-IoTUltrasonicliquidlevelSensor ==17 +== 1.1 What is S31x-NB NB-IoT Temperature & Humidity Sensor == 17 17 18 18 19 19 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*. ... ... @@ -20,7 +20,7 @@ 20 20 21 21 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. 22 22 23 -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. 24 24 25 25 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). 26 26 ... ... @@ -27,7 +27,7 @@ 27 27 *make sure you have NB-IoT coverage locally. 28 28 29 29 30 -[[image: image-20230911140426-2.png||height="320" width="951"]]31 +[[image:1692411831805-116.png]] 31 31 32 32 33 33 == 1.2 Features == ... ... @@ -48,12 +48,12 @@ 48 48 == 1.3 Specification == 49 49 50 50 51 -(% style="color: blue" %)**Common DC Characteristics:**52 +(% style="color:#037691" %)**Common DC Characteristics:** 52 52 53 53 * Supply Voltage: 2.1v ~~ 3.6v 54 54 * Operating Temperature: -40 ~~ 85°C 55 55 56 -(% style="color: blue" %)**Temperature Sensor:**57 +(% style="color:#037691" %)**Temperature Sensor:** 57 57 58 58 * Range: -40 to + 80°C 59 59 * Accuracy: ±0.2 @ 0-90 °C ... ... @@ -60,7 +60,7 @@ 60 60 * Resolution: 0.1°C 61 61 * Long Term Shift: <0.03 °C/yr 62 62 63 -(% style="color: blue" %)**Humidity Sensor: **64 +(% style="color:#037691" %)**Humidity Sensor: ** 64 64 65 65 * Range: 0 ~~ 99.9% RH 66 66 * Accuracy: ± 2%RH ( 0 ~~ 100%RH) ... ... @@ -67,11 +67,11 @@ 67 67 * Resolution: 0.01% RH 68 68 * Long Term Shift: <0.25 %RH/yr 69 69 70 -(% style="color: blue" %)**NB-IoT Spec:**71 +(% style="color:#037691" %)**NB-IoT Spec:** 71 71 72 - (% style="color:#037691" %)**NB-IoT Module: BC660K-GL**73 +**NB-IoT Module: BC660K-GL** 73 73 74 - (% style="color:#037691" %)**Support Bands:**75 +Support Bands: 75 75 76 76 * B1 @H-FDD: 2100MHz 77 77 * B2 @H-FDD: 1900MHz ... ... @@ -91,7 +91,7 @@ 91 91 * B70 @H-FDD: 2000MHz 92 92 * B85 @H-FDD: 700MHz 93 93 94 -(% style="color: blue" %)**Battery:**95 +(% style="color:#037691" %)**Battery:** 95 95 96 96 * Li/SOCI2 un-chargeable battery 97 97 * Capacity: 8500mAh ... ... @@ -99,7 +99,7 @@ 99 99 * Max continuously current: 130mA 100 100 * Max boost current: 2A, 1 second 101 101 102 -(% style="color: blue" %)**Power Consumption**103 +(% style="color:#037691" %)**Power Consumption** 103 103 104 104 * STOP Mode: 10uA @ 3.3v 105 105 * Max transmit power: 350mA@3.3v ... ... @@ -114,6 +114,7 @@ 114 114 * Smart Cities 115 115 * Smart Factory 116 116 118 + 117 117 == 1.5 Sleep mode and working mode == 118 118 119 119 ... ... @@ -122,6 +122,7 @@ 122 122 (% 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. 123 123 124 124 127 + 125 125 == 1.6 Button & LEDs == 126 126 127 127 ... ... @@ -164,6 +164,7 @@ 164 164 [[image:image-20230819104805-5.png]] 165 165 166 166 170 + 167 167 === 1.8.1 Jumper JP2 === 168 168 169 169 ... ... @@ -173,9 +173,9 @@ 173 173 === 1.8.2 BOOT MODE / SW1 === 174 174 175 175 176 - **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.180 +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. 177 177 178 - **2)**(% style="color:blue" %)**Flash**(%%): work mode, device starts to work and send out console output for further debug182 +2) (% style="color:blue" %)**Flash**(%%): work mode, device starts to work and send out console output for further debug 179 179 180 180 181 181 === 1.8.3 Reset Button === ... ... @@ -184,6 +184,7 @@ 184 184 Press to reboot the device. 185 185 186 186 191 + 187 187 == 1.9 Hardware Variant == 188 188 189 189 ... ... @@ -190,7 +190,7 @@ 190 190 (% border="1" cellspacing="5" style="width:410px" %) 191 191 |=(% 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 192 192 |(% style="width:102px" %)((( 193 -S31- NB198 +S31-LB 194 194 )))|(% style="width:126px" %)((( 195 195 (% style="text-align:center" %) 196 196 [[image:image-20230819110632-6.png||height="130" width="104"]] ... ... @@ -202,7 +202,7 @@ 202 202 203 203 ))) 204 204 |(% style="width:102px" %)((( 205 -S31B- NB210 +S31B-LB 206 206 )))|(% style="width:126px" %)((( 207 207 (% style="text-align:center" %) 208 208 [[image:image-20230819110702-7.png||height="164" width="90"]] ... ... @@ -216,6 +216,7 @@ 216 216 217 217 218 218 224 + 219 219 = 2. Use S31-NB to communicate with IoT Server = 220 220 221 221 == 2.1 Send data to IoT server via NB-IoT network == ... ... @@ -232,36 +232,27 @@ 232 232 There are two version: (% style="color:blue" %)**-GE**(%%) and (% style="color:blue" %)**-1D**(%%) version of S31-NB. 233 233 234 234 235 -(% 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 +(% 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. 236 236 237 - *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 +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]]. 238 238 239 - *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 +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]]. 240 240 241 241 Below shows result of different server as a glance. 242 242 249 + 243 243 (% border="1" cellspacing="4" style="width:515px" %) 244 -|(% 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** 245 -|(% 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" %)((( 246 -(% style="text-align:center" %) 247 -[[image:image-20230819113244-8.png||height="183" width="367"]] 248 -)))|(% style="width:170px" %) 249 -|(% 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" %)((( 250 -(% style="text-align:center" %) 251 -[[image:image-20230819113244-9.png||height="119" width="367"]] 252 -)))|(% style="width:170px" %) 251 +|(% style="width:100px;background-color:#4F81BD;color:white" %)**Servers**|(% style="width:300px;background-color:#4F81BD;color:white" %)**Dash Board**|(% style="width:115px;background-color:#4F81BD;color:white" %)**Comments** 252 +|(% 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" %) 253 +|(% 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 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 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 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" %)((( 257 -(% style="text-align:center" %) 258 -[[image:image-20230819113244-10.png||height="104" width="367"]] 259 -)))|(% style="width:170px" %) 260 -|(% 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" %)((( 261 -(% style="text-align:center" %) 262 -[[image:image-20230819113244-11.png||height="141" width="367"]] 263 -)))|(% style="width:170px" %) 257 +|(% 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" %) 258 +|(% 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" %) 259 +|(% style="width:127px" %) |(% style="width:385px" %) |(% style="width:170px" %) 264 264 261 + 265 265 (% 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]]. 266 266 267 267 ... ... @@ -270,49 +270,54 @@ 270 270 271 271 To meet different server requirement, S31-NB supports different payload type. 272 272 273 - **Includes:**270 +Includes: 274 274 275 -* [[General JSON format payload>> ||anchor="H2.2.1GeneralJsonFormat28Type3D529"]]. (Type=5)272 +* [[General JSON format payload>>path:#General_Json]]. (Type=5) 276 276 277 -* [[HEX format Payload>> ||anchor="H2.2.2HEXformatPayload28Type3D029"]]. (Type=0)274 +* [[HEX format Payload>>path:#HEX_Payload]]. (Type=0) 278 278 279 -* [[ThingSpeak Format>> ||anchor="H2.2.4ThingSpeakPayload28Type3D129"]]. (Type=1)276 +* [[ThingSpeak Format>>path:#ThingSpeak_Payload]]. (Type=1) 280 280 281 -* [[ThingsBoard Format>> ||anchor="H2.2.3ThingsBoardPayload28Type3D329"]]. (Type=3)278 +* [[ThingsBoard Format>>path:#ThingsBoard_Payload]]. (Type=3) 282 282 283 283 User can specify the payload type when choose the connection protocol. Example: 284 284 285 -(% style="color:#037691" %)**AT+PRO=2,0** (%%) ~/~/ 282 +(% style="color:#037691" %)**AT+PRO=2,0** (%%) ~/~/Use UDP Connection & hex Payload 286 286 287 287 (% style="color:#037691" %)**AT+PRO=2,5** (%%) ~/~/ Use UDP Connection & Json Payload 288 288 289 -(% style="color:#037691" %)**AT+PRO=3,5 ** (%%) 286 +(% style="color:#037691" %)**AT+PRO=3,5 ** (%%) ~/~/ Use MQTT Connection & Json Payload 290 290 291 291 292 -=== 2.2.1 General Json Format(Type ~=5) ===289 +=== 2.2.1 General Json Format (Type=5) === 293 293 294 294 295 295 This is the General Json Format. As below: 296 296 294 + 297 297 (% 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}}** 298 298 299 299 300 -(% style="color:red" %)**Notice, from above payload:** 301 301 299 +(% style="color:red" %)Notice, from above payload: 300 + 302 302 * Temperature , Humidity , Battery & Signal are the value at uplink time. 303 303 304 304 * 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. 305 305 306 -=== 2.2.2 HEX format Payload(Type~=0) === 307 307 308 308 307 +=== 2.2.2 HEX format Payload(Type=0) === 308 + 309 + 309 309 This is the HEX Format. As below: 310 310 311 311 (% style="color:#4472c4" %)**f86620705346276200640cba16010000000011011801e864d49c2d011a01e364d49925011901eb64d49871011901e564d497bd011a01e664d49709011901e964d49655011a01e864d495a1011a01e864d494ed011801e864d49439** 312 312 313 -[[image:1692424009971-458.png]] 314 314 315 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image001.png]] 315 315 317 + 316 316 (% style="color:blue" %)**Version:** 317 317 318 318 These bytes include the hardware and software version. ... ... @@ -322,7 +322,7 @@ 322 322 (% style="color:#037691" %)**Lower byte:**(%%) Specify the software version: 0x64=100, means firmware version 100 323 323 324 324 325 -(% style="color: blue" %)**BAT (Battery Info):**327 +(% style="color:#037691" %)**BAT (Battery Info):** 326 326 327 327 Ex1: 0x0CBA = 3258mV 328 328 ... ... @@ -350,9 +350,10 @@ 350 350 351 351 If payload is: FF3FH : (FF3F & 8000 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees. 352 352 353 -(FF3F & 8000 :Judge whether the highest bit is 1, when the highest bit is 1, it is negative)355 +(FF3F & 8000:Judge whether the highest bit is 1, when the highest bit is 1, it is negative) 354 354 355 355 358 + 356 356 (% style="color:blue" %)**Humidity: ** 357 357 358 358 Read:0295(H)=661(D) Value: 661 / 10=66.1, So 66.1% ... ... @@ -365,15 +365,16 @@ 365 365 Put the decimal value into this link(https:~/~/www.epochconverter.com/) to get the time. 366 366 367 367 368 -=== 2.2.3 ThingsBoard Payload(Type ~=3) ===371 +=== 2.2.3 ThingsBoard Payload(Type=3) === 369 369 370 370 371 371 Type3 payload special design for ThingsBoard, it will also configure other default server to ThingsBoard. 372 372 376 + 373 373 (% style="color:#4472c4" %)**{"IMEI":866207053462762,"temperature":29.2,"humidity":54.2,"battery":3.27,"signal":24}** 374 374 375 375 376 -=== 2.2.4 ThingSpeak Payload(Type ~=1) ===380 +=== 2.2.4 ThingSpeak Payload(Type=1) === 377 377 378 378 379 379 This payload meets ThingSpeak platform requirement. It includes only four fields. Form 1~~4 are: ... ... @@ -380,6 +380,7 @@ 380 380 381 381 Temperature, Humidity, Battery & Signal. This payload type only valid for ThingsSpeak Platform 382 382 387 + 383 383 As below: 384 384 385 385 (% style="color:#4472c4" %)**field1=27.9&field2=49.9&field3=3.23&field4=28** ... ... @@ -390,25 +390,29 @@ 390 390 391 391 By default, Sensor will send uplinks (% style="color:blue" %)**every 2 hours**(%%) & AT+NOUD=8 392 392 398 + 393 393 User can use below commands to change the (% style="color:blue" %)**uplink interval**. 394 394 395 -(% style="color:#037691" %)**AT+TDC=600 ** (%%) ~/~/ Set Update Interval to 600s 401 +(% style="color:#037691" %)** AT+TDC=600 ** (%%) ~/~/ Set Update Interval to 600s 396 396 403 + 397 397 User can also push the button for more than 1 seconds to activate an uplink. 398 398 399 399 407 + 408 + 400 400 == 2.4 Multi-Samplings and One uplink == 401 401 402 402 403 403 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: 404 404 405 -* (% style="color:#037691" %)**AT+TR=900** (%%) 414 +* (% 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) 406 406 407 -* (% style="color:#037691" %)**AT+NOUD=8** 416 +* (% 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. 408 408 409 409 The diagram below explains the relationship between TR, NOUD, and TDC more clearly: 410 410 411 -[[image: 1692424376354-959.png]]420 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image001.png||alt="IMG_256"]] 412 412 413 413 414 414 == 2.5 Humidity and Temperature alarm function == ... ... @@ -421,12 +421,12 @@ 421 421 422 422 (% style="color:#037691" %)**AT+ SHHUM=min,max** 423 423 424 -Example: AT+ SHHUM=50,80 433 +Example: AT+ SHHUM=50,80 ~/~/ Alarm when humidity lower than 50 or higher than 80. 425 425 426 426 427 427 (% style="color:#037691" %)**AT+ SHTEMP=min,max** 428 428 429 -Example: AT+ SHTEMP=20,30 438 +Example: AT+ SHTEMP=20,30 ~/~/ Alarm when temperature lower than 20 or higher than 30 430 430 431 431 432 432 (% style="color:red" %)**Notice:** ... ... @@ -435,6 +435,10 @@ 435 435 436 436 * 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.** 437 437 447 + 448 + 449 + 450 + 438 438 == 2.6 Trggier an uplink by external interrupt == 439 439 440 440 ... ... @@ -442,16 +442,19 @@ 442 442 443 443 (% style="color:blue" %)**AT command:** 444 444 445 -* (% style="color:#037691" %)**AT+INTMOD **(%%) 458 +* (% style="color:#037691" %)**AT+INTMOD **(%%) ~/~/ Set the trigger interrupt mode 446 446 447 -* (% style="color:#037691" %)**AT+INTMOD=0 **(%%) ~/~/ 460 +* (% style="color:#037691" %)**AT+INTMOD=0 **(%%) ~/~/Disable Interrupt 448 448 449 -* (% style="color:#037691" %)**AT+INTMOD=1 **(%%) 462 +* (% style="color:#037691" %)**AT+INTMOD=1 **(%%) ~/~/Trigger by rising and falling edge 450 450 451 -* (% style="color:#037691" %)**AT+INTMOD=2 **(%%) 464 +* (% style="color:#037691" %)**AT+INTMOD=2 **(%%) ~/~/Trigger by falling edge 452 452 453 -* (% style="color:#037691" %)**AT+INTMOD=3 **(%%) ~/~/ 466 +* (% style="color:#037691" %)**AT+INTMOD=3 **(%%) ~/~/Trigger by rising edge 454 454 468 + 469 + 470 + 455 455 = 3. Configure S31x-NB = 456 456 457 457 == 3.1 Configure Methods == ... ... @@ -463,153 +463,271 @@ 463 463 464 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]]. 465 465 466 - ==3.2ATCommands Set==482 +* LoRaWAN Downlink. Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section. 467 467 468 468 469 -AT+<CMD>? : Help on <CMD> 470 470 471 -AT+<CMD> : Run <CMD> 472 472 473 - AT+<CMD>=<value>: Set thevalue487 +== 3.2 General Commands == 474 474 475 -AT+<CMD>=? : Get the value 476 476 490 +These commands are to configure: 477 477 478 -(% style="color:blue" %)**General Commands** 492 +* General system settings like: uplink interval. 493 +* LoRaWAN protocol & radio related command. 479 479 480 - AT:Attention495 +They are same for all Dragino Devices which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki: 481 481 482 -AT ? : ShortHelp497 +[[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/]] 483 483 484 -ATZ : MCU Reset 485 485 486 - AT+TDC: Application DataTransmissionInterval500 +== 3.3 Commands special design for S31x-LB == 487 487 488 -AT+CFG : Print all configurations 489 489 490 - AT+CFGMOD: Workingmodeselection503 +These commands only valid for S31x-LB, as below: 491 491 492 -AT+DEUI : Get or set the Device ID 493 493 494 - AT+INTMOD:Setthe triggerinterruptmode506 +=== 3.3.1 Set Transmit Interval Time === 495 495 496 -AT+5VT : Set extend the time of 5V power 497 497 498 - AT+PRO: Chooseagreement509 +Feature: Change LoRaWAN End Node Transmit Interval. 499 499 500 - AT+RXDL: Extend thesendingandreceiving time511 +(% style="color:blue" %)**AT Command: AT+TDC** 501 501 502 -AT+DNSCFG : Get or Set DNS Server 513 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 514 +|=(% 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** 515 +|(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|((( 516 +30000 517 +OK 518 +the interval is 30000ms = 30s 519 +))) 520 +|(% style="width:156px" %)AT+TDC=60000|(% style="width:137px" %)Set Transmit Interval|((( 521 +OK 522 +Set transmit interval to 60000ms = 60 seconds 523 +))) 503 503 504 - AT+GETSENSORVALUE: Returnsheurrentsensormeasurement525 +(% style="color:blue" %)**Downlink Command: 0x01** 505 505 506 - AT+NOUD:GetorSetthenumberofdatato beuploaded527 +Format: Command Code (0x01) followed by 3 bytes time value. 507 507 508 - AT+CDP: ReadorClearcacheddata529 +If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01. 509 509 510 -AT+SHTEMP: Get or Set alarm of temp 531 +* Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds 532 +* Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 511 511 512 - AT+SHHUM:GetorSetlarm of moisture534 +=== 3.3.2 Get Device Status === 513 513 514 -AT+SERVADDR : Server Address 515 515 537 +Send a LoRaWAN downlink to ask device send Alarm settings. 516 516 517 -(% style="color:blue" %)** UDPManagement**539 +(% style="color:blue" %)**Downlink Payload: **(%%)0x26 01 518 518 519 - AT+CFM:Uploadconfirmationmode(only valid forUDP)541 +Sensor will upload Device Status via FPORT=5. See payload section for detail. 520 520 521 521 522 - (%style="color:blue"%)**MQTT Management**544 +=== 3.3.3 Set Temperature Alarm Threshold === 523 523 524 -AT+CLIENT : Get or Set MQTT client 525 525 526 - AT+UNAME:GetSetMQTTUsername547 +* (% style="color:blue" %)**AT Command:** 527 527 528 - AT+PWD: Getet MQTT password549 +(% style="color:#037691" %)**AT+SHTEMP=min,max** 529 529 530 -AT+PUBTOPIC : Get or Set MQTT publish topic 551 +* When min=0, and max≠0, Alarm higher than max 552 +* When min≠0, and max=0, Alarm lower than min 553 +* When min≠0 and max≠0, Alarm higher than max or lower than min 531 531 532 - AT+SUBTOPIC : Get or Set MQTT subscription topic555 +Example: 533 533 557 + AT+SHTEMP=0,30 ~/~/ Alarm when temperature higher than 30. 534 534 535 -(% style="color:blue" %)** Information**559 +* (% style="color:blue" %)**Downlink Payload:** 536 536 537 - AT+FDR: Factory Data Reset561 +(% style="color:#037691" %)**0x(0C 01 00 1E)** (%%) ~/~/ Set AT+SHTEMP=0,30 538 538 539 - AT+PWORD:SerialAccessPassword563 +(% style="color:red" %)**(note: 3^^rd^^ byte= 0x00 for low limit(not set), 4^^th^^ byte = 0x1E for high limit: 30)** 540 540 541 -AT+LDATA : Get the last upload data 542 542 543 - AT+CDP: Reador Clearcacheddata566 +=== 3.3.4 Set Humidity Alarm Threshold === 544 544 545 545 569 +* (% style="color:blue" %)**AT Command:** 570 + 571 +(% style="color:#037691" %)**AT+SHHUM=min,max** 572 + 573 +* When min=0, and max≠0, Alarm higher than max 574 +* When min≠0, and max=0, Alarm lower than min 575 +* When min≠0 and max≠0, Alarm higher than max or lower than min 576 + 577 +Example: 578 + 579 + AT+SHHUM=70,0 ~/~/ Alarm when humidity lower than 70%. 580 + 581 +* (% style="color:blue" %)**Downlink Payload:** 582 + 583 +(% style="color:#037691" %)**0x(0C 02 46 00)**(%%) ~/~/ Set AT+SHTHUM=70,0 584 + 585 +(% style="color:red" %)**(note: 3^^rd^^ byte= 0x46 for low limit (70%), 4^^th^^ byte = 0x00 for high limit (not set))** 586 + 587 + 588 +=== 3.3.5 Set Alarm Interval === 589 + 590 + 591 +The shortest time of two Alarm packet. (unit: min) 592 + 593 +* (% style="color:blue" %)**AT Command:** 594 + 595 +(% 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. 596 + 597 +* (% style="color:blue" %)**Downlink Payload:** 598 + 599 +(% style="color:#037691" %)**0x(0D 00 1E)**(%%) **~-~--> ** Set AT+ATDC=0x 00 1E = 30 minutes 600 + 601 + 602 +=== 3.3.6 Get Alarm settings === 603 + 604 + 605 +Send a LoRaWAN downlink to ask device send Alarm settings. 606 + 607 +* (% style="color:#037691" %)**Downlink Payload: **(%%)0x0E 01 608 + 609 +**Example:** 610 + 611 +[[image:image-20230524110211-4.png]] 612 + 613 +**Explain:** 614 + 615 +* Alarm & MOD bit is 0x7C, 0x7C >> 2 = 0x31: Means this message is the Alarm settings message. 616 + 617 +=== 3.3.7 Set Interrupt Mode === 618 + 619 + 620 +Feature, Set Interrupt mode for PA8 of pin. 621 + 622 +When AT+INTMOD=0 is set, PA8 is used as a digital input port. 623 + 624 +(% style="color:blue" %)**AT Command: AT+INTMOD** 625 + 626 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 627 +|=(% 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** 628 +|(% style="width:154px" %)AT+INTMOD=?|(% style="width:196px" %)Show current interrupt mode|(% style="width:157px" %)((( 629 +0 630 +OK 631 +the mode is 0 =Disable Interrupt 632 +))) 633 +|(% style="width:154px" %)AT+INTMOD=2|(% style="width:196px" %)((( 634 +Set Transmit Interval 635 +0. (Disable Interrupt), 636 +~1. (Trigger by rising and falling edge) 637 +2. (Trigger by falling edge) 638 +3. (Trigger by rising edge) 639 +)))|(% style="width:157px" %)OK 640 + 641 +(% style="color:blue" %)**Downlink Command: 0x06** 642 + 643 +Format: Command Code (0x06) followed by 3 bytes. 644 + 645 +This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06. 646 + 647 +* Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode 648 +* Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 649 + 650 +=== 3.3.8 Set Power Output Duration === 651 + 652 + 653 +Control the output duration 5V . Before each sampling, device will 654 + 655 +~1. first enable the power output to external sensor, 656 + 657 +2. keep it on as per duration, read sensor value and construct uplink payload 658 + 659 +3. final, close the power output. 660 + 661 +(% style="color:blue" %)**AT Command: AT+5VT** 662 + 663 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 664 +|=(% 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** 665 +|(% style="width:154px" %)AT+5VT=?|(% style="width:196px" %)Show 5V open time.|(% style="width:157px" %)0 (default) 666 +OK 667 +|(% style="width:154px" %)AT+5VT=1000|(% style="width:196px" %)Close after a delay of 1000 milliseconds.|(% style="width:157px" %)OK 668 + 669 +(% style="color:blue" %)**Downlink Command: 0x07** 670 + 671 +Format: Command Code (0x07) followed by 2 bytes. 672 + 673 +The first and second bytes are the time to turn on. 674 + 675 +* Example 1: Downlink Payload: 070000 **~-~-->** AT+5VT=0 676 +* Example 2: Downlink Payload: 0701F4 **~-~-->** AT+5VT=500 677 + 546 546 = 4. Battery & Power Consumption = 547 547 548 548 549 -S31x- NB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.681 +S31x-LB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace. 550 550 551 551 [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] . 552 552 553 553 554 -= 5. Firmware update = 686 += 5. OTA Firmware update = 555 555 556 556 557 -User can change device firmware to:: 689 +(% class="wikigeneratedid" %) 690 +User can change firmware S31x-LB to: 558 558 692 +* Change Frequency band/ region. 559 559 * Update with new features. 560 - 561 561 * Fix bugs. 562 562 563 -Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/f hb3uyl4gt6clru/AAAiZVTFcxrfE1JOOyfcgO9ha?dl=0]]**696 +Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/fis3g6nmhv0eokg/AAC6BcCZaX4BdqZkduUvZ3jIa?dl=0]]** 564 564 698 + 565 565 Methods to Update Firmware: 566 566 567 -* (Recommended way) OTA firmware update via BLE: [[**Instruction**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/BLE_Firmware_Update_NB_Sensors_BC660K-GL/]]. 568 - 701 +* (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/]]** 569 569 * 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]]**. 570 570 571 571 = 6. FAQ = 572 572 573 -== 6.1 How can I access t BC660K-GL AT Commands? == 574 574 575 575 576 - Usercanaccess to BC660K-GL directly andsendAT Commands.708 += 7. Order Info = 577 577 578 -[[See BC660K-GL AT Command set>>url:https://www.dropbox.com/sh/5f6ssda5fum8rvs/AABT68l8ZzWOvZ5eg2qwOoFda?dl=0]] 579 579 711 +Part Number: (% style="color:blue" %)**S31-LB-XX / S31B-LB-XX** 580 580 581 -= 7.OrderInfo=713 +(% style="color:red" %)**XX**(%%): The default frequency band 582 582 715 +* (% style="color:red" %)**AS923**(%%): LoRaWAN AS923 band 583 583 584 - PartNumber:(% style="color:blue" %)**S31-NB-XX/ S31B-NB-XX**717 +* (% style="color:red" %)**AU915**(%%): LoRaWAN AU915 band 585 585 586 -(% style="color:red" %)** XX**(%%):719 +* (% style="color:red" %)**EU433**(%%): LoRaWAN EU433 band 587 587 588 -* (% style="color: #037691" %)**GE**(%%):Generalversion (ExcludeSIM card)721 +* (% style="color:red" %)**EU868**(%%): LoRaWAN EU868 band 589 589 590 -* (% style="color: #037691" %)**1D**(%%):with 1NCE*10years 500MB SIM card andPre-configure to DataCake server723 +* (% style="color:red" %)**KR920**(%%): LoRaWAN KR920 band 591 591 592 -(% style="color: #037691" %)**1NCESIM Card NB-IoT network coverage**(%%):Austria, Belgium, Bulgaria, Croatia, Czech Republic, Denmark, Finland, Germany, Great Britain, Greece, Hungary, Ireland, Italy,Latvia, Malta, Netherlands, Norway, PuertoRico, Russia, Slovak , Republic, Slovenia, Spain, Sweden, Switzerland, Taiwan, USA,USVirgin Islands725 +* (% style="color:red" %)**US915**(%%): LoRaWAN US915 band 593 593 727 +* (% style="color:red" %)**IN865**(%%): LoRaWAN IN865 band 594 594 729 +* (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band 730 + 595 595 = 8. Packing Info = 596 596 597 597 598 598 (% style="color:#037691" %)**Package Includes**: 599 599 600 -* S31- NB or S31-NBNB-IoT SensorNode x 1736 +* S31x-LB LoRaWAN Temperature & Humidity Sensor 601 601 602 -* External antenna x 1 603 - 604 604 (% style="color:#037691" %)**Dimension and weight**: 605 605 606 -* Device Size: 13.0 x 5 x 4.5cm740 +* Device Size: cm 607 607 608 -* Device Weight: 150g742 +* Device Weight: g 609 609 610 -* Package Size / pcs : 14.0 x 8x 5cm744 +* Package Size / pcs : cm 611 611 612 -* Weight / pcs : 180g746 +* Weight / pcs : g 613 613 614 614 = 9. Support = 615 615 ... ... @@ -618,4 +618,5 @@ 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 755 + 621 621 (% style="display:none" %) (%%)
- 1692424376354-959.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -146.1 KB - Content
- image-20230911134259-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -236.5 KB - Content
- image-20230911140426-2.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -121.6 KB - Content