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, 2 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,8 +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 - 303 303 === 2.2.2 HEX format Payload(Type~=0) === 304 304 305 305 ... ... @@ -314,7 +314,7 @@ 314 314 315 315 These bytes include the hardware and software version. 316 316 317 -(% 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 318 318 319 319 (% style="color:#037691" %)**Lower byte:**(%%) Specify the software version: 0x64=100, means firmware version 100 320 320 ... ... @@ -341,20 +341,6 @@ 341 341 **99** Not known or not detectable 342 342 343 343 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 - 358 358 (% style="color:blue" %)**TimeStamp: ** 359 359 360 360 Unit TimeStamp Example: 64d49439(H) = 1691653177(D) ... ... @@ -381,351 +381,364 @@ 381 381 382 382 (% style="color:#4472c4" %)**field1=27.9&field2=49.9&field3=3.23&field4=28** 383 383 469 +== 2.3 Uplink Payload == 384 384 385 -== 2.3 Test Uplink and Change Update Interval == 386 386 472 +((( 473 +DDS20-LB will uplink payload via LoRaWAN with below payload format: 474 +))) 387 387 388 -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 +))) 389 389 390 -User can use below commands to change the (% style="color:blue" %)**uplink interval**. 480 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %) 481 +|=(% style="width: 95px; background-color:#D9E2F3;color:#0070C0" %)(% style="display:none" %) (%%)Size(bytes)|=(% style="width: 61px; background-color:#D9E2F3;color:#0070C0" %)2|=(% style="background-color:#D9E2F3;color:#0070C0" %)2|=(% style="background-color:#D9E2F3;color:#0070C0" %)1|=(% style="background-color:#D9E2F3;color:#0070C0" %)2|=(% style="background-color:#D9E2F3;color:#0070C0" %)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"]] 391 391 392 - (% style="color:#037691" %)**AT+TDC=600 ** (%%) ~/~/ Set Update Intervalto600s489 +[[image:微信截图_20230702135733.png||height="215" width="964"]] 393 393 394 -User can also push the button for more than 1 seconds to activate an uplink. 395 395 492 +=== 2.3.1 Device Status, FPORT~=5 === 396 396 397 -== 2.4 Multi-Samplings and One uplink == 398 398 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. 399 399 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: 498 +The Payload format is as below. 499 +))) 401 401 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) 501 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:490px" %) 502 +|=(% colspan="6" style="background-color:#D9E2F3;color:#0070C0" %)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 403 403 404 - * (% style="color:#037691" %)**AT+NOUD=8** (%%)~/~/ Thedevice uploads 8 sets of recorded data by default. Up to 32sets of recorddata can be uploaded.506 +[[image:DDS20.png||height="241" width="1336"]] 405 405 406 -The diagram below explains the relationship between TR, NOUD, and TDC more clearly: 407 407 408 - [[image:1692424376354-959.png]]509 +(% style="color:#037691" %)**Sensor Model**(%%)**:** For DDS20-LB, this value is 0x29 409 409 511 +(% style="color:#037691" %)**Firmware Version**(%%)**:** 0x0100, Means: v1.0.0 version 410 410 411 - ==2.5 Humidityand Temperature alarmfunction==513 +(% style="color:#037691" %)**Frequency Band**(%%)**:** 412 412 515 +0x01: EU868 413 413 414 - On each sampling define by AT+TR ( default 900sor15minutes), when the value exceed the range, it will trigger an Alarm and immediately sends a uplink.517 +0x02: US915 415 415 519 +0x03: IN865 416 416 417 - (% style="color:blue"%)**AT Commands:**521 +0x04: AU915 418 418 419 - (% style="color:#037691" %)**AT+ SHHUM=min,max**523 +0x05: KZ865 420 420 421 - Example:AT+ SHHUM=50,80 ~/~/ Alarm when humidity lower than 50 or higher than 80.525 +0x06: RU864 422 422 527 +0x07: AS923 423 423 424 - (% style="color:#037691"%)**AT+SHTEMP=min,max**529 +0x08: AS923-1 425 425 426 - Example: AT+SHTEMP=20,30 ~/~/ Alarm when temperature lower than20 or higher than 30531 +0x09: AS923-2 427 427 533 +0x0a: AS923-3 428 428 429 - (% style="color:red"%)**Notice:**535 +0x0b: CN470 430 430 431 - * To disable Alarm, user can set min and maxto same value , such as (% style="color:#037691"%)**AT+SHTEMP=0,0.**537 +0x0c: EU433 432 432 433 - * If user only want to send only min or max, user can set the alarm to a value thatdevice won’t reach. For example:(% style="color:#037691" %)**AT+SHTEMP=-80,0.**539 +0x0d: KR920 434 434 541 +0x0e: MA869 435 435 436 436 437 - ==2.6 Trggieranuplinkby external interrupt ==544 +(% style="color:#037691" %)**Sub-Band**(%%)**:** 438 438 546 +AU915 and US915: value 0x00 ~~ 0x08 439 439 440 - S31-NBhas an externaltrigger interrupt function. Userscan use the PB15pinto trigger the upload of data packets.548 +CN470: value 0x0B ~~ 0x0C 441 441 442 - (% style="color:blue"%)**AT command:**550 +Other Bands: Always 0x00 443 443 444 -* (% style="color:#037691" %)**AT+INTMOD **(%%) ~/~/ Set the trigger interrupt mode 445 445 446 - *(% style="color:#037691" %)**AT+INTMOD=0 **(%%) ~/~/ Disable Interrupt553 +(% style="color:#037691" %)**Battery Info:** 447 447 448 - * (% style="color:#037691"%)**AT+INTMOD=1 **(%%) ~/~/ Triggerbyrising and fallingdge555 +Check the battery voltage. 449 449 450 - * (% style="color:#037691"%)**AT+INTMOD=2**(%%) ~/~/ Trigger by falling edge557 +Ex1: 0x0B45 = 2885mV 451 451 452 - * (% style="color:#037691"%)**AT+INTMOD=3**(%%) ~/~/ Trigger by rising edge559 +Ex2: 0x0B49 = 2889mV 453 453 454 454 455 -= 3. ConfigureS31x-NB=562 +=== 2.3.2 Battery Info === 456 456 457 -== 3.1 Configure Methods == 458 458 565 +Check the battery voltage for DDS20-LB. 459 459 460 - S31x-NBsupportsbelow configuremethod:567 +Ex1: 0x0B45 = 2885mV 461 461 462 - * AT Command via Bluetooth Connection (**Recommended**):[[BLEConfigureInstruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].569 +Ex2: 0x0B49 = 2889mV 463 463 464 -* AT Command via UART Connection : See [[UART Connection>>http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H2.3UARTConnectionforSN50v3basemotherboard]]. 465 465 466 -* 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/]]. 572 +=== 2.3.3 Distance === 468 468 469 -== 3.2 General Commands == 470 470 575 +((( 576 +Get the distance. Flat object range 20mm - 2000mm. 577 +))) 471 471 472 -These commands are to configure: 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" %)** ** 473 473 474 - *Generalsystemsettingslike:uplinkinterval.475 - * LoRaWAN protocol & radio related command.582 +(% style="color:blue" %)**0605(H) = 1541 (D) = 1541 mm.** 583 +))) 476 476 477 - Theyaresamefor all Dragino DeviceswhichsupportDLWS-005LoRaWAN Stack.These commandscan befoundhewiki:585 +* If the sensor value is 0x0000, it means system doesn't detect ultrasonic sensor. 478 478 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/]]587 +* If the sensor value lower than 0x0014 (20mm), the sensor value will be invalid. 480 480 589 +=== 2.3.4 Interrupt Pin === 481 481 482 -== 3.3 Commands special design for S31x-LB == 483 483 592 +This data field shows if this packet is generated by interrupt or not. [[Click here>>||anchor="H3.3.2SetInterruptMode"]] for the hardware and software set up. 484 484 485 - These commands only valid for S31x-LB,as below:594 +**Example:** 486 486 596 +0x00: Normal uplink packet. 487 487 488 - === 3.3.1Set TransmitIntervalTime===598 +0x01: Interrupt Uplink Packet. 489 489 490 490 491 - Feature:ChangeLoRaWAN End Node TransmitInterval.601 +=== 2.3.5 DS18B20 Temperature sensor === 492 492 493 -(% style="color:blue" %)**AT Command: AT+TDC** 494 494 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 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 501 501 ))) 502 -|(% style="width:156px" %)AT+TDC=60000|(% style="width:137px" %)Set Transmit Interval|((( 503 -OK 504 -Set transmit interval to 60000ms = 60 seconds 619 + 620 +((( 621 +0x00: No Ultrasonic Sensor 622 + 623 + 505 505 ))) 506 506 507 - (%style="color:blue"%)**Downlink Command:0x01**626 +== 2.4 Test Uplink and Change Update Interval == 508 508 509 -Format: Command Code (0x01) followed by 3 bytes time value. 510 510 511 - 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 512 512 513 -* Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds 514 -* 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**. 515 515 516 -== =3.3.2GetDeviceStatus===633 +(% style="color:#037691" %)**AT+TDC=600 ** (%%) ~/~/ Set Update Interval to 600s 517 517 635 +User can also push the button for more than 1 seconds to activate an uplink. 518 518 519 -Send a LoRaWAN downlink to ask device send Alarm settings. 520 520 521 - (% style="color:blue"%)**DownlinkPayload:**(%%)0x2601638 +== 2.5 Multi-Samplings and One uplink == 522 522 523 -Sensor will upload Device Status via FPORT=5. See payload section for detail. 524 524 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: 525 525 526 -== =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) 527 527 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. 528 528 529 - *(%style="color:blue"%)**ATCommand:**647 +The diagram below explains the relationship between TR, NOUD, and TDC more clearly: 530 530 531 - (% style="color:#037691" %)**AT+SHTEMP=min,max**649 +[[image:1692424376354-959.png]] 532 532 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 536 536 537 - Example:652 +== 2.6 Trggier an uplink by external interrupt == 538 538 539 - AT+SHTEMP=0,30 ~/~/ Alarm when temperature higher than 30. 540 540 541 - *(%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. 542 542 543 -(% style="color: #037691" %)**0x(0C01 00 1E)**(%%) ~/~/ Set AT+SHTEMP=0,30657 +(% style="color:blue" %)**AT command:** 544 544 545 -(% 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 546 546 661 +* (% style="color:#037691" %)**AT+INTMOD=0 **(%%) ~/~/ Disable Interrupt 547 547 548 - ===3.3.4SetHumidityAlarmThreshold===663 +* (% style="color:#037691" %)**AT+INTMOD=1 **(%%) ~/~/ Trigger by rising and falling edge 549 549 665 +* (% style="color:#037691" %)**AT+INTMOD=2 **(%%) ~/~/ Trigger by falling edge 550 550 551 -* (% style="color: blue" %)**ATCommand:**667 +* (% style="color:#037691" %)**AT+INTMOD=3 **(%%) ~/~/ Trigger by rising edge 552 552 553 - (% style="color:#037691"%)**AT+SHHUM=min,max**669 += 3. Configure DDS20-NB = 554 554 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 +== 3.1 Configure Methods == 558 558 559 -Example: 560 560 561 - AT+SHHUM=70,0~/~/ Alarm when humiditylower than 70%.674 +DDS20-NB supports below configure method: 562 562 563 -* (%style="color:blue"%)**DownlinkPayload:**676 +* AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]]. 564 564 565 - (%style="color:#037691"%)**0x(0C024600)**(%%)~/~/SetAT+SHTHUM=70,0678 +* 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]]. 566 566 567 - (% style="color:red"%)**(note:3^^rd^^byte=0x46 for low limit (70%), 4^^th^^ byte = 0x00 for high limit (notset))**680 +== 3.2 AT Commands Set == 568 568 569 569 570 - ===3.3.5SetAlarmInterval===683 +AT+<CMD>? : Help on <CMD> 571 571 685 +AT+<CMD> : Run <CMD> 572 572 573 -T heshortesttimeoftwoAlarmpacket.(unit:min)687 +AT+<CMD>=<value> : Set the value 574 574 575 - *(%style="color:blue"%)**ATCommand:**689 +AT+<CMD>=? : Get the value 576 576 577 -(% 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. 578 578 579 - *(% style="color:blue" %)**Downlink Payload:**692 +(% style="color:blue" %)**General Commands** 580 580 581 - (% style="color:#037691" %)**0x(0D 00 1E)**(%%)**~-~-->** SetAT+ATDC=0x 00 1E = 30 minutes694 +AT : Attention 582 582 696 +AT? : Short Help 583 583 584 - ===3.3.6GetAlarmsettings===698 +ATZ : MCU Reset 585 585 700 +AT+TDC : Application Data Transmission Interval 586 586 587 - SendaLoRaWANdownlinktoaskdevice send Alarm settings.702 +AT+CFG : Print all configurations 588 588 589 - *(% style="color:#037691"%)**DownlinkPayload:**(%%)0x0E 01704 +AT+CFGMOD : Working mode selection 590 590 591 - **Example:**706 +AT+DEUI : Get or set the Device ID 592 592 593 - [[image:image-20230524110211-4.png]]708 +AT+INTMOD : Set the trigger interrupt mode 594 594 595 - **Explain:**710 +AT+5VT : Set extend the time of 5V power 596 596 597 - *Alarm & MODbit is 0x7C, 0x7C >> 2 = 0x31:Means thismessageis theAlarmsettings message.712 +AT+PRO : Choose agreement 598 598 599 - ===3.3.7SetInterruptMode===714 +AT+RXDL : Extend the sending and receiving time 600 600 716 +AT+DNSCFG : Get or Set DNS Server 601 601 602 - Feature,SetInterruptmodeforPA8 of pin.718 +AT+GETSENSORVALUE : Returns the current sensor measurement 603 603 604 - WhenAT+INTMOD=0isset,PA8isusedasadigitalinput port.720 +AT+NOUD : Get or Set the number of data to be uploaded 605 605 606 - (%style="color:blue"%)**AT Command:AT+INTMOD**722 +AT+CDP : Read or Clear cached data 607 607 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 +AT+SHTEMP: Get or Set alarm of temp 622 622 623 - (%style="color:blue"%)**DownlinkCommand:0x06**726 +AT+SHHUM: Get or Set alarm of moisture 624 624 625 - Format:CommandCode(0x06) followedby 3 bytes.728 +AT+SERVADDR : Server Address 626 626 627 -This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06. 628 628 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 +(% style="color:blue" %)**UDP Management** 631 631 632 - ===3.3.8SetPowerOutputDuration===733 +AT+CFM : Upload confirmation mode (only valid for UDP) 633 633 634 634 635 - Controltheutput duration 5V . Beforeeachsampling, devicewill736 +(% style="color:blue" %)**MQTT Management** 636 636 637 - ~1.firstenablethepoweroutputtoexternalsensor,738 +AT+CLIENT : Get or Set MQTT client 638 638 639 - 2.keepit on as perduration,readsensorvalue and construct uplink payload740 +AT+UNAME : Get or Set MQTT Username 640 640 641 - 3.final,closehepoweroutput.742 +AT+PWD : Get or Set MQTT password 642 642 643 - (%style="color:blue"%)**ATCommand:AT+5VT**744 +AT+PUBTOPIC : Get or Set MQTT publish topic 644 644 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 +AT+SUBTOPIC : Get or Set MQTT subscription topic 650 650 651 -(% style="color:blue" %)**Downlink Command: 0x07** 652 652 653 - Format:Command Code(0x07)llowedby 2 bytes.749 +(% style="color:blue" %)**Information** 654 654 655 -T hefirstandsecondbytesarethetimeto turnon.751 +AT+FDR : Factory Data Reset 656 656 657 -* Example 1: Downlink Payload: 070000 **~-~-->** AT+5VT=0 658 -* Example 2: Downlink Payload: 0701F4 **~-~-->** AT+5VT=500 753 +AT+PWORD : Serial Access Password 659 659 755 +AT+LDATA : Get the last upload data 756 + 757 +AT+CDP : Read or Clear cached data 758 + 759 + 660 660 = 4. Battery & Power Consumption = 661 661 662 662 663 -S 31x-LB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.763 +DDS20-NB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace. 664 664 665 665 [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] . 666 666 667 667 668 -= 5. OTAFirmware update =768 += 5. Firmware update = 669 669 670 670 671 -(% class="wikigeneratedid" %) 672 -User can change firmware S31x-LB to: 771 +User can change device firmware to:: 673 673 674 -* Change Frequency band/ region. 675 675 * Update with new features. 774 + 676 676 * Fix bugs. 677 677 678 -Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/f is3g6nmhv0eokg/AAC6BcCZaX4BdqZkduUvZ3jIa?dl=0]]**777 +Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/fhb3uyl4gt6clru/AAAiZVTFcxrfE1JOOyfcgO9ha?dl=0]]** 679 679 680 - 681 681 Methods to Update Firmware: 682 682 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/]]** 781 +* (Recommended way) OTA firmware update via BLE: [[**Instruction**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/BLE_Firmware_Update_NB_Sensors_BC660K-GL/]]. 782 + 684 684 * 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]]**. 685 685 686 686 = 6. FAQ = 687 687 787 +== 6.1 How can I access t BC660K-GL AT Commands? == 688 688 689 689 690 - =7.OrderInfo=790 +User can access to BC660K-GL directly and send AT Commands. 691 691 792 +[[See BC660K-GL AT Command set>>url:https://www.dropbox.com/sh/5f6ssda5fum8rvs/AABT68l8ZzWOvZ5eg2qwOoFda?dl=0]] 692 692 693 -Part Number: (% style="color:blue" %)**S31-LB-XX / S31B-LB-XX** 694 694 695 - (% style="color:red"%)**XX**(%%):Thedefault frequencyband795 += 7. Order Info = 696 696 697 -* (% style="color:red" %)**AS923**(%%): LoRaWAN AS923 band 698 698 699 - *(% style="color:red" %)**AU915**(%%): LoRaWAN AU915 band798 +Part Number: (% style="color:blue" %)**DDS20-NB-XX** 700 700 701 - *(% style="color:red" %)**EU433**(%%):LoRaWAN EU433 band800 +(% style="color:red" %)**XX**(%%): 702 702 703 -* (% style="color: red" %)**EU868**(%%):LoRaWANEU868band802 +* (% style="color:#037691" %)**GE**(%%): General version ( Exclude SIM card) 704 704 705 -* (% style="color: red" %)**KR920**(%%):LoRaWANKR920band804 +* (% style="color:#037691" %)**1D**(%%): with 1NCE* 10 years 500MB SIM card and Pre-configure to DataCake server 706 706 707 - *(% style="color:red" %)**US915**(%%): LoRaWANUS915band806 +(% 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 708 708 709 -* (% style="color:red" %)**IN865**(%%): LoRaWAN IN865 band 710 710 711 -* (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band 712 - 713 713 = 8. Packing Info = 714 714 715 715 716 716 (% style="color:#037691" %)**Package Includes**: 717 717 718 -* S 31x-LBLoRaWANemperature& HumiditySensor814 +* DDS20-NB NB-IoT Ultrasonic liquid level sensor x 1 719 719 816 +* External antenna x 1 817 + 720 720 (% style="color:#037691" %)**Dimension and weight**: 721 721 722 -* Device Size: cm 820 +* Device Size: 13.0 x 5 x 4.5 cm 723 723 724 -* Device Weight: g 822 +* Device Weight: 150g 725 725 726 -* Package Size / pcs : cm 824 +* Package Size / pcs : 14.0 x 8x 5 cm 727 727 728 -* Weight / pcs : g 826 +* Weight / pcs : 180g 729 729 730 730 = 9. Support = 731 731
- 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