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, 12 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -59,8 +59,6 @@ 59 59 * Micro SIM card slot for NB-IoT SIM 60 60 * 8500mAh Battery for long term use 61 61 62 - 63 - 64 64 == 1.3 Specification == 65 65 66 66 ... ... @@ -69,7 +69,6 @@ 69 69 * Supply Voltage: 2.1v ~~ 3.6v 70 70 * Operating Temperature: -40 ~~ 85°C 71 71 72 - 73 73 (% style="color:#037691" %)**NB-IoT Spec:** 74 74 75 75 * - B1 @H-FDD: 2100MHz ... ... @@ -79,7 +79,6 @@ 79 79 * - B20 @H-FDD: 800MHz 80 80 * - B28 @H-FDD: 700MHz 81 81 82 - 83 83 (% style="color:#037691" %)**Probe Specification:** 84 84 85 85 Measure Volume: Base on the centra pin of the probe, a cylinder with 7cm diameter and 10cm height. ... ... @@ -126,6 +126,7 @@ 126 126 127 127 == 2.2 Configure the NSE01 == 128 128 125 + 129 129 === 2.2.1 Test Requirement === 130 130 131 131 ... ... @@ -135,177 +135,192 @@ 135 135 * The local NB-IoT network used the band that NSE01 supports. 136 136 * Your operator is able to distribute the data received in their NB-IoT network to your IoT server. 137 137 138 - 135 +((( 139 139 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 +))) 140 140 141 141 142 -[[image: file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image002.gif]]140 +[[image:1657249419225-449.png]] 143 143 144 144 145 145 146 -1. 147 -11. 148 -111. Insert SIM card 144 +=== 2.2.2 Insert SIM card === 149 149 150 150 Insert the NB-IoT Card get from your provider. 151 151 152 - 153 153 User need to take out the NB-IoT module and insert the SIM card like below: 154 154 155 155 156 -[[image: file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image004.gif]]151 +[[image:1657249468462-536.png]] 157 157 158 158 159 -1. 160 -11. 161 -111. Connect USB – TTL to NSE01 to configure it 162 162 155 +=== 2.2.3 Connect USB – TTL to NSE01 to configure it === 163 163 164 -User need to configure NSE01 via serial port to set the **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. 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 +))) 165 165 166 166 164 +**Connection:** 167 167 166 + (% style="background-color:yellow" %)USB TTL GND <~-~-~-~-> GND 168 168 169 - Connection:168 + (% style="background-color:yellow" %)USB TTL TXD <~-~-~-~-> UART_RXD 170 170 171 -USB TTL GND <~-~-~-~->GND170 + (% style="background-color:yellow" %)USB TTL RXD <~-~-~-~-> UART_TXD 172 172 173 -USB TTL TXD <~-~-~-~-> UART_RXD 174 174 175 - USBTTLRXD<~-~-~-~->UART_TXD173 +In the PC, use below serial tool settings: 176 176 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** 177 177 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 +))) 178 178 179 - In the PC, use below serial tool settings:185 +[[image:image-20220708110657-3.png]] 180 180 181 -* Baud: **9600** 182 -* Data bits:** 8** 183 -* Stop bits: **1** 184 -* Parity: **None** 185 -* Flow Control: **None** 187 +(% style="color:red" %)Note: the valid AT Commands can be found at: (%%)[[http:~~/~~/www.dragino.com/downloads/index.php?dir=NB-IoT/NSE01/>>url:http://www.dragino.com/downloads/index.php?dir=NB-IoT/NBSN50/]] 186 186 187 187 188 -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. 189 189 190 - [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image009.jpg]]191 +=== 2.2.4 Use CoAP protocol to uplink data === 191 191 192 - Note: thevalidATCommands canbedat:193 +(% style="color:red" %)Note: if you don't have CoAP server, you can refer this link 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/]] 193 193 194 -[[http:~~/~~/www.dragino.com/downloads/index.php?dir=NB-IoT/NSE01/>>url:http://www.dragino.com/downloads/index.php?dir=NB-IoT/NBSN50/]] 195 195 196 +**Use below commands:** 196 196 197 -1 .198 -1 1.199 -111 .Use CoAPprotocolto uplink data198 +* (% 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 200 200 201 201 202 - Note:if you don’thaveCoAPserver,you canrefer thislinkto setup one:203 +For parameter description, please refer to AT command set 203 203 204 -[[ http:~~/~~/wiki.dragino.com/index.php?title=Set_up_CoAP_Server>>url:http://wiki.dragino.com/index.php?title=Set_up_CoAP_Server]]205 +[[image:1657249793983-486.png]] 205 205 206 206 207 - Usebelowcommands: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. 208 208 209 -* **AT+PRO=1** ~/~/ Set to use CoAP protocol to uplink 210 -* **AT+SERVADDR=120.24.4.116,5683 **~/~/ to set CoAP server address and port 211 -* **AT+URI=5,11,"mqtt",11,"coap",12,"0",15,"c=text1",23,"0" **~/~/Set COAP resource path 210 +[[image:1657249831934-534.png]] 212 212 213 213 214 -For parameter description, please refer to AT command set 215 215 216 - [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image011.jpg]]214 +=== 2.2.5 Use UDP protocol to uplink data(Default protocol) === 217 217 216 +This feature is supported since firmware version v1.0.1 218 218 219 -After configure the server address and **reset the device** (via AT+ATZ ), NSE01 will start to uplink sensor values to CoAP server. 220 220 221 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image013.jpg]] 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 222 222 223 -1. 224 -11. 225 -111. Use UDP protocol to uplink data(Default protocol) 226 226 224 +[[image:1657249864775-321.png]] 227 227 228 -This feature is supported since firmware version v1.0.1 229 229 230 230 231 -* **AT+PRO=2 ** ~/~/ Set to use UDP protocol to uplink 232 -* **AT+SERVADDR=120.24.4.116,5601 **~/~/ to set UDP server address and port 233 -* **AT+CFM=1 **~/~/If the server does not respond, this command is unnecessary 228 +[[image:1657249930215-289.png]] 234 234 235 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image015.jpg]] 236 236 237 237 232 +=== 2.2.6 Use MQTT protocol to uplink data === 238 238 234 +This feature is supported since firmware version v110 239 239 240 240 241 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image017.jpg]] 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 242 242 243 243 244 -1. 245 -11. 246 -111. Use MQTT protocol to uplink data 246 +[[image:1657249978444-674.png]] 247 247 248 248 249 - This feature is supported since firmwareversion v110249 +[[image:1657249990869-686.png]] 250 250 251 251 252 -* **AT+PRO=3 ** ~/~/Set to use MQTT protocol to uplink 253 -* **AT+SERVADDR=120.24.4.116,1883 **~/~/Set MQTT server address and port 254 -* **AT+CLIENT=CLIENT **~/~/Set up the CLIENT of MQTT 255 -* **AT+UNAME=UNAME **~/~/Set the username of MQTT 256 -* **AT+PWD=PWD **~/~/Set the password of MQTT 257 -* **AT+PUBTOPIC=NSE01_PUB **~/~/Set the sending topic of MQTT 258 -* **AT+SUBTOPIC=NSE01_SUB **~/~/Set the subscription topic of MQTT 259 259 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 +))) 260 260 261 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image019.gif]] 262 262 263 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image021.jpg]] 264 264 259 +=== 2.2.7 Use TCP protocol to uplink data === 265 265 266 - MQTT protocolhas amuch higherpowerconsumption compare vs UDP / CoAP protocol. Pleasecheckthe poweranalyze documentand adjust theuplink period to asuitable interval.261 +This feature is supported since firmware version v110 267 267 268 268 269 -1. 270 -11. 271 -111. Use TCP protocol to uplink data 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 272 272 267 +[[image:1657250217799-140.png]] 273 273 274 -This feature is supported since firmware version v110 275 275 270 +[[image:1657250255956-604.png]] 276 276 277 -* **AT+PRO=4 ** ~/~/ Set to use TCP protocol to uplink 278 -* **AT+SERVADDR=120.24.4.116,5600 **~/~/ to set TCP server address and port 279 279 280 - [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image023.jpg]]273 +=== 2.2.8 Change Update Interval === 281 281 275 +User can use below command to change the (% style="color:green" %)**uplink interval**. 282 282 277 +* (% style="color:blue" %)**AT+TDC=600 ** (%%)~/~/ Set Update Interval to 600s 283 283 284 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image025.jpg]] 279 +((( 280 +(% style="color:red" %)**NOTE:** 281 +))) 285 285 283 +((( 284 +(% style="color:red" %)1. By default, the device will send an uplink message every 1 hour. 285 +))) 286 286 287 -1. 288 -11. 289 -111. Change Update Interval 290 290 291 -User can use below command to change the **uplink interval**. 292 292 293 - **~ AT+TDC=600**~/~/ SetUpdate Intervalto600s289 +== 2.3 Uplink Payload == 294 294 291 +In this mode, uplink payload includes in total 18 bytes 295 295 296 -**NOTE:** 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]] 297 297 298 - 1.By default,thedevicewillsendanuplinkmessage every1hour.299 +If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NSE01 uplink data. 299 299 300 300 302 +[[image:image-20220708111918-4.png]] 301 301 302 302 305 +The payload is ASCII string, representative same HEX: 303 303 307 +0x72403155615900640c7817075e0a8c02f900 where: 304 304 309 +* Device ID: 0x 724031556159 = 724031556159 310 +* Version: 0x0064=100=1.0.0 305 305 306 -== 2.3 Uplink Payload == 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 307 307 308 308 320 + 309 309 === 2.3.1 MOD~=0(Default Mode) === 310 310 311 311 LSE01 will uplink payload via LoRaWAN with below payload format:
- 1657249419225-449.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +81.0 KB - Content
- 1657249468462-536.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +483.6 KB - Content
- 1657249793983-486.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +85.8 KB - Content
- 1657249831934-534.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +72.5 KB - Content
- 1657249864775-321.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +87.0 KB - Content
- 1657249930215-289.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +77.3 KB - Content
- 1657249978444-674.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +139.5 KB - Content
- 1657249990869-686.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +96.9 KB - Content
- 1657250217799-140.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +98.7 KB - Content
- 1657250255956-604.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +99.0 KB - Content
- image-20220708110657-3.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +251.7 KB - Content
- image-20220708111918-4.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +38.8 KB - Content