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, 2 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**(%%)uses (%style="color:blue" %)**none-contact method**(%%)to measure theheightof liquid**(%%) in acontainerwithoutopening 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 (% style="color:blue" %)**ultrasonicsensing technology**(%%) fordistancemeasurement.DDS20-NBisof high accuracy tomeasure variousliquidsuch as:(% style="color:blue" %)**toxicsubstances**,strongacids**, **strongalkalis**(%%) and (% style="color:blue" %)**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 - DDS20-NB supports different uplink methodsincluding(% style="color:blue" %)**MQTT,MQTTs, UDP & TCP**(%%)fordifferent applicationrequirement,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 - DDS20-NB (% style="color:blue"%)**supports BLE configure**(%%)and(% style="color:blue"%)** OTA update**(%%) which makeusereasytouse.28 +*make sure you have NB-IoT coverage locally. 28 28 29 -DDS20-NB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long-term use up to severa years. 30 30 31 - DDS20-NB 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,151 +91,33 @@ 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 98 98 99 -== 1.4 Suitable Container& Liquid==108 +== 1.4 Applications == 100 100 101 101 102 -* S olid Wall containersuch as: steel,iron,glass,ceramics,non-foamingplastics etc.103 -* Containershapeisregular, andsurfaceissmooth.104 -* ContainerThickness:105 -* *Puremetal material. 2~~8mm, bestis 3~~5mm106 -* *Pure nonmetalmaterial: <10 mm107 -* Pure liquid withoutirregular deposition.111 +* Smart Buildings & Home Automation 112 +* Logistics and Supply Chain Management 113 +* Smart Metering 114 +* Smart Agriculture 115 +* Smart Cities 116 +* Smart Factory 108 108 109 - (%style="display:none"%)118 +== 1.5 Sleep mode and working mode == 110 110 111 -== 1.5 Install DDS20-NB == 112 112 113 - 114 -(% style="color:blue" %)**Step 1**(%%): ** Choose the installation point.** 115 - 116 -DDS20-NB (% style="color:red" %)**MUST**(%%) be installed on the container bottom middle position. 117 - 118 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS20%20-%20LoRaWAN%20Liquid%20Level%20Sensor%20User%20Manual/WebHome/image-20220615091045-3.png?rev=1.1||alt="image-20220615091045-3.png"]] 119 - 120 - 121 -((( 122 -(% style="color:blue" %)**Step 2**(%%): **Polish the installation point.** 123 -))) 124 - 125 -((( 126 -For Metal Surface with paint, it is important to polish the surface, first use crude sand paper to polish the paint level , then use exquisite sand paper to polish the metal level to make it shine & smooth. 127 -))) 128 - 129 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/DDS20-LB_LoRaWAN_Ultrasonic_Liquid_Level_Sensor_User_Manual/WebHome/image-20230613143052-5.png?rev=1.1||alt="image-20230613143052-5.png"]] 130 - 131 - 132 -No polish needed if the container is shine metal surface without paint or non-metal container. 133 - 134 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/DDS20-LB_LoRaWAN_Ultrasonic_Liquid_Level_Sensor_User_Manual/WebHome/image-20230613143125-6.png?rev=1.1||alt="image-20230613143125-6.png"]] 135 - 136 - 137 -((( 138 -(% style="color:blue" %)**Step3: **(%%)**Test the installation point.** 139 -))) 140 - 141 -((( 142 -Power on DDS20-NB, check if the blue LED is on, If the blue LED is on, means the sensor works. Then put ultrasonic coupling paste on the sensor and put it tightly on the installation point. 143 -))) 144 - 145 -((( 146 -It is necessary to put the coupling paste between the sensor and the container, otherwise DDS20-NB won't detect the liquid level. 147 -))) 148 - 149 -((( 150 -After paste the DDS20-NB well, power on DDS20-NB. In the first 30 seconds of booting, device will check the sensors status and BLUE LED will show the status as below. After 30 seconds, BLUE LED will be off to save battery life. 151 -))) 152 - 153 - 154 -((( 155 -(% style="color:blue" %)**LED Status:** 156 -))) 157 - 158 -* ((( 159 -**Onboard LED**: When power on device, the onboard LED will fast blink 4 times which means detect the sensor well. 160 -))) 161 - 162 -* ((( 163 -(% style="color:blue" %)**BLUE LED**(% style="color:red" %)** always ON**(%%): Sensor is power on but doesn't detect liquid. There is problem in installation point. 164 -))) 165 -* ((( 166 -(% style="color:blue" %)**BLUE LED**(% style="color:red" %)** slowly blinking**(%%): Sensor detects Liquid Level, The installation point is good. 167 -))) 168 - 169 -((( 170 -DDS20-NB will enter into low power mode at 30 seconds after system reset or power on, Blue LED will be off after that. 171 -))) 172 - 173 - 174 -((( 175 -(% style="color:red" %)**Note :**(%%)** (% style="color:blue" %)Ultrasonic coupling paste(%%)**(% style="color:blue" %) (%%) is subjected in most shipping way. So the default package doesn't include it and user needs to purchase locally. 176 -))) 177 - 178 - 179 -((( 180 -(% style="color:blue" %)**Step4: **(%%)**Install use Epoxy ab glue.** 181 -))) 182 - 183 -((( 184 -Prepare Eproxy AB glue. 185 -))) 186 - 187 -((( 188 -Put Eproxy AB glue in the sensor and press it hard on the container installation point. 189 -))) 190 - 191 -((( 192 -Reset DDS20-NB and see if the BLUE LED is slowly blinking. 193 -))) 194 - 195 -[[image:image-20230809172509-1.png]] 196 - 197 -((( 198 -(% style="color:red" %)**Note :**(% style="color:red; display:none" %)** ** 199 - 200 -(% style="color:red" %)**1:**(%%)** (% style="color:blue" %)Eproxy AB glue(%%)** needs 3~~ 5 minutes to stable attached. we can use other glue material to keep it in the position. 201 -))) 202 - 203 -((( 204 -(% style="color:red" %)**2:**(%%)** (% style="color:blue" %)Eproxy AB glue(%%)** is subjected in most shipping way. So the default package doesn't include it and user needs to purchase locally. 205 -))) 206 - 207 - 208 -== 1.6 Applications == 209 - 210 - 211 -* Smart liquid control solution 212 - 213 -* Smart liquefied gas solution 214 - 215 -== 1.7 Precautions == 216 - 217 - 218 -* At room temperature, containers of different materials, such as steel, glass, iron, ceramics, non-foamed plastics and other dense materials, have different detection blind areas and detection limit heights. 219 - 220 -* For containers of the same material at room temperature, the detection blind zone and detection limit height are also different for the thickness of the container. 221 - 222 -* When the detected liquid level exceeds the effective detection value of the sensor, and the liquid level of the liquid to be measured shakes or tilts, the detected liquid height is unstable. 223 - 224 -(% style="display:none" %) 225 - 226 - 227 - 228 -== 1.8 Sleep mode and working mode == 229 - 230 - 231 231 (% style="color:blue" %)**Deep Sleep Mode: **(%%)Sensor doesn't have any LoRaWAN activate. This mode is used for storage and shipping to save battery life. 232 232 233 233 (% 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. 234 234 235 235 236 -== 1.9 Button & LEDs == 237 237 127 +== 1.6 Button & LEDs == 238 238 129 + 239 239 [[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675071855856-879.png]] 240 240 241 241 ... ... @@ -252,10 +252,10 @@ 252 252 ))) 253 253 |(% style="width:167px" %)Fast press ACT 5 times.|(% style="width:117px" %)Deactivate Device|(% style="width:225px" %)(% style="color:red" %)**Red led**(%%) will solid on for 5 seconds. Means device is in Deep Sleep Mode. 254 254 255 -== 1. 10BLE connection ==146 +== 1.7 BLE connection == 256 256 257 257 258 - DDS20-NB support BLE remote configure and firmware update.149 +S31x-NB support BLE remote configure and firmware update. 259 259 260 260 261 261 BLE can be used to configure the parameter of sensor or see the console output from sensor. BLE will be only activate on below case: ... ... @@ -267,114 +267,122 @@ 267 267 If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode. 268 268 269 269 270 -== 1. 11Pin Definitions & Switch ==161 +== 1.8 Pin Definitions & Switch == 271 271 272 272 164 +S31x-NB use the mother board from S31-NB which as below. 165 + 273 273 [[image:image-20230819104805-5.png]] 274 274 275 275 276 -=== 1.11.1 Jumper JP2 === 277 277 170 +=== 1.8.1 Jumper JP2 === 278 278 172 + 279 279 Power on Device when put this jumper. 280 280 281 281 282 -=== 1. 11.2 BOOT MODE / SW1 ===176 +=== 1.8.2 BOOT MODE / SW1 === 283 283 284 284 285 - **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.179 +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. 286 286 287 - **2)**(% style="color:blue" %)**Flash**(%%): work mode, device starts to work and send out console output for further debug181 +2) (% style="color:blue" %)**Flash**(%%): work mode, device starts to work and send out console output for further debug 288 288 289 289 290 -=== 1. 11.3 Reset Button ===184 +=== 1.8.3 Reset Button === 291 291 292 292 293 293 Press to reboot the device. 294 294 295 -(% style="display:none" %) 296 296 297 297 298 -== 1. 12 Mechanical==191 +== 1.9 Hardware Variant == 299 299 300 300 301 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual/WebHome/1675143884058-338.png?rev=1.1||alt="1675143884058-338.png"]] 194 +(% border="1" cellspacing="5" style="width:410px" %) 195 +|=(% style="width: 102px;background-color:#4F81BD;color:white" %)Model|=(% style="width: 126px; background-color:#4F81BD;color:white" %)Photo|=(% style="width: 179px;background-color:#4F81BD;color:white" %)Probe Info 196 +|(% style="width:102px" %)((( 197 +S31-LB 198 +)))|(% style="width:126px" %)((( 199 +(% style="text-align:center" %) 200 +[[image:image-20230819110632-6.png||height="130" width="104"]] 201 +)))|(% style="width:179px" %)((( 202 +1 x SHT31 Probe 302 302 303 - [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual/WebHome/1675143899218-599.png?rev=1.1||alt="1675143899218-599.png"]]204 +Cable Length : 3 meters 304 304 305 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual/WebHome/1675143909447-639.png?rev=1.1||alt="1675143909447-639.png"]] 206 + 207 +))) 208 +|(% style="width:102px" %)((( 209 +S31B-LB 210 +)))|(% style="width:126px" %)((( 211 +(% style="text-align:center" %) 212 +[[image:image-20230819110702-7.png||height="164" width="90"]] 213 +)))|(% style="width:179px" %)((( 214 +1 x SHT31 Probe 306 306 216 +Installed in device. 217 +))) 307 307 308 -(% style=" color:blue" %)**ProbeMechanical:**219 +(% style="display:none" %) 309 309 310 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS20%20-%20LoRaWAN%20Liquid%20Level%20Sensor%20User%20Manual/WebHome/image-20220615090910-1.png?rev=1.1||alt="image-20220615090910-1.png"]] 311 311 312 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS20%20-%20LoRaWAN%20Liquid%20Level%20Sensor%20User%20Manual/WebHome/image-20220615090910-2.png?rev=1.1||alt="image-20220615090910-2.png"]] 313 313 314 314 315 -= 2. Use DDS20-NB to communicate with IoT Server =224 += 2. Use S31-NB to communicate with IoT Server = 316 316 317 317 == 2.1 Send data to IoT server via NB-IoT network == 318 318 319 319 320 -The DDS20-NB is equipped with a NB-IoT module, the pre-loaded firmware inDDS20-NB will get environment data from sensors and send the value to local NB-IoT network via the NB-IoT module. The NB-IoT network will forward this value to IoT server via the protocol defined byDDS20-NB.229 +The S31-NB is equipped with a NB-IoT module, the pre-loaded firmware in S31-NB will get environment data from sensors and send the value to local NB-IoT network via the NB-IoT module. The NB-IoT network will forward this value to IoT server via the protocol defined by S31-NB. 321 321 322 322 323 323 Below shows the network structure: 324 324 325 -[[image: http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/DDS20-NB_NB-IoT_Ultrasonic_Liquid_Level_Sensor_User_Manual/WebHome/image-20230911140426-2.png?width=951&height=320&rev=1.1||alt="image-20230911140426-2.png"]]234 +[[image:1692415924540-357.png]] 326 326 327 327 328 -There are two version: (% style="color:blue" %)**-GE**(%%) and (% style="color:blue" %)**-1D**(%%) version of DDS20-NB.237 +There are two version: (% style="color:blue" %)**-GE**(%%) and (% style="color:blue" %)**-1D**(%%) version of S31-NB. 329 329 330 330 331 -(% 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 setDDS20-NB send data to IoT server.240 +(% style="color:blue" %)**GE Version**(%%): This version doesn’t include SIM card or point to any IoT server. User needs to use AT Commands to configure below two steps to set S31-NB send data to IoT server. 332 332 333 - *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]].242 +1. Install NB-IoT SIM card and configure APN. See instruction of [[Attach Network>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H2.AttachNetwork]]. 334 334 335 - *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]].244 +1. Set up sensor to point to IoT Server. See instruction of [[Configure to Connect Different Servers>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.Configuretoconnecttodifferentservers]]. 336 336 337 337 Below shows result of different server as a glance. 338 338 248 + 339 339 (% border="1" cellspacing="4" style="width:515px" %) 340 340 |(% 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** 341 -|(% 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" %)((( 342 -(% style="text-align:center" %) 343 -[[image:image-20230819113244-8.png||height="183" width="367"]] 344 -)))|(% style="width:170px" %) 345 -|(% 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" %)((( 346 -(% style="text-align:center" %) 347 -[[image:image-20230819113244-9.png||height="119" width="367"]] 348 -)))|(% style="width:170px" %) 251 +|(% style="width:127px" %)[[Node-Red>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.5A0Node-RedA028viaA0MQTT29]]|(% style="width:385px" %)[[image:image-20230819113244-8.png||height="183" width="367"]]|(% style="width:170px" %) 252 +|(% style="width:127px" %)[[DataCake>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.4Datacake]]|(% style="width:385px" %)[[image:image-20230819113244-9.png||height="120" width="369"]]|(% style="width:170px" %) 349 349 |(% 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" %) 350 350 |(% 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" %) 351 351 |(% 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" %) 352 -|(% 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" %)((( 353 -(% style="text-align:center" %) 354 -[[image:image-20230819113244-10.png||height="104" width="367"]] 355 -)))|(% style="width:170px" %) 356 -|(% 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" %)((( 357 -(% style="text-align:center" %) 358 -[[image:image-20230819113244-11.png||height="141" width="367"]] 359 -)))|(% style="width:170px" %) 256 +|(% style="width:127px" %)[[ThingSpeak>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.3A0ThingSpeakA028viaA0MQTT29]]|(% style="width:385px" %)[[image:image-20230819113244-10.png||height="82" width="291"]]|(% style="width:170px" %) 257 +|(% style="width:127px" %)[[ThingsBoard>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.6A0ThingsBoard.CloudA028viaA0MQTT29]]|(% style="width:385px" %)[[image:image-20230819113244-11.png||height="113" width="293"]]|(% style="width:170px" %) 258 +|(% style="width:127px" %) |(% style="width:385px" %) |(% style="width:170px" %) 360 360 361 -(% 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 DDS20-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]].260 +(% style="color:blue" %)**1D Version**(%%): This version has 1NCE SIM card pre-installed and configure to send value to DataCake. User Just need to select the sensor type in DataCake and Activate S31-NB and user will be able to see data in DataCake. See here for [[DataCake Config Instruction>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.4Datacake]]. 362 362 363 363 364 364 == 2.2 Payload Types == 365 365 366 366 367 -To meet different server requirement, DDS20-NB supports different payload type.266 +To meet different server requirement, S31-NB supports different payload type. 368 368 369 369 **Includes:** 370 370 371 -* [[General JSON format payload>> ||anchor="H2.2.1GeneralJsonFormat28Type3D529"]]. (Type=5)270 +* [[General JSON format payload>>path:#General_Json]]. (Type=5) 372 372 373 -* [[HEX format Payload>> ||anchor="H2.2.2HEXformatPayload28Type3D029"]]. (Type=0)272 +* [[HEX format Payload>>path:#HEX_Payload]]. (Type=0) 374 374 375 -* [[ThingSpeak Format>> ||anchor="H2.2.4ThingSpeakPayload28Type3D129"]]. (Type=1)274 +* [[ThingSpeak Format>>path:#ThingSpeak_Payload]]. (Type=1) 376 376 377 -* [[ThingsBoard Format>> ||anchor="H2.2.3ThingsBoardPayload28Type3D329"]]. (Type=3)276 +* [[ThingsBoard Format>>path:#ThingsBoard_Payload]]. (Type=3) 378 378 379 379 User can specify the payload type when choose the connection protocol. Example: 380 380 ... ... @@ -385,12 +385,12 @@ 385 385 (% style="color:#037691" %)**AT+PRO=3,5 ** (%%) ~/~/ Use MQTT Connection & Json Payload 386 386 387 387 388 -=== 2.2.1 General Json Format(Type~=5) === 287 +=== 2.2.1 General Json Format (Type~=5) === 389 389 390 390 391 391 This is the General Json Format. As below: 392 392 393 -(% style="color:#4472c4" %)**{"IMEI":866207053462762,"temperature":29.2,"humidity":54.2,"battery":3.27,"signal":24,"Model": DDS20-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}}**292 +(% style="color:#4472c4" %)**{"IMEI":866207053462762,"temperature":29.2,"humidity":54.2,"battery":3.27,"signal":24,"Model":S31x-NB, "1":{28.2,48.3,2023/08/10 08:00:37},"2":{28.1,49.1,2023/08/10 07:57:37},"3":{28.1,48.5,2023/08/10 07:54:37},"4":{28.2,48.6,2023/08/10 07:51:37},"5":{28.1,48.9,2023/08/10 07:48:37},"6":{28.2,48.8,2023/08/10 07:45:37},"7":{28.2,48.8,2023/08/10 07:42:37},"8":{28.0,48.8,2023/08/10 07:39:37}}** 394 394 395 395 396 396 (% style="color:red" %)**Notice, from above payload:** ... ... @@ -399,6 +399,8 @@ 399 399 400 400 * 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. 401 401 301 + 302 + 402 402 === 2.2.2 HEX format Payload(Type~=0) === 403 403 404 404 ... ... @@ -413,7 +413,7 @@ 413 413 414 414 These bytes include the hardware and software version. 415 415 416 -(% style="color:#037691" %)**Higher byte:**(%%) Specify Sensor Model: 0x00 for DDS20-NB317 +(% style="color:#037691" %)**Higher byte:**(%%) Specify Sensor Model: 0x00 for S31B-NB & S31-NB 417 417 418 418 (% style="color:#037691" %)**Lower byte:**(%%) Specify the software version: 0x64=100, means firmware version 100 419 419 ... ... @@ -440,6 +440,20 @@ 440 440 **99** Not known or not detectable 441 441 442 442 344 +(% style="color:blue" %)**Temperature: ** 345 + 346 +If payload is: 0105H: (0105 & 8000 == 0), temp = 0105H /10 = 26.1 degree 347 + 348 +If payload is: FF3FH : (FF3F & 8000 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees. 349 + 350 +(FF3F & 8000:Judge whether the highest bit is 1, when the highest bit is 1, it is negative) 351 + 352 + 353 +(% style="color:blue" %)**Humidity: ** 354 + 355 +Read:0295(H)=661(D) Value: 661 / 10=66.1, So 66.1% 356 + 357 + 443 443 (% style="color:blue" %)**TimeStamp: ** 444 444 445 445 Unit TimeStamp Example: 64d49439(H) = 1691653177(D) ... ... @@ -466,378 +466,353 @@ 466 466 467 467 (% style="color:#4472c4" %)**field1=27.9&field2=49.9&field3=3.23&field4=28** 468 468 469 -== 2.3 Uplink Payload == 470 470 385 +== 2.3 Test Uplink and Change Update Interval == 471 471 472 -((( 473 -DDS20-LB will uplink payload via LoRaWAN with below payload format: 474 -))) 475 475 476 -((( 477 -Uplink payload includes in total 8 bytes. 478 -))) 388 +By default, Sensor will send uplinks (% style="color:blue" %)**every 2 hours**(%%) & AT+NOUD=8 479 479 480 -(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %) 481 -|=(% style="width: 95px; background-color:#4F81BD;color:white" %)Size(bytes)|=(% style="width: 61px; background-color:#4F81BD;color:white" %)2|=(% style="background-color:#4F81BD;color:white" %)2|=(% style="background-color:#4F81BD;color:white" %)1|=(% style="background-color:#4F81BD;color:white" %)2|=(% style="background-color:#4F81BD;color:white" %)1 482 -|(% style="width:95px" %)Value|(% style="width:61px" %)[[BAT>>||anchor="H2.3.2A0BatteryInfo"]]|((( 483 -[[Distance>>||anchor="H2.3.3A0Distance"]] 484 -(unit: mm) 485 -)))|[[Digital Interrupt (Optional)>>||anchor="H2.3.4A0InterruptPin"]]|((( 486 -[[Temperature (Optional)>>||anchor="H2.3.5A0DS18B20Temperaturesensor"]] 487 -)))|[[Sensor Flag>>||anchor="H2.3.6A0SensorFlag"]] 390 +User can use below commands to change the (% style="color:blue" %)**uplink interval**. 488 488 489 - [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/DDS20-LB_LoRaWAN_Ultrasonic_Liquid_Level_Sensor_User_Manual/WebHome/%E5%BE%AE%E4%BF%A1%E6%88%AA%E5%9B%BE_20230702135733.png?width=964&height=215&rev=1.1||alt="微信截图_20230702135733.png"]]392 +(% style="color:#037691" %)**AT+TDC=600 ** (%%) ~/~/ Set Update Interval to 600s 490 490 394 +User can also push the button for more than 1 seconds to activate an uplink. 491 491 492 -=== 2.3.1 Device Status, FPORT~=5 === 493 493 397 +== 2.4 Multi-Samplings and One uplink == 494 494 495 -((( 496 -Users can use the downlink command(**0x26 01**) to ask DDS20-LB to send device configure detail, include device configure status. DDS20-LB will uplink a payload via FPort=5 to server. 497 497 498 -The Payload format is as below. 499 -))) 400 +To save battery life, S31-NB will sample temperature & humidity data every 15 minutes and send one uplink every 2 hours. So each uplink it will include 8 stored data + 1 real-time data. They are defined by: 500 500 501 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:490px" %) 502 -|=(% colspan="6" style="background-color:#4F81BD;color:white" %)Device Status (FPORT=5) 503 -|(% style="width:60px" %)**Size(bytes)**|(% style="width:80px" %)**1**|(% style="width:140px" %)**2**|(% style="width:140px" %)**1**|(% style="width:70px" %)**1**|(% style="width:70px" %)**2** 504 -|(% style="width:94px" %)**Value**|(% style="width:68px" %)Sensor Model|(% style="width:80px" %)Firmware Version|(% style="width:86px" %)Frequency Band|(% style="width:61px" %)Sub-band|(% style="width:61px" %)BAT 402 +* (% style="color:#037691" %)**AT+TR=900** (%%) ~/~/ The unit is seconds, and the default is to record data once every 900 seconds (15 minutes, the minimum can be set to 180 seconds) 505 505 506 - [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/DDS20-LB_LoRaWAN_Ultrasonic_Liquid_Level_Sensor_User_Manual/WebHome/DDS20.png?width=1336&height=241&rev=1.1||alt="DDS20.png"]]404 +* (% style="color:#037691" %)**AT+NOUD=8** (%%)~/~/ The device uploads 8 sets of recorded data by default. Up to 32 sets of record data can be uploaded. 507 507 406 +The diagram below explains the relationship between TR, NOUD, and TDC more clearly: 508 508 509 - (% style="color:#037691" %)**Sensor Model**(%%)**:** For DDS20-LB, this value is 0x29408 +[[image:1692424376354-959.png]] 510 510 511 -(% style="color:#037691" %)**Firmware Version**(%%)**:** 0x0100, Means: v1.0.0 version 512 512 513 - (%style="color:#037691" %)**Frequency Band**(%%)**:**411 +== 2.5 Humidity and Temperature alarm function == 514 514 515 -0x01: EU868 516 516 517 -0 x02:US915414 +On each sampling define by AT+TR ( default 900s or 15 minutes), when the value exceed the range, it will trigger an Alarm and immediately sends a uplink. 518 518 519 -0x03: IN865 520 520 521 - 0x04: AU915417 +(% style="color:blue" %)**AT Commands:** 522 522 523 - 0x05:KZ865419 +(% style="color:#037691" %)**AT+ SHHUM=min,max** 524 524 525 - 0x06:RU864421 +Example: AT+ SHHUM=50,80 ~/~/ Alarm when humidity lower than 50 or higher than 80. 526 526 527 -0x07: AS923 528 528 529 - 0x08: AS923-1424 +(% style="color:#037691" %)**AT+ SHTEMP=min,max** 530 530 531 - 0x09: AS923-2426 +Example: AT+ SHTEMP=20,30 ~/~/ Alarm when temperature lower than 20 or higher than 30 532 532 533 -0x0a: AS923-3 534 534 535 - 0x0b:CN470429 +(% style="color:red" %)**Notice:** 536 536 537 - 0x0c: EU433431 +* To disable Alarm, user can set min and max to same value , such as (% style="color:#037691" %)**AT+SHTEMP=0,0.** 538 538 539 - 0x0d:KR920433 +* 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.** 540 540 541 -0x0e: MA869 542 542 543 543 544 - (%style="color:#037691"%)**Sub-Band**(%%)**:**437 +== 2.6 Trggier an uplink by external interrupt == 545 545 546 -AU915 and US915: value 0x00 ~~ 0x08 547 547 548 - CN470:value0x0B~~0x0C440 +S31-NB has an external trigger interrupt function. Users can use the PB15 pin to trigger the upload of data packets. 549 549 550 - OtherBands:Always 0x00442 +(% style="color:blue" %)**AT command:** 551 551 444 +* (% style="color:#037691" %)**AT+INTMOD **(%%) ~/~/ Set the trigger interrupt mode 552 552 553 -(% style="color:#037691" %)** BatteryInfo:**446 +* (% style="color:#037691" %)**AT+INTMOD=0 **(%%) ~/~/ Disable Interrupt 554 554 555 - Checkthebatteryvoltage.448 +* (% style="color:#037691" %)**AT+INTMOD=1 **(%%) ~/~/ Trigger by rising and falling edge 556 556 557 - Ex1:0x0B45= 2885mV450 +* (% style="color:#037691" %)**AT+INTMOD=2 **(%%) ~/~/ Trigger by falling edge 558 558 559 - Ex2:0x0B49 =2889mV452 +* (% style="color:#037691" %)**AT+INTMOD=3 **(%%) ~/~/ Trigger by rising edge 560 560 561 561 562 -= ==2.3.2Battery Info===455 += 3. Configure S31x-NB = 563 563 457 +== 3.1 Configure Methods == 564 564 565 -Check the battery voltage for DDS20-LB. 566 566 567 - Ex1: 0x0B45=2885mV460 +S31x-NB supports below configure method: 568 568 569 - Ex2:0x0B49=2889mV462 +* AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]]. 570 570 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]]. 571 571 572 -=== 2.3.3 Distance === 466 +* AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>url:http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]]. 467 +* AT Command via UART Connection : See [[UART Connection>>url:http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20NB%20ST-BC660K-GL%20base%20model%20%28for%20AT%20Commands%2C%20firmware%20upgrade%29/]]. 573 573 469 +== 3.2 General Commands == 574 574 575 -((( 576 -Get the distance. Flat object range 20mm - 2000mm. 577 -))) 578 578 579 -((( 580 -For example, if the data you get from the register is **0x06 0x05**, the distance between the sensor and the measured object is(% style="color:#4472c4" %)** ** 472 +These commands are to configure: 581 581 582 - (%style="color:blue"%)**0605(H)=1541(D) = 1541 mm.**583 - )))474 +* General system settings like: uplink interval. 475 +* LoRaWAN protocol & radio related command. 584 584 585 - * If thesensorvalue is 0x0000,itmeanssystemdoesn'tdetectultrasonicsensor.477 +They are same for all Dragino Devices which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki: 586 586 587 - * If the sensorvalue lower thanx0014 (20mm), the sensorvaluewillbe.479 +[[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/]] 588 588 589 -=== 2.3.4 Interrupt Pin === 590 590 482 +== 3.3 Commands special design for S31x-LB == 591 591 592 -This data field shows if this packet is generated by interrupt or not. 593 593 594 - **Example:**485 +These commands only valid for S31x-LB, as below: 595 595 596 -0x00: Normal uplink packet. 597 597 598 - 0x01:Interrupt UplinkPacket.488 +=== 3.3.1 Set Transmit Interval Time === 599 599 600 600 601 - === 2.3.5 DS18B20 Temperaturesensor===491 +Feature: Change LoRaWAN End Node Transmit Interval. 602 602 493 +(% style="color:blue" %)**AT Command: AT+TDC** 603 603 604 -This is optional, user can connect external DS18B20 sensor to the +3.3v, 1-wire and GND pin . and this field will report temperature. 605 - 606 -**Example**: 607 - 608 -If payload is: 0105H: (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree 609 - 610 -If payload is: FF3FH : (FF3F & FC00 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees. 611 - 612 - 613 -=== 2.3.6 Sensor Flag === 614 - 615 - 616 -((( 617 -0x01: Detect Ultrasonic Sensor 495 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 496 +|=(% 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** 497 +|(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|((( 498 +30000 499 +OK 500 +the interval is 30000ms = 30s 618 618 ))) 619 - 620 -((( 621 -0x00: No Ultrasonic Sensor 622 - 623 - 502 +|(% style="width:156px" %)AT+TDC=60000|(% style="width:137px" %)Set Transmit Interval|((( 503 +OK 504 +Set transmit interval to 60000ms = 60 seconds 624 624 ))) 625 625 626 - ==2.4 TestUplinkandChange UpdateInterval ==507 +(% style="color:blue" %)**Downlink Command: 0x01** 627 627 509 +Format: Command Code (0x01) followed by 3 bytes time value. 628 628 629 - Bydefault,Sensorwillsenduplinks(% style="color:blue"%)**every2 hours**(%%)& AT+NOUD=8511 +If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01. 630 630 631 -User can use below commands to change the (% style="color:blue" %)**uplink interval**. 513 +* Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds 514 +* Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 632 632 633 - (% style="color:#037691" %)**AT+TDC=600**(%%) ~/~/ SetUpdateIntervalto 600s516 +=== 3.3.2 Get Device Status === 634 634 635 -User can also push the button for more than 1 seconds to activate an uplink. 636 636 519 +Send a LoRaWAN downlink to ask device send Alarm settings. 637 637 638 - ==2.5 Multi-Samplings and Oneplink==521 +(% style="color:blue" %)**Downlink Payload: **(%%)0x26 01 639 639 523 +Sensor will upload Device Status via FPORT=5. See payload section for detail. 640 640 641 -To save battery life, DDS20-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: 642 642 643 - * (% style="color:#037691" %)**AT+TR=900**(%%)~/~/ Theunitis seconds, and thedefaultis torecorddata once every 900 seconds (15minutes,theminimum can beset to180 seconds)526 +=== 3.3.3 Set Temperature Alarm Threshold === 644 644 645 -* (% 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. 646 646 647 - Thediagrambelow explainsherelationshipbetweenTR,NOUD, and TDCmore clearly:529 +* (% style="color:blue" %)**AT Command:** 648 648 649 - [[image:1692424376354-959.png]]531 +(% style="color:#037691" %)**AT+SHTEMP=min,max** 650 650 533 +* When min=0, and max≠0, Alarm higher than max 534 +* When min≠0, and max=0, Alarm lower than min 535 +* When min≠0 and max≠0, Alarm higher than max or lower than min 651 651 652 - == 2.6 Trggieran uplink byexternal interrupt ==537 +Example: 653 653 539 + AT+SHTEMP=0,30 ~/~/ Alarm when temperature higher than 30. 654 654 655 - DDS20-NBhasan externaltrigger interrupt function. Users canusethe PB15 pinto trigger the uploadof data packets.541 +* (% style="color:blue" %)**Downlink Payload:** 656 656 657 -(% style="color: blue" %)**ATcommand:**543 +(% style="color:#037691" %)**0x(0C 01 00 1E)** (%%) ~/~/ Set AT+SHTEMP=0,30 658 658 659 - *(% style="color:#037691" %)**AT+INTMOD **(%%)~/~/ Set thetriggerinterruptmode545 +(% style="color:red" %)**(note: 3^^rd^^ byte= 0x00 for low limit(not set), 4^^th^^ byte = 0x1E for high limit: 30)** 660 660 661 -* (% style="color:#037691" %)**AT+INTMOD=0 **(%%) ~/~/ Disable Interrupt 662 662 663 - * (% style="color:#037691" %)**AT+INTMOD=1**(%%)~/~/ Triggerby risingandfallingedge548 +=== 3.3.4 Set Humidity Alarm Threshold === 664 664 665 -* (% style="color:#037691" %)**AT+INTMOD=2 **(%%) ~/~/ Trigger by falling edge 666 666 667 -* (% style="color: #037691" %)**AT+INTMOD=3**(%%) ~/~/ Trigger by rising edge551 +* (% style="color:blue" %)**AT Command:** 668 668 553 +(% style="color:#037691" %)**AT+SHHUM=min,max** 669 669 670 -= 3. Configure DDS20-NB = 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 671 671 672 - == 3.1 ConfigureMethods ==559 +Example: 673 673 561 + AT+SHHUM=70,0 ~/~/ Alarm when humidity lower than 70%. 674 674 675 - DDS20-NBsupports belowconfiguremethod:563 +* (% style="color:blue" %)**Downlink Payload:** 676 676 677 - *AT Command via BluetoothConnection(**Recommended**):[[BLEConfigureInstruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].565 +(% style="color:#037691" %)**0x(0C 02 46 00)**(%%) ~/~/ Set AT+SHTHUM=70,0 678 678 679 - *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]].567 +(% style="color:red" %)**(note: 3^^rd^^ byte= 0x46 for low limit (70%), 4^^th^^ byte = 0x00 for high limit (not set))** 680 680 681 -== 3.2 AT Commands Set == 682 682 570 +=== 3.3.5 Set Alarm Interval === 683 683 684 -AT+<CMD>? : Help on <CMD> 685 685 686 - AT+<CMD>: Run<CMD>573 +The shortest time of two Alarm packet. (unit: min) 687 687 688 - AT+<CMD>=<value>: Setthevalue575 +* (% style="color:blue" %)**AT Command:** 689 689 690 -AT+ <CMD>=?:Get thevalue577 +(% 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. 691 691 579 +* (% style="color:blue" %)**Downlink Payload:** 692 692 693 -(% style="color: blue" %)**GeneralCommands**581 +(% style="color:#037691" %)**0x(0D 00 1E)**(%%) **~-~--> ** Set AT+ATDC=0x 00 1E = 30 minutes 694 694 695 -AT : Attention 696 696 697 - AT?: ShortHelp584 +=== 3.3.6 Get Alarm settings === 698 698 699 -ATZ : MCU Reset 700 700 701 - AT+TDC:ApplicationDataTransmissionInterval587 +Send a LoRaWAN downlink to ask device send Alarm settings. 702 702 703 - AT+CFG: Printallconfigurations589 +* (% style="color:#037691" %)**Downlink Payload: **(%%)0x0E 01 704 704 705 - AT+CFGMOD : Workingmode selection591 +**Example:** 706 706 707 - AT+DEUI : Get or set the DeviceID593 +[[image:image-20230524110211-4.png]] 708 708 709 - AT+INTMOD : Set the trigger interrupt mode595 +**Explain:** 710 710 711 -A T+5VT:Setextendthe timeof5V power597 +* Alarm & MOD bit is 0x7C, 0x7C >> 2 = 0x31: Means this message is the Alarm settings message. 712 712 713 - AT+PRO:Chooseagreement599 +=== 3.3.7 Set Interrupt Mode === 714 714 715 -AT+RXDL : Extend the sending and receiving time 716 716 717 - AT+DNSCFG : Getor SetDNS Server602 +Feature, Set Interrupt mode for PA8 of pin. 718 718 719 -AT+ GETSENSORVALUE:Returns thecurrentsensormeasurement604 +When AT+INTMOD=0 is set, PA8 is used as a digital input port. 720 720 721 - AT+NOUD: GetSet the numberofdata tobe uploaded606 +(% style="color:blue" %)**AT Command: AT+INTMOD** 722 722 723 -AT+CDP : Read or Clear cached data 608 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 609 +|=(% 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** 610 +|(% style="width:154px" %)AT+INTMOD=?|(% style="width:196px" %)Show current interrupt mode|(% style="width:157px" %)((( 611 +0 612 +OK 613 +the mode is 0 =Disable Interrupt 614 +))) 615 +|(% style="width:154px" %)AT+INTMOD=2|(% style="width:196px" %)((( 616 +Set Transmit Interval 617 +0. (Disable Interrupt), 618 +~1. (Trigger by rising and falling edge) 619 +2. (Trigger by falling edge) 620 +3. (Trigger by rising edge) 621 +)))|(% style="width:157px" %)OK 724 724 725 - AT+SHTEMP:GetSetalarmof temp623 +(% style="color:blue" %)**Downlink Command: 0x06** 726 726 727 - AT+SHHUM:GetorSetalarmofmoisture625 +Format: Command Code (0x06) followed by 3 bytes. 728 728 729 - AT+SERVADDR:ServerAddress627 +This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06. 730 730 629 +* Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode 630 +* Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 731 731 732 - (%style="color:blue"%)**UDP Management**632 +=== 3.3.8 Set Power Output Duration === 733 733 734 -AT+CFM : Upload confirmation mode (only valid for UDP) 735 735 635 +Control the output duration 5V . Before each sampling, device will 736 736 737 - (%style="color:blue"%)**MQTTManagement**637 +~1. first enable the power output to external sensor, 738 738 739 - AT+CLIENT:Get orSetMQTTclient639 +2. keep it on as per duration, read sensor value and construct uplink payload 740 740 741 - AT+UNAME:Get orSetMQTT Username641 +3. final, close the power output. 742 742 743 - AT+PWD: GetSetMQTTpassword643 +(% style="color:blue" %)**AT Command: AT+5VT** 744 744 745 -AT+PUBTOPIC : Get or Set MQTT publish topic 645 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 646 +|=(% 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** 647 +|(% style="width:154px" %)AT+5VT=?|(% style="width:196px" %)Show 5V open time.|(% style="width:157px" %)0 (default) 648 +OK 649 +|(% style="width:154px" %)AT+5VT=1000|(% style="width:196px" %)Close after a delay of 1000 milliseconds.|(% style="width:157px" %)OK 746 746 747 - AT+SUBTOPIC: GetSetMQTT subscriptiontopic651 +(% style="color:blue" %)**Downlink Command: 0x07** 748 748 653 +Format: Command Code (0x07) followed by 2 bytes. 749 749 750 - (%style="color:blue"%)**Information**655 +The first and second bytes are the time to turn on. 751 751 752 -AT+FDR : Factory Data Reset 657 +* Example 1: Downlink Payload: 070000 **~-~-->** AT+5VT=0 658 +* Example 2: Downlink Payload: 0701F4 **~-~-->** AT+5VT=500 753 753 754 -AT+PWORD : Serial Access Password 755 - 756 -AT+LDATA : Get the last upload data 757 - 758 -AT+CDP : Read or Clear cached data 759 - 760 - 761 761 = 4. Battery & Power Consumption = 762 762 763 763 764 - DDS20-NB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.663 +S31x-LB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace. 765 765 766 766 [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] . 767 767 768 768 769 -= 5. Firmware update = 668 += 5. OTA Firmware update = 770 770 771 771 772 -User can change device firmware to:: 671 +(% class="wikigeneratedid" %) 672 +User can change firmware S31x-LB to: 773 773 674 +* Change Frequency band/ region. 774 774 * Update with new features. 775 - 776 776 * Fix bugs. 777 777 778 -Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/f hb3uyl4gt6clru/AAAiZVTFcxrfE1JOOyfcgO9ha?dl=0]]**678 +Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/fis3g6nmhv0eokg/AAC6BcCZaX4BdqZkduUvZ3jIa?dl=0]]** 779 779 680 + 780 780 Methods to Update Firmware: 781 781 782 -* (Recommended way) OTA firmware update via BLE: [[**Instruction**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/BLE_Firmware_Update_NB_Sensors_BC660K-GL/]]. 783 - 683 +* (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/]]** 784 784 * 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]]**. 785 785 786 786 = 6. FAQ = 787 787 788 -== 6.1 How can I access t BC660K-GL AT Commands? == 789 789 790 790 791 - Usercanaccess to BC660K-GL directly andsendAT Commands.690 += 7. Order Info = 792 792 793 -[[See BC660K-GL AT Command set>>url:https://www.dropbox.com/sh/5f6ssda5fum8rvs/AABT68l8ZzWOvZ5eg2qwOoFda?dl=0]] 794 794 693 +Part Number: (% style="color:blue" %)**S31-LB-XX / S31B-LB-XX** 795 795 796 - =7. TroubleShooting=695 +(% style="color:red" %)**XX**(%%): The default frequency band 797 797 798 - ==7.1Whyi always see 0x0000or0forthedistance value? ==697 +* (% style="color:red" %)**AS923**(%%): LoRaWAN AS923 band 799 799 699 +* (% style="color:red" %)**AU915**(%%): LoRaWAN AU915 band 800 800 801 -((( 802 -DDS20-LB has a strict [[**installation requirement**>>||anchor="1.5A0InstallDDS20-LB"]]. Please make sure the installation method exactly follows up with the installation requirement. Otherwise, the reading might be always 0x00. 701 +* (% style="color:red" %)**EU433**(%%): LoRaWAN EU433 band 803 803 804 -If you have followed the instruction requirement exactly but still see the 0x00 reading issue, please. please double-check the decoder, you can check the raw payload to verify. 805 -))) 703 +* (% style="color:red" %)**EU868**(%%): LoRaWAN EU868 band 806 806 807 - =8.OrderInfo=705 +* (% style="color:red" %)**KR920**(%%): LoRaWAN KR920 band 808 808 707 +* (% style="color:red" %)**US915**(%%): LoRaWAN US915 band 809 809 810 - PartNumber:(% style="color:blue" %)**DDS20-NB-XX**709 +* (% style="color:red" %)**IN865**(%%): LoRaWAN IN865 band 811 811 812 -(% style="color:red" %)** XX**(%%):711 +* (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band 813 813 814 - * (% style="color:#037691"%)**GE**(%%):General version( Exclude SIMcard)713 += 8. Packing Info = 815 815 816 -* (% style="color:#037691" %)**1D**(%%): with 1NCE* 10 years 500MB SIM card and Pre-configure to DataCake server 817 817 818 -(% style="color:#037691" %)**1NCE SIM Card NB-IoT network coverage**(%%): Austria, Belgium, Bulgaria, Croatia, Czech Republic, Denmark, Finland, Germany, Great Britain, Greece, Hungary, Ireland, Italy, Latvia, Malta, Netherlands, Norway, Puerto Rico, Russia, Slovak , Republic, Slovenia, Spain, Sweden, Switzerland, Taiwan, USA, US Virgin Islands 819 - 820 - 821 -= 9. Packing Info = 822 - 823 - 824 824 (% style="color:#037691" %)**Package Includes**: 825 825 826 -* DDS20-NBNB-IoTUltrasonicliquidlevel sensorx 1718 +* S31x-LB LoRaWAN Temperature & Humidity Sensor 827 827 828 -* External antenna x 1 829 - 830 830 (% style="color:#037691" %)**Dimension and weight**: 831 831 832 -* Device Size: 13.0 x 5 x 4.5cm722 +* Device Size: cm 833 833 834 -* Device Weight: 150g724 +* Device Weight: g 835 835 836 -* Package Size / pcs : 14.0 x 8x 5cm726 +* Package Size / pcs : cm 837 837 838 -* Weight / pcs : 180g728 +* Weight / pcs : g 839 839 840 -= 10. Support =730 += 9. Support = 841 841 842 842 843 843 * Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8. Due to different timezones we cannot offer live support. However, your questions will be answered as soon as possible in the before-mentioned schedule.
- 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