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, 3 added, 0 removed)
Details
- Page properties
-
- Title
-
... ... @@ -1,1 +1,1 @@ 1 -S 31-NB/S31B-NB_BN-IoTOutdoorTemperature& HumiditySensor User Manual1 +DDS20-NB -- NB-IoT Ultrasonic Liquid Level Sensor User Manual - Content
-
... ... @@ -1,10 +1,9 @@ 1 1 (% style="text-align:center" %) 2 -[[image:image-20230 819102136-3.png]]2 +[[image:image-20230911134259-1.png||height="570" width="570"]] 3 3 4 4 5 +**Table of Contents:** 5 5 6 -**Table of Contents:** 7 - 8 8 {{toc/}} 9 9 10 10 ... ... @@ -14,35 +14,41 @@ 14 14 15 15 = 1. Introduction = 16 16 17 -== 1.1 What is S 31x-NB NB-IoTTemperature& HumiditySensor ==16 +== 1.1 What is DDS20-NB NB-IoT Ultrasonic liquid level Sensor == 18 18 19 19 20 -The Dragino S 31-NBandS31B-NBare(% style="color:blue" %)**NB-IoTTemperatureandHumiditySensor**(%%)isused to measure thesurrounding(% style="color:blue" %)**environmenttemperatureandrelativeair humidityprecisely**(%%), andthenuploadtoIoTservervia NB-IoT network*.19 +The Dragino DDS20-NB is a (% style="color:blue" %)**NB-IoT Ultrasonic liquid level sensor**(%%) for Internet of Things solution. It uses (% style="color:blue" %)**none-contact method **(%%)to measure the (% style="color:blue" %)**height of liquid**(%%) in a container without opening the container, and send IoT platform via NB-IoT network. 21 21 22 -The temperature& humiditysensorusedinS31-NB isSHT31, which is fullycalibrated,linearized,andtemperatureompensateddigitaloutputfromSensirion,itprovidesastrongreliabilityandlong-termstability.TheSHT31 isfixedina (% style="color:blue"%)**waterproofanti-condensationcasing**(%%)forlongtermuse.21 +The DDS20-NB sensor is installed directly below the container to detect the height of the liquid level. User doesn't need to open a hole on the container to be tested. The none-contact measurement makes the measurement safety, easier and possible for some strict situation. 23 23 24 -S 31-NBsupportsdifferentuplinkmethods include(% style="color:blue" %)**TCP,MQTT, UDP**fordifferentapplicationrequirement.andSupport Uplinksto variousIoT Servers.23 +DDS20-NB uses (% style="color:blue" %)**ultrasonic sensing technology**(%%) for distance measurement. DDS20-NB is of high accuracy to measure various liquid such as: (% style="color:blue" %)**toxic substances**, **strong acids**, **strong alkalis**(%%) and (% style="color:blue" %)**various pure liquids**(%%) in high-temperature and high-pressure airtight containers. 25 25 26 -S 31-NBisweredby(% style="color:blue" %)**8500mAhLi-SOCI2battery**(%%), It is designedforlong term useuptoseveralyears. (Real-world battery life dependsonthese environment,updateperiodanduplinkmethod.Pleasecheck related PowerAnalyzeport).25 +DDS20-NB supports different uplink methods including (% style="color:blue" %)**MQTT, MQTTs, UDP & TCP**(%%) for different application requirement, and support uplinks to various IoT Servers. 27 27 28 - *make sureyouhaveNB-IoTcoveragelocally.27 +DDS20-NB (% style="color:blue" %)**supports BLE configure **(%%)and(% style="color:blue" %)** OTA update**(%%) which make user easy to use. 29 29 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 - [[image:1692411831805-116.png]]31 +DDS20-NB has optional built-in SIM card and default IoT server connection version. Which makes it works with simple configuration. 32 32 33 33 34 +[[image:image-20230911140426-2.png||height="320" width="951"]] 35 + 36 + 34 34 == 1.2 Features == 35 35 36 36 37 37 * NB-IoT Bands: B1/B2/B3/B4/B5/B8/B12/B13/B17/B18/B19/B20/B25/B28/B66/B70/B85 @H-FDD 38 38 * Ultra-low power consumption 39 -* External 3 meters SHT31 probe (For S31-NB) 40 -* Measure range -40°C ~~ 85°C 41 -* Temperature & Humidity alarm 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) 42 42 * Multiply Sampling and one uplink 43 43 * Support Bluetooth v5.1 remote configure and update firmware 44 44 * Uplink on periodically 45 45 * Downlink to change configure 50 +* IP66 Waterproof Enclosure 46 46 * 8500mAh Battery for long term use 47 47 * Nano SIM card slot for NB-IoT SIM 48 48 ... ... @@ -49,31 +49,17 @@ 49 49 == 1.3 Specification == 50 50 51 51 52 -(% style="color: #037691" %)**Common DC Characteristics:**57 +(% style="color:blue" %)**Common DC Characteristics:** 53 53 54 -* Supply Voltage: 2. 1v ~~ 3.6v59 +* Supply Voltage: 2.5v ~~ 3.6v 55 55 * Operating Temperature: -40 ~~ 85°C 56 56 57 -(% style="color: #037691" %)**TemperatureSensor:**62 +(% style="color:blue" %)**NB-IoT Spec:** 58 58 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 64 +(% style="color:#037691" %)**NB-IoT Module: BC660K-GL** 63 63 64 -(% style="color:#037691" %)** HumiditySensor:66 +(% style="color:#037691" %)**Support Bands:** 65 65 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 - 77 77 * B1 @H-FDD: 2100MHz 78 78 * B2 @H-FDD: 1900MHz 79 79 * B3 @H-FDD: 1800MHz ... ... @@ -92,7 +92,7 @@ 92 92 * B70 @H-FDD: 2000MHz 93 93 * B85 @H-FDD: 700MHz 94 94 95 -(% style="color: #037691" %)**Battery:**86 +(% style="color:blue" %)**Battery:** 96 96 97 97 * Li/SOCI2 un-chargeable battery 98 98 * Capacity: 8500mAh ... ... @@ -100,33 +100,151 @@ 100 100 * Max continuously current: 130mA 101 101 * Max boost current: 2A, 1 second 102 102 103 -(% style="color: #037691" %)**Power Consumption**94 +(% style="color:blue" %)**Power Consumption** 104 104 105 105 * STOP Mode: 10uA @ 3.3v 106 106 * Max transmit power: 350mA@3.3v 107 107 108 -== 1.4 Applications==99 +== 1.4 Suitable Container & Liquid == 109 109 110 110 111 -* S martBuildings& HomeAutomation112 -* LogisticsandSupplyChainManagement113 -* SmartMetering114 -* SmartAgriculture115 -* SmartCities116 -* SmartFactory102 +* Solid Wall container such as: steel, iron, glass, ceramics, non-foaming plastics etc. 103 +* Container shape is regular, and surface is smooth. 104 +* Container Thickness: 105 +** Pure metal material. 2~~8mm, best is 3~~5mm 106 +** Pure non metal material: <10 mm 107 +* Pure liquid without irregular deposition. 117 117 118 - ==1.5 Sleep modeand working mode==109 +(% style="display:none" %) 119 119 111 +== 1.5 Install DDS20-NB == 120 120 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 + 121 121 (% 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. 122 122 123 123 (% 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. 124 124 125 125 236 +== 1.9 Button & LEDs == 126 126 127 -== 1.6 Button & LEDs == 128 128 129 - 130 130 [[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675071855856-879.png]] 131 131 132 132 ... ... @@ -143,10 +143,10 @@ 143 143 ))) 144 144 |(% 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. 145 145 146 -== 1. 7BLE connection ==255 +== 1.10 BLE connection == 147 147 148 148 149 -S 31x-NB support BLE remote configure and firmware update.258 +DDS20-NB support BLE remote configure and firmware update. 150 150 151 151 152 152 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: ... ... @@ -158,122 +158,114 @@ 158 158 If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode. 159 159 160 160 161 -== 1. 8Pin Definitions & Switch ==270 +== 1.11 Pin Definitions & Switch == 162 162 163 163 164 -S31x-NB use the mother board from S31-NB which as below. 165 - 166 166 [[image:image-20230819104805-5.png]] 167 167 168 168 276 +=== 1.11.1 Jumper JP2 === 169 169 170 -=== 1.8.1 Jumper JP2 === 171 171 172 - 173 173 Power on Device when put this jumper. 174 174 175 175 176 -=== 1. 8.2 BOOT MODE / SW1 ===282 +=== 1.11.2 BOOT MODE / SW1 === 177 177 178 178 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. 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. 180 180 181 -2) (% style="color:blue" %)**Flash**(%%): work mode, device starts to work and send out console output for further debug 287 +**2)** (% style="color:blue" %)**Flash**(%%): work mode, device starts to work and send out console output for further debug 182 182 183 183 184 -=== 1. 8.3 Reset Button ===290 +=== 1.11.3 Reset Button === 185 185 186 186 187 187 Press to reboot the device. 188 188 295 +(% style="display:none" %) 189 189 190 190 191 -== 1. 9 HardwareVariant==298 +== 1.12 Mechanical == 192 192 193 193 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 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"]] 203 203 204 - Cableength :3303 +[[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"]] 205 205 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 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"]] 215 215 216 -Installed in device. 217 -))) 218 218 219 -(% style=" display:none" %)308 +(% style="color:blue" %)**Probe Mechanical:** 220 220 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"]] 221 221 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"]] 222 222 223 223 224 -= 2. Use S 31-NB to communicate with IoT Server =315 += 2. Use DDS20-NB to communicate with IoT Server = 225 225 226 226 == 2.1 Send data to IoT server via NB-IoT network == 227 227 228 228 229 -The S 31-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.320 +The DDS20-NB is equipped with a NB-IoT module, the pre-loaded firmware in DDS20-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 DDS20-NB. 230 230 231 231 232 232 Below shows the network structure: 233 233 234 -[[image:1692 415924540-357.png]]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"]] 235 235 236 236 237 -There are two version: (% style="color:blue" %)**-GE**(%%) and (% style="color:blue" %)**-1D**(%%) version of S 31-NB.328 +There are two version: (% style="color:blue" %)**-GE**(%%) and (% style="color:blue" %)**-1D**(%%) version of DDS20-NB. 238 238 239 239 240 -(% style="color:blue" %)**GE Version**(%%): This version doesn ’t include SIM card or point to any IoT server. User needs to use AT Commands to configure below two steps to set S31-NB send data to IoT server.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 set DDS20-NB send data to IoT server. 241 241 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]].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]]. 243 243 244 - 1.Set up sensor to point to IoT Server. See instruction of [[Configure to Connect Different Servers>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.Configuretoconnecttodifferentservers]].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]]. 245 245 246 246 Below shows result of different server as a glance. 247 247 248 - 249 249 (% border="1" cellspacing="4" style="width:515px" %) 250 250 |(% style="background-color:#4f81bd; color:white; width:100px" %)**Servers**|(% style="background-color:#4f81bd; color:white; width:300px" %)**Dash Board**|(% style="background-color:#4f81bd; color:white; width:115px" %)**Comments** 251 -|(% style="width:127px" %)[[Node-Red>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.5A0Node-RedA028viaA0MQTT29]]|(% style="width:385px" %)[[image:image-20230819113244-8.png||height="183" width="367"]]|(% style="width:170px" %) 252 -|(% style="width:127px" %)[[DataCake>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.4Datacake]]|(% style="width:385px" %)[[image:image-20230819113244-9.png||height="120" width="369"]]|(% style="width:170px" %) 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" %) 253 253 |(% style="width:127px" %)[[Tago.IO>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.7A0Tago.ioA028viaA0MQTT29]]|(% style="width:385px" %) |(% style="width:170px" %) 254 254 |(% style="width:127px" %)[[General UDP>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.1GeneralA0UDPA0Connection]]|(% style="width:385px" %)Raw Payload. Need Developer to design Dash Board|(% style="width:170px" %) 255 255 |(% style="width:127px" %)[[General MQTT>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.2GeneralA0MQTTA0Connection]]|(% style="width:385px" %)Raw Payload. Need Developer to design Dash Board|(% style="width:170px" %) 256 -|(% style="width:127px" %)[[ThingSpeak>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.3A0ThingSpeakA028viaA0MQTT29]]|(% style="width:385px" %)[[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" %) 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" %) 259 259 260 -(% style="color:blue" %)**1D Version**(%%): This version has 1NCE SIM card pre-installed and configure to send value to DataCake. User Just need to select the sensor type in DataCake and Activate S 31-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]].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]]. 261 261 262 262 263 263 == 2.2 Payload Types == 264 264 265 265 266 -To meet different server requirement, S 31-NB supports different payload type.367 +To meet different server requirement, DDS20-NB supports different payload type. 267 267 268 268 **Includes:** 269 269 270 -* [[General JSON format payload>> path:#General_Json]]. (Type=5)371 +* [[General JSON format payload>>||anchor="H2.2.1GeneralJsonFormat28Type3D529"]]. (Type=5) 271 271 272 -* [[HEX format Payload>> path:#HEX_Payload]]. (Type=0)373 +* [[HEX format Payload>>||anchor="H2.2.2HEXformatPayload28Type3D029"]]. (Type=0) 273 273 274 -* [[ThingSpeak Format>> path:#ThingSpeak_Payload]]. (Type=1)375 +* [[ThingSpeak Format>>||anchor="H2.2.4ThingSpeakPayload28Type3D129"]]. (Type=1) 275 275 276 -* [[ThingsBoard Format>> path:#ThingsBoard_Payload]]. (Type=3)377 +* [[ThingsBoard Format>>||anchor="H2.2.3ThingsBoardPayload28Type3D329"]]. (Type=3) 277 277 278 278 User can specify the payload type when choose the connection protocol. Example: 279 279 ... ... @@ -284,12 +284,12 @@ 284 284 (% style="color:#037691" %)**AT+PRO=3,5 ** (%%) ~/~/ Use MQTT Connection & Json Payload 285 285 286 286 287 -=== 2.2.1 General Json Format 388 +=== 2.2.1 General Json Format(Type~=5) === 288 288 289 289 290 290 This is the General Json Format. As below: 291 291 292 -(% style="color:#4472c4" %)**{"IMEI":866207053462762,"temperature":29.2,"humidity":54.2,"battery":3.27,"signal":24,"Model":S 31x-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}}**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}}** 293 293 294 294 295 295 (% style="color:red" %)**Notice, from above payload:** ... ... @@ -298,7 +298,6 @@ 298 298 299 299 * Json entry 1 ~~ 8 are the last 1 ~~ 8 sampling data as specify by (% style="color:#037691" %)**AT+NOUD=8 ** (%%)Command. Each entry includes (from left to right): Temperature, Humidity, Sampling time. 300 300 301 - 302 302 === 2.2.2 HEX format Payload(Type~=0) === 303 303 304 304 ... ... @@ -313,7 +313,7 @@ 313 313 314 314 These bytes include the hardware and software version. 315 315 316 -(% style="color:#037691" %)**Higher byte:**(%%) Specify Sensor Model: 0x00 for S 31B-NB& S31-NB416 +(% style="color:#037691" %)**Higher byte:**(%%) Specify Sensor Model: 0x00 for DDS20-NB 317 317 318 318 (% style="color:#037691" %)**Lower byte:**(%%) Specify the software version: 0x64=100, means firmware version 100 319 319 ... ... @@ -340,21 +340,6 @@ 340 340 **99** Not known or not detectable 341 341 342 342 343 -(% style="color:blue" %)**Temperature: ** 344 - 345 -If payload is: 0105H: (0105 & 8000 == 0), temp = 0105H /10 = 26.1 degree 346 - 347 -If payload is: FF3FH : (FF3F & 8000 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees. 348 - 349 -(FF3F & 8000:Judge whether the highest bit is 1, when the highest bit is 1, it is negative) 350 - 351 - 352 - 353 -(% style="color:blue" %)**Humidity: ** 354 - 355 -Read:0295(H)=661(D) Value: 661 / 10=66.1, So 66.1% 356 - 357 - 358 358 (% style="color:blue" %)**TimeStamp: ** 359 359 360 360 Unit TimeStamp Example: 64d49439(H) = 1691653177(D) ... ... @@ -367,7 +367,6 @@ 367 367 368 368 Type3 payload special design for ThingsBoard, it will also configure other default server to ThingsBoard. 369 369 370 - 371 371 (% style="color:#4472c4" %)**{"IMEI":866207053462762,"temperature":29.2,"humidity":54.2,"battery":3.27,"signal":24}** 372 372 373 373 ... ... @@ -378,365 +378,382 @@ 378 378 379 379 Temperature, Humidity, Battery & Signal. This payload type only valid for ThingsSpeak Platform 380 380 381 - 382 382 As below: 383 383 384 384 (% style="color:#4472c4" %)**field1=27.9&field2=49.9&field3=3.23&field4=28** 385 385 469 +== 2.3 Uplink Payload == 386 386 387 -== 2.3 Test Uplink and Change Update Interval == 388 388 472 +((( 473 +DDS20-NB will uplink payload via LoRaWAN with below payload format: 474 +))) 389 389 390 -By default, Sensor will send uplinks (% style="color:blue" %)**every 2 hours**(%%) & AT+NOUD=8 476 +((( 477 +Uplink payload includes in total 8 bytes. 478 +))) 391 391 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"]] 392 392 393 - Userusebelow commandstochangethe(% style="color:blue"%)**uplinkinterval**.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"]] 394 394 395 -(% style="color:#037691" %)**AT+TDC=600 ** (%%) ~/~/ Set Update Interval to 600s 396 396 492 +=== 2.3.1 Device Status, FPORT~=5 === 397 397 398 -User can also push the button for more than 1 seconds to activate an uplink. 399 399 495 +((( 496 +Users can use the downlink command(**0x26 01**) to ask DDS20-NB to send device configure detail, include device configure status. DDS20-NB will uplink a payload via FPort=5 to server. 400 400 498 +The Payload format is as below. 499 +))) 401 401 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 402 403 - == 2.4 Multi-SamplingsOneplink==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 404 405 405 406 - Tosave batteryife, S31-NB will sample temperature & humidity data every15minutes andsendoneuplinkevery 2 hours.Soeachuplink it will include 8storeddata + 1 real-timedata. They are definedby:509 +(% style="color:#037691" %)**Sensor Model**(%%)**:** For DDS20-NB, this value is 0x29 407 407 408 - *(% style="color:#037691" %)**AT+TR=900** (%%) ~/~/ The unit is seconds,and the default is torecorddata onceevery 900seconds(15minutes,theminimum canbesetto180seconds)511 +(% style="color:#037691" %)**Firmware Version**(%%)**:** 0x0100, Means: v1.0.0 version 409 409 410 - *(% style="color:#037691" %)**AT+NOUD=8** (%%)~/~/ Thedeviceuploads 8 sets of recorded data bydefault. Up to 32 sets of record data canbe uploaded.513 +(% style="color:#037691" %)**Frequency Band**(%%)**:** 411 411 412 - The diagram below explainsthe relationship between TR, NOUD, and TDC more clearly:515 +0x01: EU868 413 413 414 - [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image001.png||alt="IMG_256"]]517 +0x02: US915 415 415 519 +0x03: IN865 416 416 417 - ==2.5Humidity and Temperature alarm function ==521 +0x04: AU915 418 418 523 +0x05: KZ865 419 419 420 - On each sampling define by AT+TR ( default 900sor 15 minutes), when the value exceed the range, it will trigger an Alarm and immediately sends a uplink.525 +0x06: RU864 421 421 527 +0x07: AS923 422 422 423 - (% style="color:blue"%)**AT Commands:**529 +0x08: AS923-1 424 424 425 - (% style="color:#037691"%)**AT+SHHUM=min,max**531 +0x09: AS923-2 426 426 427 - Example: AT+SHHUM=50,80 ~/~/ Alarm when humidity lower than 50 or higher than 80.533 +0x0a: AS923-3 428 428 535 +0x0b: CN470 429 429 430 - (% style="color:#037691"%)**AT+ SHTEMP=min,max**537 +0x0c: EU433 431 431 432 - Example:AT+ SHTEMP=20,30 ~/~/ Alarm when temperature lower than 20 or higher than 30539 +0x0d: KR920 433 433 541 +0x0e: MA869 434 434 435 -(% style="color:red" %)**Notice:** 436 436 437 - * To disable Alarm, user can set min and max to same value , such as(% style="color:#037691" %)**AT+SHTEMP=0,0.**544 +(% style="color:#037691" %)**Sub-Band**(%%)**:** 438 438 439 - *If user only want to sendonlymin or max, user can set the alarm to avaluethat device won’t reach. For example:(%style="color:#037691" %)**AT+SHTEMP=-80,0.**546 +AU915 and US915: value 0x00 ~~ 0x08 440 440 548 +CN470: value 0x0B ~~ 0x0C 441 441 550 +Other Bands: Always 0x00 442 442 443 443 444 - ==2.6 Trggier an uplink by external interrupt==553 +(% style="color:#037691" %)**Battery Info:** 445 445 555 +Check the battery voltage. 446 446 447 - S31-NBhas an external trigger interrupt function. Users can use the PB15pinto trigger the upload of data packets.557 +Ex1: 0x0B45 = 2885mV 448 448 449 - (% style="color:blue"%)**ATcommand:**559 +Ex2: 0x0B49 = 2889mV 450 450 451 -* (% style="color:#037691" %)**AT+INTMOD **(%%) ~/~/ Set the trigger interrupt mode 452 452 453 - * (% style="color:#037691" %)**AT+INTMOD=0**(%%)~/~/Disable Interrupt562 +=== 2.3.2 Battery Info === 454 454 455 -* (% style="color:#037691" %)**AT+INTMOD=1 **(%%) ~/~/Trigger by rising and falling edge 456 456 457 - * (% style="color:#037691"%)**AT+INTMOD=2 **(%%) ~/~/Triggerbyfallingdge565 +Check the battery voltage for DDS20-NB. 458 458 459 - * (% style="color:#037691"%)**AT+INTMOD=3**(%%) ~/~/Trigger by rising edge567 +Ex1: 0x0B45 = 2885mV 460 460 569 +Ex2: 0x0B49 = 2889mV 461 461 462 462 463 -= 3. ConfigureS31x-NB=572 +=== 2.3.3 Distance === 464 464 465 -== 3.1 Configure Methods == 466 466 575 +((( 576 +Get the distance. Flat object range 20mm - 2000mm. 577 +))) 467 467 468 -S31x-NB supports below configure method: 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" %)** ** 469 469 470 -* AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]]. 582 +(% style="color:blue" %)**0605(H) = 1541 (D) = 1541 mm.** 583 +))) 471 471 472 -* ATCommand via UART Connection : See[[UART Connection>>http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H2.3UARTConnectionforSN50v3basemotherboard]].585 +* If the sensor value is 0x0000, it means system doesn't detect ultrasonic sensor. 473 473 474 -* LoRaWANDownlink.Instruction fordifferentplatforms:See[[IoTLoRaWANServer>>http://wiki.dragino.com/xwiki/bin/view/Main/]]section.587 +* If the sensor value lower than 0x0014 (20mm), the sensor value will be invalid. 475 475 589 +=== 2.3.4 Interrupt Pin === 476 476 477 477 478 - ==3.2GeneralCommands==592 +This data field shows if this packet is generated by interrupt or not. 479 479 594 +**Example:** 480 480 481 - Thesecommandsare toconfigure:596 +0x00: Normal uplink packet. 482 482 483 -* General system settings like: uplink interval. 484 -* LoRaWAN protocol & radio related command. 598 +0x01: Interrupt Uplink Packet. 485 485 486 -They are same for all Dragino Devices which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki: 487 487 488 - [[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/]]601 +=== 2.3.5 DS18B20 Temperature sensor === 489 489 490 490 491 - ==3.3CommandsspecialdesignforS31x-LB==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. 492 492 606 +**Example**: 493 493 494 - Thesecommandsonly validforS31x-LB,asbelow:608 +If payload is: 0105H: (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree 495 495 610 +If payload is: FF3FH : (FF3F & FC00 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees. 496 496 497 -=== 3.3.1 Set Transmit Interval Time === 498 498 613 +=== 2.3.6 Sensor Flag === 499 499 500 -Feature: Change LoRaWAN End Node Transmit Interval. 501 501 502 -(% style="color:blue" %)**AT Command: AT+TDC** 616 +((( 617 +0x01: Detect Ultrasonic Sensor 618 +))) 503 503 504 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 505 -|=(% 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** 506 -|(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|((( 507 -30000 508 -OK 509 -the interval is 30000ms = 30s 620 +((( 621 +0x00: No Ultrasonic Sensor 622 + 623 + 510 510 ))) 511 -|(% style="width:156px" %)AT+TDC=60000|(% style="width:137px" %)Set Transmit Interval|((( 512 -OK 513 -Set transmit interval to 60000ms = 60 seconds 514 -))) 515 515 516 - (%style="color:blue"%)**Downlink Command:0x01**626 +== 2.4 Test Uplink and Change Update Interval == 517 517 518 -Format: Command Code (0x01) followed by 3 bytes time value. 519 519 520 - Ifthedownlink payload=0100003C,it means set the END Node'sTransmitIntervalto0x00003C=60(S), whiletypecodeis01.629 +By default, Sensor will send uplinks (% style="color:blue" %)**every 2 hours**(%%) & AT+NOUD=8 521 521 522 -* Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds 523 -* Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 631 +User can use below commands to change the (% style="color:blue" %)**uplink interval**. 524 524 525 -== =3.3.2GetDeviceStatus===633 +(% style="color:#037691" %)**AT+TDC=600 ** (%%) ~/~/ Set Update Interval to 600s 526 526 635 +User can also push the button for more than 1 seconds to activate an uplink. 527 527 528 -Send a LoRaWAN downlink to ask device send Alarm settings. 529 529 530 - (% style="color:blue"%)**DownlinkPayload:**(%%)0x2601638 +== 2.5 Multi-Samplings and One uplink == 531 531 532 -Sensor will upload Device Status via FPORT=5. See payload section for detail. 533 533 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: 534 534 535 -== =3.3.3SetTemperatureAlarmThreshold===643 +* (% 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) 536 536 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. 537 537 538 - *(%style="color:blue"%)**ATCommand:**647 +The diagram below explains the relationship between TR, NOUD, and TDC more clearly: 539 539 540 - (% style="color:#037691" %)**AT+SHTEMP=min,max**649 +[[image:1692424376354-959.png]] 541 541 542 -* When min=0, and max≠0, Alarm higher than max 543 -* When min≠0, and max=0, Alarm lower than min 544 -* When min≠0 and max≠0, Alarm higher than max or lower than min 545 545 546 - Example:652 +== 2.6 Trggier an uplink by external interrupt == 547 547 548 - AT+SHTEMP=0,30 ~/~/ Alarm when temperature higher than 30. 549 549 550 - *(%style="color:blue"%)**DownlinkPayload:**655 +DDS20-NB has an external trigger interrupt function. Users can use the PB15 pin to trigger the upload of data packets. 551 551 552 -(% style="color: #037691" %)**0x(0C01 00 1E)**(%%) ~/~/ Set AT+SHTEMP=0,30657 +(% style="color:blue" %)**AT command:** 553 553 554 -(% style="color: red" %)**(note:3^^rd^^byte=0x00forlowlimit(notset),4^^th^^ byte= 0x1E forhighlimit:30)**659 +* (% style="color:#037691" %)**AT+INTMOD **(%%) ~/~/ Set the trigger interrupt mode 555 555 661 +* (% style="color:#037691" %)**AT+INTMOD=0 **(%%) ~/~/ Disable Interrupt 556 556 557 - ===3.3.4SetHumidityAlarmThreshold===663 +* (% style="color:#037691" %)**AT+INTMOD=1 **(%%) ~/~/ Trigger by rising and falling edge 558 558 665 +* (% style="color:#037691" %)**AT+INTMOD=2 **(%%) ~/~/ Trigger by falling edge 559 559 560 -* (% style="color: blue" %)**ATCommand:**667 +* (% style="color:#037691" %)**AT+INTMOD=3 **(%%) ~/~/ Trigger by rising edge 561 561 562 -(% style="color:#037691" %)**AT+SHHUM=min,max** 563 563 564 -* When min=0, and max≠0, Alarm higher than max 565 -* When min≠0, and max=0, Alarm lower than min 566 -* When min≠0 and max≠0, Alarm higher than max or lower than min 670 += 3. Configure DDS20-NB = 567 567 568 - Example:672 +== 3.1 Configure Methods == 569 569 570 - AT+SHHUM=70,0 ~/~/ Alarm when humidity lower than 70%. 571 571 572 - *(%style="color:blue" %)**DownlinkPayload:**675 +DDS20-NB supports below configure method: 573 573 574 - (%style="color:#037691"%)**0x(0C02 46 00)**(%%)~/~/Set AT+SHTHUM=70,0677 +* AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]]. 575 575 576 - (%style="color:red"%)**(note:3^^rd^^byte=0x46forlow limit (70%),4^^th^^byte=0x00 for highlimit(notset))**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]]. 577 577 681 +== 3.2 AT Commands Set == 578 578 579 -=== 3.3.5 Set Alarm Interval === 580 580 684 +AT+<CMD>? : Help on <CMD> 581 581 582 -T heshortesttimeoftwoAlarmpacket.(unit:min)686 +AT+<CMD> : Run <CMD> 583 583 584 - * (% style="color:blue"%)**ATCommand:**688 +AT+<CMD>=<value> : Set the value 585 585 586 - (% style="color:#037691" %)**AT+ATDC=30**(%%)~/~/ Theshortestinterval of two Alarm packets is 30 minutes, Means is thereisan alarm packetuplink, there won't be another one in the next 30 minutes.690 +AT+<CMD>=? : Get the value 587 587 588 -* (% style="color:blue" %)**Downlink Payload:** 589 589 590 -(% style="color: #037691" %)**0x(0D00 1E)**(%%)**~-~--> ** Set AT+ATDC=0x 00 1E = 30 minutes693 +(% style="color:blue" %)**General Commands** 591 591 695 +AT : Attention 592 592 593 - ===3.3.6GetAlarmsettings===697 +AT? : Short Help 594 594 699 +ATZ : MCU Reset 595 595 596 - SendaLoRaWANdownlinktoaskdevicesendAlarmettings.701 +AT+TDC : Application Data Transmission Interval 597 597 598 - *(%style="color:#037691"%)**DownlinkPayload: **(%%)0x0E 01703 +AT+CFG : Print all configurations 599 599 600 - **Example:**705 +AT+CFGMOD : Working mode selection 601 601 602 - [[image:image-20230524110211-4.png]]707 +AT+DEUI : Get or set the Device ID 603 603 604 - **Explain:**709 +AT+INTMOD : Set the trigger interrupt mode 605 605 606 - *Alarm&MOD bitis 0x7C, 0x7C >> 2 = 0x31: Meansthis messageistheAlarmsettingsmessage.711 +AT+5VT : Set extend the time of 5V power 607 607 608 - ===3.3.7SetInterrupt Mode===713 +AT+PRO : Choose agreement 609 609 715 +AT+RXDL : Extend the sending and receiving time 610 610 611 -Fe ature,SetInterrupt modeforPA8 of pin.717 +AT+DNSCFG : Get or Set DNS Server 612 612 613 - WhenAT+INTMOD=0isset, PA8 isusedas a digitalinputport.719 +AT+GETSENSORVALUE : Returns the current sensor measurement 614 614 615 - (%style="color:blue"%)**ATCommand: AT+INTMOD**721 +AT+NOUD : Get or Set the number of data to be uploaded 616 616 617 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 618 -|=(% 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** 619 -|(% style="width:154px" %)AT+INTMOD=?|(% style="width:196px" %)Show current interrupt mode|(% style="width:157px" %)((( 620 -0 621 -OK 622 -the mode is 0 =Disable Interrupt 623 -))) 624 -|(% style="width:154px" %)AT+INTMOD=2|(% style="width:196px" %)((( 625 -Set Transmit Interval 626 -0. (Disable Interrupt), 627 -~1. (Trigger by rising and falling edge) 628 -2. (Trigger by falling edge) 629 -3. (Trigger by rising edge) 630 -)))|(% style="width:157px" %)OK 723 +AT+CDP : Read or Clear cached data 631 631 632 - (%style="color:blue"%)**DownlinkCommand:0x06**725 +AT+SHTEMP: Get or Set alarm of temp 633 633 634 - Format:CommandCode(0x06) followedby3bytes.727 +AT+SHHUM: Get or Set alarm of moisture 635 635 636 -T hismeansthattheinterruptmode of the endnode is set to 0x000003=3 (risingedge trigger), and the type code is06.729 +AT+SERVADDR : Server Address 637 637 638 -* Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode 639 -* Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 640 640 641 - ===3.3.8 SetPowerOutputDuration===732 +(% style="color:blue" %)**UDP Management** 642 642 734 +AT+CFM : Upload confirmation mode (only valid for UDP) 643 643 644 -Control the output duration 5V . Before each sampling, device will 645 645 646 - ~1.firstenablethe poweroutputtoexternal sensor,737 +(% style="color:blue" %)**MQTT Management** 647 647 648 - 2.keepit on as per duration,read sensorvalueandconstruct uplink payload739 +AT+CLIENT : Get or Set MQTT client 649 649 650 - 3.final,closehepoweroutput.741 +AT+UNAME : Get or Set MQTT Username 651 651 652 - (%style="color:blue"%)**ATCommand: AT+5VT**743 +AT+PWD : Get or Set MQTT password 653 653 654 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 655 -|=(% 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** 656 -|(% style="width:154px" %)AT+5VT=?|(% style="width:196px" %)Show 5V open time.|(% style="width:157px" %)0 (default) 657 -OK 658 -|(% style="width:154px" %)AT+5VT=1000|(% style="width:196px" %)Close after a delay of 1000 milliseconds.|(% style="width:157px" %)OK 745 +AT+PUBTOPIC : Get or Set MQTT publish topic 659 659 660 - (%style="color:blue"%)**DownlinkCommand:0x07**747 +AT+SUBTOPIC : Get or Set MQTT subscription topic 661 661 662 -Format: Command Code (0x07) followed by 2 bytes. 663 663 664 - Thefirstand secondbytesare the timetoturnon.750 +(% style="color:blue" %)**Information** 665 665 666 -* Example 1: Downlink Payload: 070000 **~-~-->** AT+5VT=0 667 -* Example 2: Downlink Payload: 0701F4 **~-~-->** AT+5VT=500 752 +AT+FDR : Factory Data Reset 668 668 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 + 669 669 = 4. Battery & Power Consumption = 670 670 671 671 672 -S 31x-LB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.764 +DDS20-NB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace. 673 673 674 674 [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] . 675 675 676 676 677 -= 5. OTAFirmware update =769 += 5. Firmware update = 678 678 679 679 680 -(% class="wikigeneratedid" %) 681 -User can change firmware S31x-LB to: 772 +User can change device firmware to:: 682 682 683 -* Change Frequency band/ region. 684 684 * Update with new features. 775 + 685 685 * Fix bugs. 686 686 687 -Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/f is3g6nmhv0eokg/AAC6BcCZaX4BdqZkduUvZ3jIa?dl=0]]**778 +Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/fhb3uyl4gt6clru/AAAiZVTFcxrfE1JOOyfcgO9ha?dl=0]]** 688 688 689 - 690 690 Methods to Update Firmware: 691 691 692 -* (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/]]** 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 + 693 693 * 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]]**. 694 694 695 695 = 6. FAQ = 696 696 788 +== 6.1 How can I access t BC660K-GL AT Commands? == 697 697 698 698 699 - =7.OrderInfo=791 +User can access to BC660K-GL directly and send AT Commands. 700 700 793 +[[See BC660K-GL AT Command set>>url:https://www.dropbox.com/sh/5f6ssda5fum8rvs/AABT68l8ZzWOvZ5eg2qwOoFda?dl=0]] 701 701 702 -Part Number: (% style="color:blue" %)**S31-LB-XX / S31B-LB-XX** 703 703 704 - (% style="color:red"%)**XX**(%%):The default frequencyband796 += 7. Trouble Shooting = 705 705 706 - *(%style="color:red"%)**AS923**(%%):LoRaWANAS923band798 +== 7.1 Why i always see 0x0000 or 0 for the distance value? == 707 707 708 -* (% style="color:red" %)**AU915**(%%): LoRaWAN AU915 band 709 709 710 -* (% style="color:red" %)**EU433**(%%): LoRaWAN EU433 band 801 +((( 802 +DDS20-NB has a strict [[**installation requirement**>>||anchor="H1.5A0InstallDDS20-NB"]]. Please make sure the installation method exactly follows up with the installation requirement. Otherwise, the reading might be always 0x00. 711 711 712 -* (% style="color:red" %)**EU868**(%%): LoRaWAN EU868 band 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 +))) 713 713 714 - *(%style="color:red"%)**KR920**(%%): LoRaWANKR920 band807 += 8. Order Info = 715 715 716 -* (% style="color:red" %)**US915**(%%): LoRaWAN US915 band 717 717 718 - *(% style="color:red" %)**IN865**(%%): LoRaWAN IN865 band810 +Part Number: (% style="color:blue" %)**DDS20-NB-XX** 719 719 720 - *(% style="color:red" %)**CN470**(%%):LoRaWAN CN470 band812 +(% style="color:red" %)**XX**(%%): 721 721 722 -= 8.PackingInfo=814 +* (% style="color:#037691" %)**GE**(%%): General version ( Exclude SIM card) 723 723 816 +* (% style="color:#037691" %)**1D**(%%): with 1NCE* 10 years 500MB SIM card and Pre-configure to DataCake server 724 724 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 + 725 725 (% style="color:#037691" %)**Package Includes**: 726 726 727 -* S 31x-LBLoRaWANemperature& HumiditySensor826 +* DDS20-NB NB-IoT Ultrasonic liquid level sensor x 1 728 728 828 +* External antenna x 1 829 + 729 729 (% style="color:#037691" %)**Dimension and weight**: 730 730 731 -* Device Size: cm 832 +* Device Size: 13.0 x 5 x 4.5 cm 732 732 733 -* Device Weight: g 834 +* Device Weight: 150g 734 734 735 -* Package Size / pcs : cm 836 +* Package Size / pcs : 14.0 x 8x 5 cm 736 736 737 -* Weight / pcs : g 838 +* Weight / pcs : 180g 738 738 739 -= 9. Support =840 += 10. Support = 740 740 741 741 742 742 * 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.
- 1692424376354-959.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +146.1 KB - Content
- image-20230911134259-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +236.5 KB - Content
- image-20230911140426-2.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +121.6 KB - Content