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,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,363 +378,381 @@ 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-LB 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:#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"]] 392 392 393 - User can use below commands to changethe(% style="color:blue"%)**uplink interval**.489 +[[image:微信截图_20230702135733.png||height="215" width="964"]] 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-LB to send device configure detail, include device configure status. DDS20-LB will uplink a payload via FPort=5 to server. 400 400 401 -== 2.4 Multi-Samplings and One uplink == 498 +The Payload format is as below. 499 +))) 402 402 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 - To save battery life, S31-NB will sample temperature& humidity data every 15 minutes and send one uplink every 2hours. Soeach uplink it will include 8 stored data + 1 real-time data. They are defined by:506 +[[image:DDS20.png||height="241" width="1336"]] 405 405 406 -* (% 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) 407 407 408 - *(% style="color:#037691" %)**AT+NOUD=8** (%%)~/~/ Thedevice uploads8 setsofrecorded data by default.Up to32setsof record data can be uploaded.509 +(% style="color:#037691" %)**Sensor Model**(%%)**:** For DDS20-LB, this value is 0x29 409 409 410 - Thediagrambelowexplains therelationshipbetween TR,NOUD,andTDCmoreclearly:511 +(% style="color:#037691" %)**Firmware Version**(%%)**:** 0x0100, Means: v1.0.0 version 411 411 412 - [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image001.png||alt="IMG_256"]]513 +(% style="color:#037691" %)**Frequency Band**(%%)**:** 413 413 515 +0x01: EU868 414 414 415 - ==2.5Humidity and Temperature alarm function ==517 +0x02: US915 416 416 519 +0x03: IN865 417 417 418 - 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.521 +0x04: AU915 419 419 523 +0x05: KZ865 420 420 421 - (% style="color:blue"%)**AT Commands:**525 +0x06: RU864 422 422 423 - (% style="color:#037691"%)**AT+SHHUM=min,max**527 +0x07: AS923 424 424 425 - Example: AT+ SHHUM=50,80~/~/Alarm when humidity lower than 50 or higher than 80.529 +0x08: AS923-1 426 426 531 +0x09: AS923-2 427 427 428 - (% style="color:#037691"%)**AT+SHTEMP=min,max**533 +0x0a: AS923-3 429 429 430 - Example:AT+ SHTEMP=20,30 ~/~/ Alarm when temperature lower than 20 or higher than 30535 +0x0b: CN470 431 431 537 +0x0c: EU433 432 432 433 - (% style="color:red" %)**Notice:**539 +0x0d: KR920 434 434 435 - * To disable Alarm, user can set min and maxto samevalue , such as (% style="color:#037691"%)**AT+SHTEMP=0,0.**541 +0x0e: MA869 436 436 437 -* If user only want to send only min or max, user can set the alarm to a value that device won’t reach. For example: (% style="color:#037691" %)**AT+SHTEMP=-80,0.** 438 438 544 +(% style="color:#037691" %)**Sub-Band**(%%)**:** 439 439 546 +AU915 and US915: value 0x00 ~~ 0x08 440 440 548 +CN470: value 0x0B ~~ 0x0C 441 441 442 - == 2.6 Trggier anuplink byexternal interrupt ==550 +Other Bands: Always 0x00 443 443 444 444 445 - S31-NBhasan externaltrigger interrupt function. Userscan usethe PB15 pinto triggerthe upload ofdata packets.553 +(% style="color:#037691" %)**Battery Info:** 446 446 447 - (%style="color:blue"%)**AT command:**555 +Check the battery voltage. 448 448 449 - *(%style="color:#037691"%)**AT+INTMOD **(%%) ~/~/ Set the trigger interruptmode557 +Ex1: 0x0B45 = 2885mV 450 450 451 - * (% style="color:#037691"%)**AT+INTMOD=0**(%%) ~/~/Disable Interrupt559 +Ex2: 0x0B49 = 2889mV 452 452 453 -* (% style="color:#037691" %)**AT+INTMOD=1 **(%%) ~/~/Trigger by rising and falling edge 454 454 455 - * (% style="color:#037691" %)**AT+INTMOD=2**(%%) ~/~/Triggerbyfallingedge562 +=== 2.3.2 Battery Info === 456 456 457 -* (% style="color:#037691" %)**AT+INTMOD=3 **(%%) ~/~/Trigger by rising edge 458 458 565 +Check the battery voltage for DDS20-LB. 459 459 567 +Ex1: 0x0B45 = 2885mV 460 460 461 - =3. Configure S31x-NB =569 +Ex2: 0x0B49 = 2889mV 462 462 463 -== 3.1 Configure Methods == 464 464 572 +=== 2.3.3 Distance === 465 465 466 -S31x-NB supports below configure method: 467 467 468 -* AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]]. 575 +((( 576 +Get the distance. Flat object range 20mm - 2000mm. 577 +))) 469 469 470 -* 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]]. 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" %)** ** 471 471 472 -* LoRaWAN Downlink. Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section. 582 +(% style="color:blue" %)**0605(H) = 1541 (D) = 1541 mm.** 583 +))) 473 473 585 +* If the sensor value is 0x0000, it means system doesn't detect ultrasonic sensor. 474 474 587 +* If the sensor value lower than 0x0014 (20mm), the sensor value will be invalid. 475 475 476 -== 3. 2GeneralCommands==589 +=== 2.3.4 Interrupt Pin === 477 477 478 478 479 -Th esecommandsaretoconfigure:592 +This data field shows if this packet is generated by interrupt or not. 480 480 481 -* General system settings like: uplink interval. 482 -* LoRaWAN protocol & radio related command. 594 +**Example:** 483 483 484 - Theyare same forlDraginoDevices which support DLWS-005 LoRaWAN Stack. These commands can be found onthe wiki:596 +0x00: Normal uplink packet. 485 485 486 - [[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/]]598 +0x01: Interrupt Uplink Packet. 487 487 488 488 489 -== 3.3Commandsspecial designforS31x-LB==601 +=== 2.3.5 DS18B20 Temperature sensor === 490 490 491 491 492 -Th ese commandsonlyvalidforS31x-LB,asbelow: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. 493 493 606 +**Example**: 494 494 495 - ===3.3.1SetTransmitInterval Time===608 +If payload is: 0105H: (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree 496 496 610 +If payload is: FF3FH : (FF3F & FC00 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees. 497 497 498 -Feature: Change LoRaWAN End Node Transmit Interval. 499 499 500 - (%style="color:blue"%)**AT Command:AT+TDC**613 +=== 2.3.6 Sensor Flag === 501 501 502 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 503 -|=(% 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** 504 -|(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|((( 505 -30000 506 -OK 507 -the interval is 30000ms = 30s 615 + 616 +((( 617 +0x01: Detect Ultrasonic Sensor 508 508 ))) 509 -|(% style="width:156px" %)AT+TDC=60000|(% style="width:137px" %)Set Transmit Interval|((( 510 -OK 511 -Set transmit interval to 60000ms = 60 seconds 619 + 620 +((( 621 +0x00: No Ultrasonic Sensor 622 + 623 + 512 512 ))) 513 513 514 - (%style="color:blue"%)**Downlink Command:0x01**626 +== 2.4 Test Uplink and Change Update Interval == 515 515 516 -Format: Command Code (0x01) followed by 3 bytes time value. 517 517 518 - 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 519 519 520 -* Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds 521 -* 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**. 522 522 523 -== =3.3.2GetDeviceStatus===633 +(% style="color:#037691" %)**AT+TDC=600 ** (%%) ~/~/ Set Update Interval to 600s 524 524 635 +User can also push the button for more than 1 seconds to activate an uplink. 525 525 526 -Send a LoRaWAN downlink to ask device send Alarm settings. 527 527 528 - (% style="color:blue"%)**DownlinkPayload:**(%%)0x2601638 +== 2.5 Multi-Samplings and One uplink == 529 529 530 -Sensor will upload Device Status via FPORT=5. See payload section for detail. 531 531 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: 532 532 533 -== =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) 534 534 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. 535 535 536 - *(%style="color:blue"%)**ATCommand:**647 +The diagram below explains the relationship between TR, NOUD, and TDC more clearly: 537 537 538 - (% style="color:#037691" %)**AT+SHTEMP=min,max**649 +[[image:1692424376354-959.png]] 539 539 540 -* When min=0, and max≠0, Alarm higher than max 541 -* When min≠0, and max=0, Alarm lower than min 542 -* When min≠0 and max≠0, Alarm higher than max or lower than min 543 543 544 - Example:652 +== 2.6 Trggier an uplink by external interrupt == 545 545 546 - AT+SHTEMP=0,30 ~/~/ Alarm when temperature higher than 30. 547 547 548 - *(%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. 549 549 550 -(% style="color: #037691" %)**0x(0C01 00 1E)**(%%) ~/~/ Set AT+SHTEMP=0,30657 +(% style="color:blue" %)**AT command:** 551 551 552 -(% 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 553 553 661 +* (% style="color:#037691" %)**AT+INTMOD=0 **(%%) ~/~/ Disable Interrupt 554 554 555 - ===3.3.4SetHumidityAlarmThreshold===663 +* (% style="color:#037691" %)**AT+INTMOD=1 **(%%) ~/~/ Trigger by rising and falling edge 556 556 665 +* (% style="color:#037691" %)**AT+INTMOD=2 **(%%) ~/~/ Trigger by falling edge 557 557 558 -* (% style="color: blue" %)**ATCommand:**667 +* (% style="color:#037691" %)**AT+INTMOD=3 **(%%) ~/~/ Trigger by rising edge 559 559 560 - (% style="color:#037691"%)**AT+SHHUM=min,max**669 += 3. Configure DDS20-NB = 561 561 562 -* When min=0, and max≠0, Alarm higher than max 563 -* When min≠0, and max=0, Alarm lower than min 564 -* When min≠0 and max≠0, Alarm higher than max or lower than min 671 +== 3.1 Configure Methods == 565 565 566 -Example: 567 567 568 - AT+SHHUM=70,0~/~/ Alarm when humiditylower than 70%.674 +DDS20-NB supports below configure method: 569 569 570 -* (%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/]]. 571 571 572 - (%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]]. 573 573 574 - (% 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 == 575 575 576 576 577 - ===3.3.5SetAlarmInterval===683 +AT+<CMD>? : Help on <CMD> 578 578 685 +AT+<CMD> : Run <CMD> 579 579 580 -T heshortesttimeoftwoAlarmpacket.(unit:min)687 +AT+<CMD>=<value> : Set the value 581 581 582 - *(%style="color:blue"%)**ATCommand:**689 +AT+<CMD>=? : Get the value 583 583 584 -(% 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. 585 585 586 - *(% style="color:blue" %)**Downlink Payload:**692 +(% style="color:blue" %)**General Commands** 587 587 588 - (% style="color:#037691" %)**0x(0D 00 1E)**(%%)**~-~-->** SetAT+ATDC=0x 00 1E = 30 minutes694 +AT : Attention 589 589 696 +AT? : Short Help 590 590 591 - ===3.3.6GetAlarmsettings===698 +ATZ : MCU Reset 592 592 700 +AT+TDC : Application Data Transmission Interval 593 593 594 - SendaLoRaWANdownlinktoaskdevice send Alarm settings.702 +AT+CFG : Print all configurations 595 595 596 - *(% style="color:#037691"%)**DownlinkPayload:**(%%)0x0E 01704 +AT+CFGMOD : Working mode selection 597 597 598 - **Example:**706 +AT+DEUI : Get or set the Device ID 599 599 600 - [[image:image-20230524110211-4.png]]708 +AT+INTMOD : Set the trigger interrupt mode 601 601 602 - **Explain:**710 +AT+5VT : Set extend the time of 5V power 603 603 604 - *Alarm & MODbit is 0x7C, 0x7C >> 2 = 0x31:Means thismessageis theAlarmsettings message.712 +AT+PRO : Choose agreement 605 605 606 - ===3.3.7SetInterruptMode===714 +AT+RXDL : Extend the sending and receiving time 607 607 716 +AT+DNSCFG : Get or Set DNS Server 608 608 609 - Feature,SetInterruptmodeforPA8 of pin.718 +AT+GETSENSORVALUE : Returns the current sensor measurement 610 610 611 - WhenAT+INTMOD=0isset,PA8isusedasadigitalinput port.720 +AT+NOUD : Get or Set the number of data to be uploaded 612 612 613 - (%style="color:blue"%)**AT Command:AT+INTMOD**722 +AT+CDP : Read or Clear cached data 614 614 615 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 616 -|=(% 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** 617 -|(% style="width:154px" %)AT+INTMOD=?|(% style="width:196px" %)Show current interrupt mode|(% style="width:157px" %)((( 618 -0 619 -OK 620 -the mode is 0 =Disable Interrupt 621 -))) 622 -|(% style="width:154px" %)AT+INTMOD=2|(% style="width:196px" %)((( 623 -Set Transmit Interval 624 -0. (Disable Interrupt), 625 -~1. (Trigger by rising and falling edge) 626 -2. (Trigger by falling edge) 627 -3. (Trigger by rising edge) 628 -)))|(% style="width:157px" %)OK 724 +AT+SHTEMP: Get or Set alarm of temp 629 629 630 - (%style="color:blue"%)**DownlinkCommand:0x06**726 +AT+SHHUM: Get or Set alarm of moisture 631 631 632 - Format:CommandCode(0x06) followedby 3 bytes.728 +AT+SERVADDR : Server Address 633 633 634 -This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06. 635 635 636 -* Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode 637 -* Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 731 +(% style="color:blue" %)**UDP Management** 638 638 639 - ===3.3.8SetPowerOutputDuration===733 +AT+CFM : Upload confirmation mode (only valid for UDP) 640 640 641 641 642 - Controltheutput duration 5V . Beforeeachsampling, devicewill736 +(% style="color:blue" %)**MQTT Management** 643 643 644 - ~1.firstenablethepoweroutputtoexternalsensor,738 +AT+CLIENT : Get or Set MQTT client 645 645 646 - 2.keepit on as perduration,readsensorvalue and construct uplink payload740 +AT+UNAME : Get or Set MQTT Username 647 647 648 - 3.final,closehepoweroutput.742 +AT+PWD : Get or Set MQTT password 649 649 650 - (%style="color:blue"%)**ATCommand:AT+5VT**744 +AT+PUBTOPIC : Get or Set MQTT publish topic 651 651 652 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 653 -|=(% 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** 654 -|(% style="width:154px" %)AT+5VT=?|(% style="width:196px" %)Show 5V open time.|(% style="width:157px" %)0 (default) 655 -OK 656 -|(% 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 657 657 658 -(% style="color:blue" %)**Downlink Command: 0x07** 659 659 660 - Format:Command Code(0x07)llowedby 2 bytes.749 +(% style="color:blue" %)**Information** 661 661 662 -T hefirstandsecondbytesarethetimeto turnon.751 +AT+FDR : Factory Data Reset 663 663 664 -* Example 1: Downlink Payload: 070000 **~-~-->** AT+5VT=0 665 -* Example 2: Downlink Payload: 0701F4 **~-~-->** AT+5VT=500 753 +AT+PWORD : Serial Access Password 666 666 755 +AT+LDATA : Get the last upload data 756 + 757 +AT+CDP : Read or Clear cached data 758 + 759 + 667 667 = 4. Battery & Power Consumption = 668 668 669 669 670 -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. 671 671 672 672 [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] . 673 673 674 674 675 -= 5. OTAFirmware update =768 += 5. Firmware update = 676 676 677 677 678 -(% class="wikigeneratedid" %) 679 -User can change firmware S31x-LB to: 771 +User can change device firmware to:: 680 680 681 -* Change Frequency band/ region. 682 682 * Update with new features. 774 + 683 683 * Fix bugs. 684 684 685 -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]]** 686 686 687 - 688 688 Methods to Update Firmware: 689 689 690 -* (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 + 691 691 * 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]]**. 692 692 693 693 = 6. FAQ = 694 694 787 +== 6.1 How can I access t BC660K-GL AT Commands? == 695 695 696 696 697 - =7.OrderInfo=790 +User can access to BC660K-GL directly and send AT Commands. 698 698 792 +[[See BC660K-GL AT Command set>>url:https://www.dropbox.com/sh/5f6ssda5fum8rvs/AABT68l8ZzWOvZ5eg2qwOoFda?dl=0]] 699 699 700 -Part Number: (% style="color:blue" %)**S31-LB-XX / S31B-LB-XX** 701 701 702 - (% style="color:red"%)**XX**(%%):The default frequencyband795 += 7. Trouble Shooting = 703 703 704 - *(%style="color:red"%)**AS923**(%%):LoRaWANAS923band797 +== 7.1 Why i always see 0x0000 or 0 for the distance value? == 705 705 706 -* (% style="color:red" %)**AU915**(%%): LoRaWAN AU915 band 707 707 708 -* (% style="color:red" %)**EU433**(%%): LoRaWAN EU433 band 800 +((( 801 +DDS20-LB has a strict [[**installation requirement**>>||anchor="1.5A0InstallDDS20-LB"]]. Please make sure the installation method exactly follows up with the installation requirement. Otherwise, the reading might be always 0x00. 709 709 710 -* (% style="color:red" %)**EU868**(%%): LoRaWAN EU868 band 803 +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. 804 +))) 711 711 712 - *(%style="color:red"%)**KR920**(%%): LoRaWANKR920 band806 += 8. Order Info = 713 713 714 -* (% style="color:red" %)**US915**(%%): LoRaWAN US915 band 715 715 716 - *(% style="color:red" %)**IN865**(%%): LoRaWAN IN865 band809 +Part Number: (% style="color:blue" %)**DDS20-NB-XX** 717 717 718 - *(% style="color:red" %)**CN470**(%%):LoRaWAN CN470 band811 +(% style="color:red" %)**XX**(%%): 719 719 720 -= 8.PackingInfo=813 +* (% style="color:#037691" %)**GE**(%%): General version ( Exclude SIM card) 721 721 815 +* (% style="color:#037691" %)**1D**(%%): with 1NCE* 10 years 500MB SIM card and Pre-configure to DataCake server 722 722 817 +(% 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 818 + 819 + 820 += 9. Packing Info = 821 + 822 + 723 723 (% style="color:#037691" %)**Package Includes**: 724 724 725 -* S 31x-LBLoRaWANemperature& HumiditySensor825 +* DDS20-NB NB-IoT Ultrasonic liquid level sensor x 1 726 726 827 +* External antenna x 1 828 + 727 727 (% style="color:#037691" %)**Dimension and weight**: 728 728 729 -* Device Size: cm 831 +* Device Size: 13.0 x 5 x 4.5 cm 730 730 731 -* Device Weight: g 833 +* Device Weight: 150g 732 732 733 -* Package Size / pcs : cm 835 +* Package Size / pcs : 14.0 x 8x 5 cm 734 734 735 -* Weight / pcs : g 837 +* Weight / pcs : 180g 736 736 737 -= 9. Support =839 += 10. Support = 738 738 739 739 740 740 * Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8. Due to different timezones we cannot offer live support. However, your questions will be answered as soon as possible in the before-mentioned schedule.
- image-20230911134259-1.png
-
- Author
-
... ... @@ -1,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