Changes for page NDDS75 -- NB-IoT Distance Detect Sensor User Manual
Last modified by Bei Jinggeng on 2024/05/31 09:53
Summary
-
Page properties (1 modified, 0 added, 0 removed)
-
Attachments (0 modified, 0 added, 12 removed)
Details
- Page properties
-
- Content
-
... ... @@ -59,6 +59,8 @@ 59 59 * Micro SIM card slot for NB-IoT SIM 60 60 * 8500mAh Battery for long term use 61 61 62 + 63 + 62 62 == 1.3 Specification == 63 63 64 64 ... ... @@ -67,6 +67,7 @@ 67 67 * Supply Voltage: 2.1v ~~ 3.6v 68 68 * Operating Temperature: -40 ~~ 85°C 69 69 72 + 70 70 (% style="color:#037691" %)**NB-IoT Spec:** 71 71 72 72 * - B1 @H-FDD: 2100MHz ... ... @@ -76,6 +76,7 @@ 76 76 * - B20 @H-FDD: 800MHz 77 77 * - B28 @H-FDD: 700MHz 78 78 82 + 79 79 (% style="color:#037691" %)**Probe Specification:** 80 80 81 81 Measure Volume: Base on the centra pin of the probe, a cylinder with 7cm diameter and 10cm height. ... ... @@ -122,7 +122,6 @@ 122 122 123 123 == 2.2 Configure the NSE01 == 124 124 125 - 126 126 === 2.2.1 Test Requirement === 127 127 128 128 ... ... @@ -132,12 +132,11 @@ 132 132 * The local NB-IoT network used the band that NSE01 supports. 133 133 * Your operator is able to distribute the data received in their NB-IoT network to your IoT server. 134 134 135 - (((138 + 136 136 Below figure shows our testing structure. Here we have NB-IoT network coverage by China Mobile, the band they use is B8. The NSE01 will use CoAP((% style="color:red" %)120.24.4.116:5683)(%%) or raw UDP((% style="color:red" %)120.24.4.116:5601)(%%) or MQTT((% style="color:red" %)120.24.4.116:1883)(%%)or TCP((% style="color:red" %)120.24.4.116:5600)(%%)protocol to send data to the test server 137 -))) 138 138 139 139 140 -[[image: 1657249419225-449.png]]142 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image002.gif]] 141 141 142 142 143 143 ... ... @@ -145,177 +145,159 @@ 145 145 146 146 Insert the NB-IoT Card get from your provider. 147 147 150 + 148 148 User need to take out the NB-IoT module and insert the SIM card like below: 149 149 150 150 151 -[[image: 1657249468462-536.png]]154 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image004.gif]] 152 152 153 153 154 - 155 155 === 2.2.3 Connect USB – TTL to NSE01 to configure it === 156 156 157 -((( 158 -((( 159 -User need to configure NSE01 via serial port to set the (% style="color:blue" %)**Server Address** / **Uplink Topic** (%%)to define where and how-to uplink packets. NSE01 support AT Commands, user can use a USB to TTL adapter to connect to NSE01 and use AT Commands to configure it, as below. 160 -))) 161 -))) 162 162 160 +User need to configure NSE01 via serial port to set the **(% style="color:blue" %)Server Address** / **Uplink Topic** (%%)to define where and how-to uplink packets. NSE01 support AT Commands, user can use a USB to TTL adapter to connect to NSE01 and use AT Commands to configure it, as below. 163 163 164 -**Connection:** 165 165 166 - (% style="background-color:yellow" %)USB TTL GND <~-~-~-~-> GND 167 167 168 - (% style="background-color:yellow" %)USB TTL TXD <~-~-~-~-> UART_RXD 169 169 170 - (% style="background-color:yellow" %)USB TTL RXD <~-~-~-~-> UART_TXD165 +Connection: 171 171 167 +USB TTL GND <~-~-~-~-> GND 172 172 173 - InthePC,usebelow serial tool settings:169 +USB TTL TXD <~-~-~-~-> UART_RXD 174 174 175 -* Baud: (% style="color:green" %)**9600** 176 -* Data bits:** (% style="color:green" %)8(%%)** 177 -* Stop bits: (% style="color:green" %)**1** 178 -* Parity: (% style="color:green" %)**None** 179 -* Flow Control: (% style="color:green" %)**None** 171 +USB TTL RXD <~-~-~-~-> UART_TXD 180 180 181 -((( 182 -Make sure the switch is in FLASH position, then power on device by connecting the jumper on NSE01. NSE01 will output system info once power on as below, we can enter the (% style="color:green" %)**password: 12345678**(%%) to access AT Command input. 183 -))) 184 184 185 -[[image:image-20220708110657-3.png]] 186 186 187 - (%style="color:red" %)Note: thevalid ATCommandscanbefoundat:(%%)[[http:~~/~~/www.dragino.com/downloads/index.php?dir=NB-IoT/NSE01/>>url:http://www.dragino.com/downloads/index.php?dir=NB-IoT/NBSN50/]]175 +In the PC, use below serial tool settings: 188 188 177 +* Baud: **9600** 178 +* Data bits:** 8** 179 +* Stop bits: **1** 180 +* Parity: **None** 181 +* Flow Control: **None** 189 189 190 190 191 - ===2.2.4UseCoAPprotocoltouplinkdata===184 +Make sure the switch is in FLASH position, then power on device by connecting the jumper on NSE01. NSE01 will output system info once power on as below, we can enter the **password: 12345678** to access AT Command input. 192 192 193 - (% style="color:red" %)Note:if you don't haveCoAP server, you can refer thislink to set up one:(%%)[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Set%20up%20CoAP%20Server/>>http://wiki.dragino.com/xwiki/bin/view/Main/Set%20up%20CoAP%20Server/]]186 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image009.jpg]] 194 194 188 +Note: the valid AT Commands can be found at: 195 195 196 - **Usebelowmands:**190 +[[http:~~/~~/www.dragino.com/downloads/index.php?dir=NB-IoT/NSE01/>>url:http://www.dragino.com/downloads/index.php?dir=NB-IoT/NBSN50/]] 197 197 198 -* (% style="color:blue" %)**AT+PRO=1** (%%) ~/~/ Set to use CoAP protocol to uplink 199 -* (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5683 ** (%%)~/~/ to set CoAP server address and port 200 -* (% style="color:blue" %)**AT+URI=5,11,"mqtt",11,"coap",12,"0",15,"c=text1",23,"0" ** (%%) ~/~/Set COAP resource path 201 201 193 +1. 194 +11. 195 +111. Use CoAP protocol to uplink data 202 202 203 -For parameter description, please refer to AT command set 204 204 205 - [[image:1657249793983-486.png]]198 +Note: if you don’t have CoAP server, you can refer this link to set up one: 206 206 200 +[[http:~~/~~/wiki.dragino.com/index.php?title=Set_up_CoAP_Server>>url:http://wiki.dragino.com/index.php?title=Set_up_CoAP_Server]] 207 207 208 -After configure the server address and (% style="color:green" %)**reset the device**(%%) (via AT+ATZ ), NSE01 will start to uplink sensor values to CoAP server. 209 209 210 - [[image:1657249831934-534.png]]203 +Use below commands: 211 211 205 +* **AT+PRO=1** ~/~/ Set to use CoAP protocol to uplink 206 +* **AT+SERVADDR=120.24.4.116,5683 **~/~/ to set CoAP server address and port 207 +* **AT+URI=5,11,"mqtt",11,"coap",12,"0",15,"c=text1",23,"0" **~/~/Set COAP resource path 212 212 213 213 214 - ===2.2.5 Use UDPprotocoltouplink data(Defaultprotocol)===210 +For parameter description, please refer to AT command set 215 215 216 - This featureupportedsince firmwareversion v1.0.1212 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image011.jpg]] 217 217 218 218 219 -* (% style="color:blue" %)**AT+PRO=2 ** (%%) ~/~/ Set to use UDP protocol to uplink 220 -* (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5601 ** (%%) ~/~/ to set UDP server address and port 221 -* (% style="color:blue" %)**AT+CFM=1 ** (%%) ~/~/If the server does not respond, this command is unnecessary 215 +After configure the server address and **reset the device** (via AT+ATZ ), NSE01 will start to uplink sensor values to CoAP server. 222 222 217 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image013.jpg]] 223 223 224 -[[image:1657249864775-321.png]] 219 +1. 220 +11. 221 +111. Use UDP protocol to uplink data(Default protocol) 225 225 226 226 224 +This feature is supported since firmware version v1.0.1 227 227 228 -[[image:1657249930215-289.png]] 229 229 227 +* **AT+PRO=2 ** ~/~/ Set to use UDP protocol to uplink 228 +* **AT+SERVADDR=120.24.4.116,5601 **~/~/ to set UDP server address and port 229 +* **AT+CFM=1 **~/~/If the server does not respond, this command is unnecessary 230 230 231 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image015.jpg]] 231 231 232 -=== 2.2.6 Use MQTT protocol to uplink data === 233 233 234 -This feature is supported since firmware version v110 235 235 236 236 237 -* (% style="color:blue" %)**AT+PRO=3 ** (%%) ~/~/Set to use MQTT protocol to uplink 238 -* (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,1883 ** (%%) ~/~/Set MQTT server address and port 239 -* (% style="color:blue" %)**AT+CLIENT=CLIENT ** (%%)~/~/Set up the CLIENT of MQTT 240 -* (% style="color:blue" %)**AT+UNAME=UNAME **(%%)~/~/Set the username of MQTT 241 -* (% style="color:blue" %)**AT+PWD=PWD **(%%)~/~/Set the password of MQTT 242 -* (% style="color:blue" %)**AT+PUBTOPIC=NSE01_PUB **(%%)~/~/Set the sending topic of MQTT 243 -* (% style="color:blue" %)**AT+SUBTOPIC=NSE01_SUB **(%%) ~/~/Set the subscription topic of MQTT 244 244 237 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image017.jpg]] 245 245 246 -[[image:1657249978444-674.png]] 247 247 240 +1. 241 +11. 242 +111. Use MQTT protocol to uplink data 248 248 249 -[[image:1657249990869-686.png]] 250 250 245 +This feature is supported since firmware version v110 251 251 252 252 253 -((( 254 -MQTT protocol has a much higher power consumption compare vs UDP / CoAP protocol. Please check the power analyze document and adjust the uplink period to a suitable interval. 255 -))) 248 +* **AT+PRO=3 ** ~/~/Set to use MQTT protocol to uplink 249 +* **AT+SERVADDR=120.24.4.116,1883 **~/~/Set MQTT server address and port 250 +* **AT+CLIENT=CLIENT **~/~/Set up the CLIENT of MQTT 251 +* **AT+UNAME=UNAME **~/~/Set the username of MQTT 252 +* **AT+PWD=PWD **~/~/Set the password of MQTT 253 +* **AT+PUBTOPIC=NSE01_PUB **~/~/Set the sending topic of MQTT 254 +* **AT+SUBTOPIC=NSE01_SUB **~/~/Set the subscription topic of MQTT 256 256 257 257 257 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image019.gif]] 258 258 259 - === 2.2.7UseTCP protocoltouplink data ===259 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image021.jpg]] 260 260 261 -This feature is supported since firmware version v110 262 262 262 +MQTT protocol has a much higher power consumption compare vs UDP / CoAP protocol. Please check the power analyze document and adjust the uplink period to a suitable interval. 263 263 264 -* (% style="color:blue" %)**AT+PRO=4 ** (%%) ~/~/ Set to use TCP protocol to uplink 265 -* (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5600 **(%%) ~/~/ to set TCP server address and port 266 266 267 -[[image:1657250217799-140.png]] 265 +1. 266 +11. 267 +111. Use TCP protocol to uplink data 268 268 269 269 270 - [[image:1657250255956-604.png]]270 +This feature is supported since firmware version v110 271 271 272 272 273 -=== 2.2.8 Change Update Interval === 273 +* **AT+PRO=4 ** ~/~/ Set to use TCP protocol to uplink 274 +* **AT+SERVADDR=120.24.4.116,5600 **~/~/ to set TCP server address and port 274 274 275 -User can use below commandtohangethe (%style="color:green" %)**uplinkinterval**.276 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image023.jpg]] 276 276 277 -* (% style="color:blue" %)**AT+TDC=600 ** (%%)~/~/ Set Update Interval to 600s 278 278 279 -((( 280 -(% style="color:red" %)**NOTE:** 281 -))) 282 282 283 -((( 284 -(% style="color:red" %)1. By default, the device will send an uplink message every 1 hour. 285 -))) 280 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image025.jpg]] 286 286 287 287 283 +1. 284 +11. 285 +111. Change Update Interval 288 288 289 - ==2.3UplinkPayload ==287 +User can use below command to change the **uplink interval**. 290 290 291 - Inthismode,uplink payloadincludesinotal18 bytes289 +**~ AT+TDC=600 **~/~/ Set Update Interval to 600s 292 292 293 -(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %) 294 -|=(% style="width: 50px;" %)((( 295 -**Size(bytes)** 296 -)))|=(% style="width: 50px;" %)**6**|=(% style="width: 25px;" %)2|=(% style="width: 25px;" %)**2**|=(% style="width: 80px;" %)**1**|=(% style="width: 80px;" %)**2**|=(% style="width: 80px;" %)**2**|=(% style="width: 80px;" %)**2**|=(% style="width: 40px;" %)**1** 297 -|(% style="width:97px" %)**Value**|(% style="width:83px" %)[[Device ID>>path:#Device_ID]]|(% style="width:41px" %)[[Ver>>path:#Version]]|(% style="width:46px" %)[[BAT>>path:#battery]]|(% style="width:123px" %)[[Signal Strength>>path:#Signal]]|(% style="width:108px" %)[[Soil Moisture>>path:#Payload_Explain]]|(% style="width:133px" %)[[Soil Temperature>>path:#Payload_Explain]]|(% style="width:159px" %)[[Soil Conductivity(EC)>>path:#Payload_Explain]]|(% style="width:80px" %)[[Interrupt>>path:#Interrupt]] 298 298 299 - If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when theNSE01 uplink data.292 +**NOTE:** 300 300 294 +1. By default, the device will send an uplink message every 1 hour. 301 301 302 -[[image:image-20220708111918-4.png]] 303 303 304 304 305 -The payload is ASCII string, representative same HEX: 306 306 307 -0x72403155615900640c7817075e0a8c02f900 where: 308 308 309 -* Device ID: 0x 724031556159 = 724031556159 310 -* Version: 0x0064=100=1.0.0 311 311 312 -* BAT: 0x0c78 = 3192 mV = 3.192V 313 -* Singal: 0x17 = 23 314 -* Soil Moisture: 0x075e= 1886 = 18.86 % 315 -* Soil Temperature:0x0a8c =2700=27 °C 316 -* Soil Conductivity(EC) = 0x02f9 =761 uS /cm 317 -* Interrupt: 0x00 = 0 318 318 302 +== 2.3 Uplink Payload == 319 319 320 320 321 321 === 2.3.1 MOD~=0(Default Mode) ===
- 1657249419225-449.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -81.0 KB - Content
- 1657249468462-536.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -483.6 KB - Content
- 1657249793983-486.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -85.8 KB - Content
- 1657249831934-534.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -72.5 KB - Content
- 1657249864775-321.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -87.0 KB - Content
- 1657249930215-289.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -77.3 KB - Content
- 1657249978444-674.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -139.5 KB - Content
- 1657249990869-686.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -96.9 KB - Content
- 1657250217799-140.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -98.7 KB - Content
- 1657250255956-604.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -99.0 KB - Content
- image-20220708110657-3.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -251.7 KB - Content
- image-20220708111918-4.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -38.8 KB - Content