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, 4 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,8 @@ 114 114 * Smart Cities 115 115 * Smart Factory 116 116 118 + 119 + 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 128 + 125 125 == 1.6 Button & LEDs == 126 126 127 127 ... ... @@ -129,7 +129,7 @@ 129 129 130 130 131 131 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 132 -|=(% 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** 133 133 |(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:117px" %)Send an uplink|(% style="width:225px" %)((( 134 134 If sensor has already attached to NB-IoT network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once. 135 135 Meanwhile, BLE module will be active and user can connect via BLE to configure device. ... ... @@ -164,6 +164,7 @@ 164 164 [[image:image-20230819104805-5.png]] 165 165 166 166 171 + 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.181 +1) (% style="color:blue" %)**ISP**(%%): upgrade mode, device won't have any signal in this mode. but ready for upgrade firmware. LED won't work. Firmware won't run. 177 177 178 - **2)**(% style="color:blue" %)**Flash**(%%): work mode, device starts to work and send out console output for further debug183 +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,13 +184,14 @@ 184 184 Press to reboot the device. 185 185 186 186 192 + 187 187 == 1.9 Hardware Variant == 188 188 189 189 190 190 (% border="1" cellspacing="5" style="width:410px" %) 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 Info197 +|=(% 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 192 192 |(% style="width:102px" %)((( 193 -S31- NB199 +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- NB211 +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 225 + 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.242 +(% 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]].244 +1. Install NB-IoT SIM card and configure APN. See instruction of [[Attach Network>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H2.AttachNetwork]]. 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]].246 +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 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" %) 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" %)((( 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" %) 264 264 251 +|**Servers**|**Dash Board**|**Comments** 252 +|[[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]]| 253 +|[[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]]| 254 +|[[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]]| | 255 +|[[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| 256 +|[[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| 257 +|[[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]]| 258 +|[[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]]| 259 +| | | 260 + 261 + 262 + 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,55 @@ 270 270 271 271 To meet different server requirement, S31-NB supports different payload type. 272 272 273 - **Includes:**271 +Includes: 274 274 275 -* [[General JSON format payload>> ||anchor="H2.2.1GeneralJsonFormat28Type3D529"]]. (Type=5)273 +* [[General JSON format payload>>path:#General_Json]]. (Type=5) 276 276 277 -* [[HEX format Payload>> ||anchor="H2.2.2HEXformatPayload28Type3D029"]]. (Type=0)275 +* [[HEX format Payload>>path:#HEX_Payload]]. (Type=0) 278 278 279 -* [[ThingSpeak Format>> ||anchor="H2.2.4ThingSpeakPayload28Type3D129"]]. (Type=1)277 +* [[ThingSpeak Format>>path:#ThingSpeak_Payload]]. (Type=1) 280 280 281 -* [[ThingsBoard Format>> ||anchor="H2.2.3ThingsBoardPayload28Type3D329"]]. (Type=3)279 +* [[ThingsBoard Format>>path:#ThingsBoard_Payload]]. (Type=3) 282 282 281 + 283 283 User can specify the payload type when choose the connection protocol. Example: 284 284 285 -(% style="color:#037691" %)**AT+PRO=2,0** 284 +(% style="color:#037691" %)**AT+PRO=2,0** (%%) ~/~/Use UDP Connection & hex Payload 286 286 287 -(% style="color:#037691" %)**AT+PRO=2,5** 286 +(% style="color:#037691" %)**AT+PRO=2,5** (%%) ~/~/ Use UDP Connection & Json Payload 288 288 289 -(% style="color:#037691" %)**AT+PRO=3,5 ** (%%) 288 +(% 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) ===291 +=== 2.2.1 General Json Format (Type=5) === 293 293 294 - 295 295 This is the General Json Format. As below: 296 296 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 296 +(% 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}}** 299 299 300 -(% style="color:red" %)**Notice, from above payload:** 301 301 299 + 300 +(% style="color:red" %)Notice, from above payload: 301 + 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 308 + 309 +=== 2.2.2 HEX format Payload(Type=0) === 310 + 311 + 309 309 This is the HEX Format. As below: 310 310 311 -(% style="color:#4472 c4" %)**f86620705346276200640cba16010000000011011801e864d49c2d011a01e364d49925011901eb64d49871011901e564d497bd011a01e664d49709011901e964d49655011a01e864d495a1011a01e864d494ed011801e864d49439**314 +(% style="color:#4472C4" %)**f86620705346276200640cba16010000000011011801e864d49c2d011a01e364d49925011901eb64d49871011901e564d497bd011a01e664d49709011901e964d49655011a01e864d495a1011a01e864d494ed011801e864d49439** 312 312 313 -[[image:1692424009971-458.png]] 314 314 317 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image001.png]] 315 315 319 + 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):**329 +(% 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)357 +(FF3F & 8000:Judge whether the highest bit is 1, when the highest bit is 1, it is negative) 354 354 355 355 360 + 356 356 (% style="color:blue" %)**Humidity: ** 357 357 358 358 Read:0295(H)=661(D) Value: 661 / 10=66.1, So 66.1% ... ... @@ -365,24 +365,24 @@ 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) ===373 +=== 2.2.3 ThingsBoard Payload(Type=3) === 369 369 370 - 371 371 Type3 payload special design for ThingsBoard, it will also configure other default server to ThingsBoard. 372 372 373 -(% style="color:#4472c4" %)**{"IMEI":866207053462762,"temperature":29.2,"humidity":54.2,"battery":3.27,"signal":24}** 374 374 378 +(% style="color:#4472C4" %)**{"IMEI":866207053462762,"temperature":29.2,"humidity":54.2,"battery":3.27,"signal":24}** 375 375 376 -=== 2.2.4 ThingSpeak Payload(Type~=1) === 377 377 381 +=== 2.2.4 ThingSpeak Payload(Type=1) === 378 378 379 379 This payload meets ThingSpeak platform requirement. It includes only four fields. Form 1~~4 are: 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 -(% style="color:#4472 c4" %)**field1=27.9&field2=49.9&field3=3.23&field4=28**390 +(% style="color:#4472C4" %)**field1=27.9&field2=49.9&field3=3.23&field4=28** 386 386 387 387 388 388 == 2.3 Test Uplink and Change Update Interval == ... ... @@ -390,25 +390,30 @@ 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 418 + 409 409 The diagram below explains the relationship between TR, NOUD, and TDC more clearly: 410 410 411 -[[image: 1692424376354-959.png]]421 +[[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 434 +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 439 +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,11 @@ 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 448 + 449 + 450 + 451 + 452 + 438 438 == 2.6 Trggier an uplink by external interrupt == 439 439 440 440 ... ... @@ -442,16 +442,20 @@ 442 442 443 443 (% style="color:blue" %)**AT command:** 444 444 445 -* (% style="color:#037691" %)**AT+INTMOD 460 +* (% style="color:#037691" %)**AT+INTMOD **(%%) ~/~/ Set the trigger interrupt mode 446 446 447 -* (% style="color:#037691" %)**AT+INTMOD=0 462 +* (% style="color:#037691" %)**AT+INTMOD=0 **(%%) ~/~/Disable Interrupt 448 448 449 -* (% style="color:#037691" %)**AT+INTMOD=1 464 +* (% style="color:#037691" %)**AT+INTMOD=1 **(%%) ~/~/Trigger by rising and falling edge 450 450 451 -* (% style="color:#037691" %)**AT+INTMOD=2 466 +* (% style="color:#037691" %)**AT+INTMOD=2 **(%%) ~/~/Trigger by falling edge 452 452 453 -* (% style="color:#037691" %)**AT+INTMOD=3 468 +* (% style="color:#037691" %)**AT+INTMOD=3 **(%%) ~/~/Trigger by rising edge 454 454 470 + 471 + 472 + 473 + 455 455 = 3. Configure S31x-NB = 456 456 457 457 == 3.1 Configure Methods == ... ... @@ -463,153 +463,272 @@ 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==485 +* 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 the value 474 474 475 - AT+<CMD>=?:Get thevalue491 +== 3.2 General Commands == 476 476 477 477 478 - (%style="color:blue" %)**General Commands**494 +These commands are to configure: 479 479 480 -AT : Attention 496 +* General system settings like: uplink interval. 497 +* LoRaWAN protocol & radio related command. 481 481 482 - AT?: ShortHelp499 +They are same for all Dragino Devices which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki: 483 483 484 -AT Z:CU Reset501 +[[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/]] 485 485 486 -AT+TDC : Application Data Transmission Interval 487 487 488 - AT+CFG: Printallconfigurations504 +== 3.3 Commands special design for S31x-LB == 489 489 490 -AT+CFGMOD : Working mode selection 491 491 492 - AT+DEUI: Getor settheDevice ID507 +These commands only valid for S31x-LB, as below: 493 493 494 -AT+INTMOD : Set the trigger interrupt mode 495 495 496 - AT+5VT:Setextendthetimeof 5V power510 +=== 3.3.1 Set Transmit Interval Time === 497 497 498 -AT+PRO : Choose agreement 499 499 500 - AT+RXDL : Extendthesending andreceivingtime513 +Feature: Change LoRaWAN End Node Transmit Interval. 501 501 502 - AT+DNSCFG: GetSetDNSServer515 +(% style="color:blue" %)**AT Command: AT+TDC** 503 503 504 -AT+GETSENSORVALUE : Returns the current sensor measurement 517 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 518 +|=(% 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** 519 +|(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|((( 520 +30000 521 +OK 522 +the interval is 30000ms = 30s 523 +))) 524 +|(% style="width:156px" %)AT+TDC=60000|(% style="width:137px" %)Set Transmit Interval|((( 525 +OK 526 +Set transmit interval to 60000ms = 60 seconds 527 +))) 505 505 506 - AT+NOUD: GetSet the numberofdata tobe uploaded529 +(% style="color:blue" %)**Downlink Command: 0x01** 507 507 508 - AT+CDP:Read orClearcacheddata531 +Format: Command Code (0x01) followed by 3 bytes time value. 509 509 510 - AT+SHTEMP:GetorSet alarmoftemp533 +If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01. 511 511 512 -AT+SHHUM: Get or Set alarm of moisture 535 +* Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds 536 +* Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 513 513 514 - AT+SERVADDR:ServerAddress538 +=== 3.3.2 Get Device Status === 515 515 516 516 517 - (% style="color:blue"%)**UDPManagement**541 +Send a LoRaWAN downlink to ask device send Alarm settings. 518 518 519 - AT+CFM: Uploadconfirmation mode(onlyvalidfor UDP)543 +(% style="color:blue" %)**Downlink Payload: **(%%)0x26 01 520 520 545 +Sensor will upload Device Status via FPORT=5. See payload section for detail. 521 521 522 -(% style="color:blue" %)**MQTT Management** 523 523 524 - AT+CLIENT:Getor SetMQTT client548 +=== 3.3.3 Set Temperature Alarm Threshold === 525 525 526 -AT+UNAME : Get or Set MQTT Username 527 527 528 - AT+PWD:GetSetMQTTpassword551 +* (% style="color:blue" %)**AT Command:** 529 529 530 - AT+PUBTOPIC: Getet MQTT publish topic553 +(% style="color:#037691" %)**AT+SHTEMP=min,max** 531 531 532 -AT+SUBTOPIC : Get or Set MQTT subscription topic 555 +* When min=0, and max≠0, Alarm higher than max 556 +* When min≠0, and max=0, Alarm lower than min 557 +* When min≠0 and max≠0, Alarm higher than max or lower than min 533 533 559 +Example: 534 534 535 - (%style="color:blue"%)**Information**561 + AT+SHTEMP=0,30 ~/~/ Alarm when temperature higher than 30. 536 536 537 - AT+FDR: FactoryDataReset563 +* (% style="color:blue" %)**Downlink Payload:** 538 538 539 - AT+PWORD:SerialAccessPassword565 +(% style="color:#037691" %)**0x(0C 01 00 1E)** (%%) ~/~/ Set AT+SHTEMP=0,30 540 540 541 - AT+LDATA: Get thelastuploaddata567 +(% style="color:red" %)**(note: 3^^rd^^ byte= 0x00 for low limit(not set), 4^^th^^ byte = 0x1E for high limit: 30)** 542 542 543 -AT+CDP : Read or Clear cached data 544 544 570 +=== 3.3.4 Set Humidity Alarm Threshold === 545 545 572 + 573 +* (% style="color:blue" %)**AT Command:** 574 + 575 +(% style="color:#037691" %)**AT+SHHUM=min,max** 576 + 577 +* When min=0, and max≠0, Alarm higher than max 578 +* When min≠0, and max=0, Alarm lower than min 579 +* When min≠0 and max≠0, Alarm higher than max or lower than min 580 + 581 +Example: 582 + 583 + AT+SHHUM=70,0 ~/~/ Alarm when humidity lower than 70%. 584 + 585 +* (% style="color:blue" %)**Downlink Payload:** 586 + 587 +(% style="color:#037691" %)**0x(0C 02 46 00)**(%%) ~/~/ Set AT+SHTHUM=70,0 588 + 589 +(% style="color:red" %)**(note: 3^^rd^^ byte= 0x46 for low limit (70%), 4^^th^^ byte = 0x00 for high limit (not set))** 590 + 591 + 592 +=== 3.3.5 Set Alarm Interval === 593 + 594 + 595 +The shortest time of two Alarm packet. (unit: min) 596 + 597 +* (% style="color:blue" %)**AT Command:** 598 + 599 +(% 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. 600 + 601 +* (% style="color:blue" %)**Downlink Payload:** 602 + 603 +(% style="color:#037691" %)**0x(0D 00 1E)**(%%) **~-~--> ** Set AT+ATDC=0x 00 1E = 30 minutes 604 + 605 + 606 +=== 3.3.6 Get Alarm settings === 607 + 608 + 609 +Send a LoRaWAN downlink to ask device send Alarm settings. 610 + 611 +* (% style="color:#037691" %)**Downlink Payload: **(%%)0x0E 01 612 + 613 +**Example:** 614 + 615 +[[image:image-20230524110211-4.png]] 616 + 617 +**Explain:** 618 + 619 +* Alarm & MOD bit is 0x7C, 0x7C >> 2 = 0x31: Means this message is the Alarm settings message. 620 + 621 +=== 3.3.7 Set Interrupt Mode === 622 + 623 + 624 +Feature, Set Interrupt mode for PA8 of pin. 625 + 626 +When AT+INTMOD=0 is set, PA8 is used as a digital input port. 627 + 628 +(% style="color:blue" %)**AT Command: AT+INTMOD** 629 + 630 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 631 +|=(% 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** 632 +|(% style="width:154px" %)AT+INTMOD=?|(% style="width:196px" %)Show current interrupt mode|(% style="width:157px" %)((( 633 +0 634 +OK 635 +the mode is 0 =Disable Interrupt 636 +))) 637 +|(% style="width:154px" %)AT+INTMOD=2|(% style="width:196px" %)((( 638 +Set Transmit Interval 639 +0. (Disable Interrupt), 640 +~1. (Trigger by rising and falling edge) 641 +2. (Trigger by falling edge) 642 +3. (Trigger by rising edge) 643 +)))|(% style="width:157px" %)OK 644 + 645 +(% style="color:blue" %)**Downlink Command: 0x06** 646 + 647 +Format: Command Code (0x06) followed by 3 bytes. 648 + 649 +This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06. 650 + 651 +* Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode 652 +* Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 653 + 654 +=== 3.3.8 Set Power Output Duration === 655 + 656 + 657 +Control the output duration 5V . Before each sampling, device will 658 + 659 +~1. first enable the power output to external sensor, 660 + 661 +2. keep it on as per duration, read sensor value and construct uplink payload 662 + 663 +3. final, close the power output. 664 + 665 +(% style="color:blue" %)**AT Command: AT+5VT** 666 + 667 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 668 +|=(% 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** 669 +|(% style="width:154px" %)AT+5VT=?|(% style="width:196px" %)Show 5V open time.|(% style="width:157px" %)0 (default) 670 +OK 671 +|(% style="width:154px" %)AT+5VT=1000|(% style="width:196px" %)Close after a delay of 1000 milliseconds.|(% style="width:157px" %)OK 672 + 673 +(% style="color:blue" %)**Downlink Command: 0x07** 674 + 675 +Format: Command Code (0x07) followed by 2 bytes. 676 + 677 +The first and second bytes are the time to turn on. 678 + 679 +* Example 1: Downlink Payload: 070000 **~-~-->** AT+5VT=0 680 +* Example 2: Downlink Payload: 0701F4 **~-~-->** AT+5VT=500 681 + 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.685 +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 = 690 += 5. OTA Firmware update = 555 555 556 556 557 -User can change device firmware to:: 693 +(% class="wikigeneratedid" %) 694 +User can change firmware S31x-LB to: 558 558 696 +* 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]]**700 +Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/fis3g6nmhv0eokg/AAC6BcCZaX4BdqZkduUvZ3jIa?dl=0]]** 564 564 702 + 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 - 705 +* (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.712 += 7. Order Info = 577 577 578 -[[See BC660K-GL AT Command set>>url:https://www.dropbox.com/sh/5f6ssda5fum8rvs/AABT68l8ZzWOvZ5eg2qwOoFda?dl=0]] 579 579 715 +Part Number: (% style="color:blue" %)**S31-LB-XX / S31B-LB-XX** 580 580 581 -= 7.OrderInfo=717 +(% style="color:red" %)**XX**(%%): The default frequency band 582 582 719 +* (% style="color:red" %)**AS923**(%%): LoRaWAN AS923 band 583 583 584 - PartNumber:(% style="color:blue" %)**S31-NB-XX/ S31B-NB-XX**721 +* (% style="color:red" %)**AU915**(%%): LoRaWAN AU915 band 585 585 586 -(% style="color:red" %)** XX**(%%):723 +* (% style="color:red" %)**EU433**(%%): LoRaWAN EU433 band 587 587 588 -* (% style="color: #037691" %)**GE**(%%):Generalversion (ExcludeSIM card)725 +* (% style="color:red" %)**EU868**(%%): LoRaWAN EU868 band 589 589 590 -* (% style="color: #037691" %)**1D**(%%):with 1NCE*10years 500MB SIM card andPre-configure to DataCake server727 +* (% 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 Islands729 +* (% style="color:red" %)**US915**(%%): LoRaWAN US915 band 593 593 731 +* (% style="color:red" %)**IN865**(%%): LoRaWAN IN865 band 594 594 733 +* (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band 734 + 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 1740 +* 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.5cm744 +* Device Size: cm 607 607 608 -* Device Weight: 150g746 +* Device Weight: g 609 609 610 -* Package Size / pcs : 14.0 x 8x 5cm748 +* Package Size / pcs : cm 611 611 612 -* Weight / pcs : 180g750 +* Weight / pcs : g 613 613 614 614 = 9. Support = 615 615 ... ... @@ -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" %) 759 +(% 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
- 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