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,41 +13,35 @@ 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 -The Dragino DDS20-NBisaUltrasonicliquidlevel sensor**s **none-contact method**to measure the**heightofliquid**containerwithoutopening thecontainer, andsendIoTplatformvia NB-IoT network.20 +The Dragino S31-NB and S31B-NB are (% style="color:blue" %)**NB-IoT Temperature and Humidity Sensor**(%%) for Internet of Things solution. It is used to measure the surrounding (% style="color:blue" %)**environment temperature and relative air humidity precisely**(%%), and then upload to IoT server via NB-IoT network*. 20 20 21 -The DDS20-NBsensoris installeddirectlybelowthecontainertodetecttheheight oftheliquidlevel.Userdoesn'tneedtoopenaholeonhecontainertobetested.Thenone-contactmeasurementmakesthemeasurementfety,easier andpossibleforsomestrictsituation.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. 22 22 23 - DDS20-NBuses **ultrasonicsensing technology** fordistancemeasurement.DDS20-NBisof high accuracy tomeasure variousliquidsuchas: **toxicsubstances**,strongacids**, **strongalkalis**and **variouspureliquids** in high-temperatureandhigh-pressureairtightcontainers.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 - PS-NB-NAsupportsdifferentuplinkmethods including**MQTT,MQTTs,UDP& TCP** fordifferentapplicationrequirement,andsupportuplinkstovariousIoTServers.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). 26 26 27 - PS-NB-NA**supportsBLE configure**and** OTA update** which makeusereasytouse.28 +*make sure you have NB-IoT coverage locally. 28 28 29 -PS-NB-NA is powered by **8500mAh Li-SOCI2 battery**, it is designed for long-term use up to severa years. 30 30 31 - PS-NB-NA has optional built-in SIM card and default IoT server connection version. Whichmakes it works with simple configuration.31 +[[image:1692411831805-116.png]] 32 32 33 33 34 -[[image:image-20230911140426-2.png||height="320" width="951"]] 35 - 36 - 37 37 == 1.2 Features == 38 38 39 39 40 40 * NB-IoT Bands: B1/B2/B3/B4/B5/B8/B12/B13/B17/B18/B19/B20/B25/B28/B66/B70/B85 @H-FDD 41 41 * Ultra-low power consumption 42 -* Liquid Level Measurement by Ultrasonic technology 43 -* Measure through container, No need to contact Liquid 44 -* Valid level range 20mm - 2000mm 45 -* Accuracy: ±(5mm+S*0.5%) (S: Measure Value) 39 +* External 3 meters SHT31 probe (For S31-NB) 40 +* Measure range -40°C ~~ 85°C 41 +* Temperature & Humidity alarm 46 46 * Multiply Sampling and one uplink 47 47 * Support Bluetooth v5.1 remote configure and update firmware 48 48 * Uplink on periodically 49 49 * Downlink to change configure 50 -* IP66 Waterproof Enclosure 51 51 * 8500mAh Battery for long term use 52 52 * Nano SIM card slot for NB-IoT SIM 53 53 ... ... @@ -54,17 +54,31 @@ 54 54 == 1.3 Specification == 55 55 56 56 57 -(% style="color: blue" %)**Common DC Characteristics:**52 +(% style="color:#037691" %)**Common DC Characteristics:** 58 58 59 -* Supply Voltage: 2. 5v ~~ 3.6v54 +* Supply Voltage: 2.1v ~~ 3.6v 60 60 * Operating Temperature: -40 ~~ 85°C 61 61 62 -(% style="color: blue" %)**NB-IoT Spec:**57 +(% style="color:#037691" %)**Temperature Sensor:** 63 63 64 -(% style="color:#037691" %)**NB-IoT Module: BC660K-GL** 59 +* Range: -40 to + 80°C 60 +* Accuracy: ±0.2 @ 0-90 °C 61 +* Resolution: 0.1°C 62 +* Long Term Shift: <0.03 °C/yr 65 65 66 -(% style="color:#037691" %)** SupportBands:**64 +(% style="color:#037691" %)**Humidity Sensor: ** 67 67 66 +* Range: 0 ~~ 99.9% RH 67 +* Accuracy: ± 2%RH ( 0 ~~ 100%RH) 68 +* Resolution: 0.01% RH 69 +* Long Term Shift: <0.25 %RH/yr 70 + 71 +(% style="color:#037691" %)**NB-IoT Spec:** 72 + 73 +**NB-IoT Module: BC660K-GL** 74 + 75 +Support Bands: 76 + 68 68 * B1 @H-FDD: 2100MHz 69 69 * B2 @H-FDD: 1900MHz 70 70 * B3 @H-FDD: 1800MHz ... ... @@ -83,7 +83,7 @@ 83 83 * B70 @H-FDD: 2000MHz 84 84 * B85 @H-FDD: 700MHz 85 85 86 -(% style="color: blue" %)**Battery:**95 +(% style="color:#037691" %)**Battery:** 87 87 88 88 * Li/SOCI2 un-chargeable battery 89 89 * Capacity: 8500mAh ... ... @@ -91,7 +91,7 @@ 91 91 * Max continuously current: 130mA 92 92 * Max boost current: 2A, 1 second 93 93 94 -(% style="color: blue" %)**Power Consumption**103 +(% style="color:#037691" %)**Power Consumption** 95 95 96 96 * STOP Mode: 10uA @ 3.3v 97 97 * Max transmit power: 350mA@3.3v ... ... @@ -106,6 +106,7 @@ 106 106 * Smart Cities 107 107 * Smart Factory 108 108 118 + 109 109 == 1.5 Sleep mode and working mode == 110 110 111 111 ... ... @@ -114,6 +114,7 @@ 114 114 (% 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. 115 115 116 116 127 + 117 117 == 1.6 Button & LEDs == 118 118 119 119 ... ... @@ -156,6 +156,7 @@ 156 156 [[image:image-20230819104805-5.png]] 157 157 158 158 170 + 159 159 === 1.8.1 Jumper JP2 === 160 160 161 161 ... ... @@ -165,9 +165,9 @@ 165 165 === 1.8.2 BOOT MODE / SW1 === 166 166 167 167 168 - **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. 169 169 170 - **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 171 171 172 172 173 173 === 1.8.3 Reset Button === ... ... @@ -176,6 +176,7 @@ 176 176 Press to reboot the device. 177 177 178 178 191 + 179 179 == 1.9 Hardware Variant == 180 180 181 181 ... ... @@ -182,7 +182,7 @@ 182 182 (% border="1" cellspacing="5" style="width:410px" %) 183 183 |=(% 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 184 184 |(% style="width:102px" %)((( 185 -S31- NB198 +S31-LB 186 186 )))|(% style="width:126px" %)((( 187 187 (% style="text-align:center" %) 188 188 [[image:image-20230819110632-6.png||height="130" width="104"]] ... ... @@ -194,7 +194,7 @@ 194 194 195 195 ))) 196 196 |(% style="width:102px" %)((( 197 -S31B- NB210 +S31B-LB 198 198 )))|(% style="width:126px" %)((( 199 199 (% style="text-align:center" %) 200 200 [[image:image-20230819110702-7.png||height="164" width="90"]] ... ... @@ -208,6 +208,7 @@ 208 208 209 209 210 210 224 + 211 211 = 2. Use S31-NB to communicate with IoT Server = 212 212 213 213 == 2.1 Send data to IoT server via NB-IoT network == ... ... @@ -224,36 +224,27 @@ 224 224 There are two version: (% style="color:blue" %)**-GE**(%%) and (% style="color:blue" %)**-1D**(%%) version of S31-NB. 225 225 226 226 227 -(% 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. 228 228 229 - *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]]. 230 230 231 - *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]]. 232 232 233 233 Below shows result of different server as a glance. 234 234 249 + 235 235 (% border="1" cellspacing="4" style="width:515px" %) 236 -|(% 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** 237 -|(% 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" %)((( 238 -(% style="text-align:center" %) 239 -[[image:image-20230819113244-8.png||height="183" width="367"]] 240 -)))|(% style="width:170px" %) 241 -|(% 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" %)((( 242 -(% style="text-align:center" %) 243 -[[image:image-20230819113244-9.png||height="119" width="367"]] 244 -)))|(% 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" %) 245 245 |(% 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" %) 246 246 |(% 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" %) 247 247 |(% 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" %) 248 -|(% 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" %)((( 249 -(% style="text-align:center" %) 250 -[[image:image-20230819113244-10.png||height="104" width="367"]] 251 -)))|(% style="width:170px" %) 252 -|(% 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" %)((( 253 -(% style="text-align:center" %) 254 -[[image:image-20230819113244-11.png||height="141" width="367"]] 255 -)))|(% 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" %) 256 256 261 + 257 257 (% 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]]. 258 258 259 259 ... ... @@ -262,49 +262,54 @@ 262 262 263 263 To meet different server requirement, S31-NB supports different payload type. 264 264 265 - **Includes:**270 +Includes: 266 266 267 -* [[General JSON format payload>> ||anchor="H2.2.1GeneralJsonFormat28Type3D529"]]. (Type=5)272 +* [[General JSON format payload>>path:#General_Json]]. (Type=5) 268 268 269 -* [[HEX format Payload>> ||anchor="H2.2.2HEXformatPayload28Type3D029"]]. (Type=0)274 +* [[HEX format Payload>>path:#HEX_Payload]]. (Type=0) 270 270 271 -* [[ThingSpeak Format>> ||anchor="H2.2.4ThingSpeakPayload28Type3D129"]]. (Type=1)276 +* [[ThingSpeak Format>>path:#ThingSpeak_Payload]]. (Type=1) 272 272 273 -* [[ThingsBoard Format>> ||anchor="H2.2.3ThingsBoardPayload28Type3D329"]]. (Type=3)278 +* [[ThingsBoard Format>>path:#ThingsBoard_Payload]]. (Type=3) 274 274 275 275 User can specify the payload type when choose the connection protocol. Example: 276 276 277 -(% style="color:#037691" %)**AT+PRO=2,0** (%%) ~/~/ 282 +(% style="color:#037691" %)**AT+PRO=2,0** (%%) ~/~/Use UDP Connection & hex Payload 278 278 279 279 (% style="color:#037691" %)**AT+PRO=2,5** (%%) ~/~/ Use UDP Connection & Json Payload 280 280 281 -(% style="color:#037691" %)**AT+PRO=3,5 ** (%%) 286 +(% style="color:#037691" %)**AT+PRO=3,5 ** (%%) ~/~/ Use MQTT Connection & Json Payload 282 282 283 283 284 -=== 2.2.1 General Json Format(Type ~=5) ===289 +=== 2.2.1 General Json Format (Type=5) === 285 285 286 286 287 287 This is the General Json Format. As below: 288 288 294 + 289 289 (% 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}}** 290 290 291 291 292 -(% style="color:red" %)**Notice, from above payload:** 293 293 299 +(% style="color:red" %)Notice, from above payload: 300 + 294 294 * Temperature , Humidity , Battery & Signal are the value at uplink time. 295 295 296 296 * 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. 297 297 298 -=== 2.2.2 HEX format Payload(Type~=0) === 299 299 300 300 307 +=== 2.2.2 HEX format Payload(Type=0) === 308 + 309 + 301 301 This is the HEX Format. As below: 302 302 303 303 (% style="color:#4472c4" %)**f86620705346276200640cba16010000000011011801e864d49c2d011a01e364d49925011901eb64d49871011901e564d497bd011a01e664d49709011901e964d49655011a01e864d495a1011a01e864d494ed011801e864d49439** 304 304 305 -[[image:1692424009971-458.png]] 306 306 315 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image001.png]] 307 307 317 + 308 308 (% style="color:blue" %)**Version:** 309 309 310 310 These bytes include the hardware and software version. ... ... @@ -314,7 +314,7 @@ 314 314 (% style="color:#037691" %)**Lower byte:**(%%) Specify the software version: 0x64=100, means firmware version 100 315 315 316 316 317 -(% style="color: blue" %)**BAT (Battery Info):**327 +(% style="color:#037691" %)**BAT (Battery Info):** 318 318 319 319 Ex1: 0x0CBA = 3258mV 320 320 ... ... @@ -342,9 +342,10 @@ 342 342 343 343 If payload is: FF3FH : (FF3F & 8000 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees. 344 344 345 -(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) 346 346 347 347 358 + 348 348 (% style="color:blue" %)**Humidity: ** 349 349 350 350 Read:0295(H)=661(D) Value: 661 / 10=66.1, So 66.1% ... ... @@ -357,15 +357,16 @@ 357 357 Put the decimal value into this link(https:~/~/www.epochconverter.com/) to get the time. 358 358 359 359 360 -=== 2.2.3 ThingsBoard Payload(Type ~=3) ===371 +=== 2.2.3 ThingsBoard Payload(Type=3) === 361 361 362 362 363 363 Type3 payload special design for ThingsBoard, it will also configure other default server to ThingsBoard. 364 364 376 + 365 365 (% style="color:#4472c4" %)**{"IMEI":866207053462762,"temperature":29.2,"humidity":54.2,"battery":3.27,"signal":24}** 366 366 367 367 368 -=== 2.2.4 ThingSpeak Payload(Type ~=1) ===380 +=== 2.2.4 ThingSpeak Payload(Type=1) === 369 369 370 370 371 371 This payload meets ThingSpeak platform requirement. It includes only four fields. Form 1~~4 are: ... ... @@ -372,6 +372,7 @@ 372 372 373 373 Temperature, Humidity, Battery & Signal. This payload type only valid for ThingsSpeak Platform 374 374 387 + 375 375 As below: 376 376 377 377 (% style="color:#4472c4" %)**field1=27.9&field2=49.9&field3=3.23&field4=28** ... ... @@ -382,25 +382,29 @@ 382 382 383 383 By default, Sensor will send uplinks (% style="color:blue" %)**every 2 hours**(%%) & AT+NOUD=8 384 384 398 + 385 385 User can use below commands to change the (% style="color:blue" %)**uplink interval**. 386 386 387 -(% style="color:#037691" %)**AT+TDC=600 ** (%%) ~/~/ Set Update Interval to 600s 401 +(% style="color:#037691" %)** AT+TDC=600 ** (%%) ~/~/ Set Update Interval to 600s 388 388 403 + 389 389 User can also push the button for more than 1 seconds to activate an uplink. 390 390 391 391 407 + 408 + 392 392 == 2.4 Multi-Samplings and One uplink == 393 393 394 394 395 395 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: 396 396 397 -* (% 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) 398 398 399 -* (% 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. 400 400 401 401 The diagram below explains the relationship between TR, NOUD, and TDC more clearly: 402 402 403 -[[image: 1692424376354-959.png]]420 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image001.png||alt="IMG_256"]] 404 404 405 405 406 406 == 2.5 Humidity and Temperature alarm function == ... ... @@ -413,12 +413,12 @@ 413 413 414 414 (% style="color:#037691" %)**AT+ SHHUM=min,max** 415 415 416 -Example: AT+ SHHUM=50,80 433 +Example: AT+ SHHUM=50,80 ~/~/ Alarm when humidity lower than 50 or higher than 80. 417 417 418 418 419 419 (% style="color:#037691" %)**AT+ SHTEMP=min,max** 420 420 421 -Example: AT+ SHTEMP=20,30 438 +Example: AT+ SHTEMP=20,30 ~/~/ Alarm when temperature lower than 20 or higher than 30 422 422 423 423 424 424 (% style="color:red" %)**Notice:** ... ... @@ -427,6 +427,10 @@ 427 427 428 428 * 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.** 429 429 447 + 448 + 449 + 450 + 430 430 == 2.6 Trggier an uplink by external interrupt == 431 431 432 432 ... ... @@ -434,16 +434,19 @@ 434 434 435 435 (% style="color:blue" %)**AT command:** 436 436 437 -* (% style="color:#037691" %)**AT+INTMOD **(%%) 458 +* (% style="color:#037691" %)**AT+INTMOD **(%%) ~/~/ Set the trigger interrupt mode 438 438 439 -* (% style="color:#037691" %)**AT+INTMOD=0 **(%%) ~/~/ 460 +* (% style="color:#037691" %)**AT+INTMOD=0 **(%%) ~/~/Disable Interrupt 440 440 441 -* (% style="color:#037691" %)**AT+INTMOD=1 **(%%) 462 +* (% style="color:#037691" %)**AT+INTMOD=1 **(%%) ~/~/Trigger by rising and falling edge 442 442 443 -* (% style="color:#037691" %)**AT+INTMOD=2 **(%%) 464 +* (% style="color:#037691" %)**AT+INTMOD=2 **(%%) ~/~/Trigger by falling edge 444 444 445 -* (% style="color:#037691" %)**AT+INTMOD=3 **(%%) ~/~/ 466 +* (% style="color:#037691" %)**AT+INTMOD=3 **(%%) ~/~/Trigger by rising edge 446 446 468 + 469 + 470 + 447 447 = 3. Configure S31x-NB = 448 448 449 449 == 3.1 Configure Methods == ... ... @@ -455,153 +455,271 @@ 455 455 456 456 * 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]]. 457 457 458 - ==3.2ATCommands Set==482 +* LoRaWAN Downlink. Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section. 459 459 460 460 461 -AT+<CMD>? : Help on <CMD> 462 462 463 -AT+<CMD> : Run <CMD> 464 464 465 - AT+<CMD>=<value>: Set thevalue487 +== 3.2 General Commands == 466 466 467 -AT+<CMD>=? : Get the value 468 468 490 +These commands are to configure: 469 469 470 -(% style="color:blue" %)**General Commands** 492 +* General system settings like: uplink interval. 493 +* LoRaWAN protocol & radio related command. 471 471 472 - AT:Attention495 +They are same for all Dragino Devices which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki: 473 473 474 -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/]] 475 475 476 -ATZ : MCU Reset 477 477 478 - AT+TDC: Application DataTransmissionInterval500 +== 3.3 Commands special design for S31x-LB == 479 479 480 -AT+CFG : Print all configurations 481 481 482 - AT+CFGMOD: Workingmodeselection503 +These commands only valid for S31x-LB, as below: 483 483 484 -AT+DEUI : Get or set the Device ID 485 485 486 - AT+INTMOD:Setthe triggerinterruptmode506 +=== 3.3.1 Set Transmit Interval Time === 487 487 488 -AT+5VT : Set extend the time of 5V power 489 489 490 - AT+PRO: Chooseagreement509 +Feature: Change LoRaWAN End Node Transmit Interval. 491 491 492 - AT+RXDL: Extend thesendingandreceiving time511 +(% style="color:blue" %)**AT Command: AT+TDC** 493 493 494 -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 +))) 495 495 496 - AT+GETSENSORVALUE: Returnsheurrentsensormeasurement525 +(% style="color:blue" %)**Downlink Command: 0x01** 497 497 498 - AT+NOUD:GetorSetthenumberofdatato beuploaded527 +Format: Command Code (0x01) followed by 3 bytes time value. 499 499 500 - 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. 501 501 502 -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 503 503 504 - AT+SHHUM:GetorSetlarm of moisture534 +=== 3.3.2 Get Device Status === 505 505 506 -AT+SERVADDR : Server Address 507 507 537 +Send a LoRaWAN downlink to ask device send Alarm settings. 508 508 509 -(% style="color:blue" %)** UDPManagement**539 +(% style="color:blue" %)**Downlink Payload: **(%%)0x26 01 510 510 511 - AT+CFM:Uploadconfirmationmode(only valid forUDP)541 +Sensor will upload Device Status via FPORT=5. See payload section for detail. 512 512 513 513 514 - (%style="color:blue"%)**MQTT Management**544 +=== 3.3.3 Set Temperature Alarm Threshold === 515 515 516 -AT+CLIENT : Get or Set MQTT client 517 517 518 - AT+UNAME:GetSetMQTTUsername547 +* (% style="color:blue" %)**AT Command:** 519 519 520 - AT+PWD: Getet MQTT password549 +(% style="color:#037691" %)**AT+SHTEMP=min,max** 521 521 522 -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 523 523 524 - AT+SUBTOPIC : Get or Set MQTT subscription topic555 +Example: 525 525 557 + AT+SHTEMP=0,30 ~/~/ Alarm when temperature higher than 30. 526 526 527 -(% style="color:blue" %)** Information**559 +* (% style="color:blue" %)**Downlink Payload:** 528 528 529 - AT+FDR: Factory Data Reset561 +(% style="color:#037691" %)**0x(0C 01 00 1E)** (%%) ~/~/ Set AT+SHTEMP=0,30 530 530 531 - AT+PWORD:SerialAccessPassword563 +(% style="color:red" %)**(note: 3^^rd^^ byte= 0x00 for low limit(not set), 4^^th^^ byte = 0x1E for high limit: 30)** 532 532 533 -AT+LDATA : Get the last upload data 534 534 535 - AT+CDP: Reador Clearcacheddata566 +=== 3.3.4 Set Humidity Alarm Threshold === 536 536 537 537 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 + 538 538 = 4. Battery & Power Consumption = 539 539 540 540 541 -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. 542 542 543 543 [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] . 544 544 545 545 546 -= 5. Firmware update = 686 += 5. OTA Firmware update = 547 547 548 548 549 -User can change device firmware to:: 689 +(% class="wikigeneratedid" %) 690 +User can change firmware S31x-LB to: 550 550 692 +* Change Frequency band/ region. 551 551 * Update with new features. 552 - 553 553 * Fix bugs. 554 554 555 -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]]** 556 556 698 + 557 557 Methods to Update Firmware: 558 558 559 -* (Recommended way) OTA firmware update via BLE: [[**Instruction**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/BLE_Firmware_Update_NB_Sensors_BC660K-GL/]]. 560 - 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/]]** 561 561 * 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]]**. 562 562 563 563 = 6. FAQ = 564 564 565 -== 6.1 How can I access t BC660K-GL AT Commands? == 566 566 567 567 568 - Usercanaccess to BC660K-GL directly andsendAT Commands.708 += 7. Order Info = 569 569 570 -[[See BC660K-GL AT Command set>>url:https://www.dropbox.com/sh/5f6ssda5fum8rvs/AABT68l8ZzWOvZ5eg2qwOoFda?dl=0]] 571 571 711 +Part Number: (% style="color:blue" %)**S31-LB-XX / S31B-LB-XX** 572 572 573 -= 7.OrderInfo=713 +(% style="color:red" %)**XX**(%%): The default frequency band 574 574 715 +* (% style="color:red" %)**AS923**(%%): LoRaWAN AS923 band 575 575 576 - PartNumber:(% style="color:blue" %)**S31-NB-XX/ S31B-NB-XX**717 +* (% style="color:red" %)**AU915**(%%): LoRaWAN AU915 band 577 577 578 -(% style="color:red" %)** XX**(%%):719 +* (% style="color:red" %)**EU433**(%%): LoRaWAN EU433 band 579 579 580 -* (% style="color: #037691" %)**GE**(%%):Generalversion (ExcludeSIM card)721 +* (% style="color:red" %)**EU868**(%%): LoRaWAN EU868 band 581 581 582 -* (% style="color: #037691" %)**1D**(%%):with 1NCE*10years 500MB SIM card andPre-configure to DataCake server723 +* (% style="color:red" %)**KR920**(%%): LoRaWAN KR920 band 583 583 584 -(% 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 585 585 727 +* (% style="color:red" %)**IN865**(%%): LoRaWAN IN865 band 586 586 729 +* (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band 730 + 587 587 = 8. Packing Info = 588 588 589 589 590 590 (% style="color:#037691" %)**Package Includes**: 591 591 592 -* S31- NB or S31-NBNB-IoT SensorNode x 1736 +* S31x-LB LoRaWAN Temperature & Humidity Sensor 593 593 594 -* External antenna x 1 595 - 596 596 (% style="color:#037691" %)**Dimension and weight**: 597 597 598 -* Device Size: 13.0 x 5 x 4.5cm740 +* Device Size: cm 599 599 600 -* Device Weight: 150g742 +* Device Weight: g 601 601 602 -* Package Size / pcs : 14.0 x 8x 5cm744 +* Package Size / pcs : cm 603 603 604 -* Weight / pcs : 180g746 +* Weight / pcs : g 605 605 606 606 = 9. Support = 607 607 ... ... @@ -610,4 +610,5 @@ 610 610 611 611 * 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]]. 612 612 755 + 613 613 (% 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