Changes for page NMDS200 - NB-IoT Microwave Radar Distance Sensor User Manual
Last modified by Mengting Qiu on 2024/04/02 17:03
Change comment:
There is no comment for this version
Summary
-
Page properties (2 modified, 0 added, 0 removed)
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. Edwin1 +XWiki.David - Content
-
... ... @@ -137,7 +137,7 @@ 137 137 138 138 139 139 140 -=== **2.2.2 Insert SIM card** === 140 +=== **2.2.2 Insert NB-IoT SIM card** === 141 141 142 142 Insert the NB-IoT Card get from your provider. 143 143 ... ... @@ -146,7 +146,7 @@ 146 146 [[image:image-20221021110745-6.png]] 147 147 148 148 149 -=== **2.2.3 Connect USB – TTL to CPN01 toconfigure it** ===149 +=== **2.2.3 Connect USB – TTL to CPN01 and configure it** === 150 150 151 151 User need to configure CPN01 via serial port to set the **Server Address** / **Uplink Topic** to define where and how-to uplink packets. CPN01 support AT Commands, user can use a USB to TTL adapter to connect to CPN01 and use AT Commands to configure it, as below. 152 152 ... ... @@ -175,30 +175,35 @@ 175 175 176 176 **Note: the valid AT Commands can be found at: **[[**https:~~/~~/www.dropbox.com/sh/351dwor6joz8nwh/AADn1BQaAAxLF_QMyU8NkW47a?dl=0**>>url:https://www.dropbox.com/sh/351dwor6joz8nwh/AADn1BQaAAxLF_QMyU8NkW47a?dl=0]] 177 177 178 + 178 178 === **2.2.4 Use CoAP protocol to uplink data** === 179 179 180 -**Note: if you don't have CoAP server, you can refer this link to set up o ne: **[[**http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Set%20up%20CoAP%20Server/**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Set%20up%20CoAP%20Server/]]181 +**Note: if you don't have a CoAP server, you can refer this link to set up a CoAP server: **[[**http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Set%20up%20CoAP%20Server/**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Set%20up%20CoAP%20Server/]] 181 181 182 -**Use below commands:** 183 183 184 +**Use below commands in CPN01:** 185 + 184 184 * **AT+PRO=1** ~/~/ Set to use CoAP protocol to uplink 185 -* **AT+SERVADDR=120.24.4.116,5683 ** ~/~/ to set CoAP server address and port186 -* **AT+URI=5,11,"mqtt",11,"coap",12,"0",15,"c=text1",23,"0" ** ~/~/Set C OAP resource path187 +* **AT+SERVADDR=120.24.4.116,5683 ** ~/~/ Set CoAP server address and port 188 +* **AT+URI=5,11,"mqtt",11,"coap",12,"0",15,"c=text1",23,"0" ** ~/~/Set CoAP resource path 187 187 188 188 For parameter description, please refer to AT command set 189 189 190 190 [[image:image-20221021110948-8.png]] 191 191 192 -After configure the server address and **reset the device** (via AT+ATZ ), CPN01 will start to uplink sensor values to CoAP server. 193 193 195 +After configuring the server address and **reset CPN01** (via AT+ATZ ), CPN01 will start to uplink sensor values to the CoAP server. 196 + 194 194 [[image:image-20221021110956-9.png]] 195 195 199 + 196 196 === **2.2.5 Use UDP protocol to uplink data(Default protocol)** === 197 197 198 -This feature is supported since firmware version v1.0.1 199 199 203 +**AT Commands:** 204 + 200 200 * **AT+PRO=2 ** ~/~/ Set to use UDP protocol to uplink 201 -* **AT+SERVADDR=120.24.4.116,5601 ** ~/~/ to set UDP server address and port206 +* **AT+SERVADDR=120.24.4.116,5601 ** ~/~/ Set UDP server address and port 202 202 * **AT+CFM=1 ** ~/~/If the server does not respond, this command is unnecessary 203 203 204 204 [[image:image-20221021111025-10.png]] ... ... @@ -209,8 +209,9 @@ 209 209 210 210 === **2.2.6 Use MQTT protocol to uplink data** === 211 211 212 -This feature is supported since firmware version v110 213 213 218 +**AT Commands:** 219 + 214 214 * **AT+PRO=3 ** ~/~/Set to use MQTT protocol to uplink 215 215 * **AT+SERVADDR=120.24.4.116,1883 ** ~/~/Set MQTT server address and port 216 216 * **AT+CLIENT=CLIENT ** ~/~/Set up the CLIENT of MQTT ... ... @@ -225,14 +225,15 @@ 225 225 226 226 227 227 228 -MQTT protocol has a much higher power consumption compare vsUDP / CoAP protocol. Please check the power analyze document and adjust the uplink period to a suitable interval.234 +MQTT protocol has a much higher power consumption compare with UDP / CoAP protocol. Please check the power analyze document and adjust the uplink period to a suitable interval. 229 229 236 + 230 230 === **2.2.7 Use TCP protocol to uplink data** === 231 231 232 -T hisfeature is supported since firmware versionv110239 +**AT Commands** 233 233 234 234 * **AT+PRO=4 ** ~/~/ Set to use TCP protocol to uplink 235 -* **AT+SERVADDR=120.24.4.116,5600 ** ~/~/ to set TCP server address and port242 +* **AT+SERVADDR=120.24.4.116,5600 ** ~/~/ Set TCP server address and port 236 236 237 237 [[image:image-20221021111125-14.png]] 238 238 ... ... @@ -244,23 +244,25 @@ 244 244 245 245 User can use below command to change the **uplink interval**. 246 246 247 -* **AT+TDC= 600 ** ~/~/ Set Update Interval to600s254 +* **AT+TDC=7200 ** ~/~/ Set Update Interval to 7200s (2 hours) 248 248 249 249 **NOTE:** 250 250 251 251 **~1. By default, the device will send an uplink message every 1 hour.** 252 252 260 + 253 253 == **2.3 Uplink Payload** == 254 254 255 - In this mode,uplink payload includes87bytes in total by default.263 +The uplink payload includes 123 bytes in total by default. 256 256 257 257 Each time the device uploads a data package, 8 sets of recorded data will be attached. Up to 32 sets of recorded data can be uploaded. 258 258 259 -|**Size(bytes)**|**8**|**2**|**2**|**1**|**1**|**1**|** 2**|**2**|4260 -|**Value**|[[Device ID>>path:#H2.4.1A0A0DeviceID]]|[[Ver>>path:#H2.4.2A0VersionInfo]]|[[BAT>>path:#H2.4.3A0BatteryInfo]]|[[Signal Strength>>path:#H2.4.4A0SignalStrength]]|MOD|[[ Interrupt>>path:#H2.4.8A0DigitalInterrupt]]|[[Soil P>>path:#H2.4.7A0SoilConductivity28EC29]]H|[[SoilTemperature>>path:#H2.4.6A0SoilTemperature]]|Time stamp267 +|**Size(bytes)**|**8**|**2**|**2**|**1**|**1**|**1**|**1**|**1**|**3** 268 +|**Value**|[[Device ID>>path:#H2.4.1A0A0DeviceID]]|[[Ver>>path:#H2.4.2A0VersionInfo]]|[[BAT>>path:#H2.4.3A0BatteryInfo]]|[[Signal Strength>>path:#H2.4.4A0SignalStrength]]|MOD|[[ Calculate Flag>>path:#H2.4.8A0DigitalInterrupt]]|Contact Status|Alarm|Total pulse 261 261 262 -|2|2|4|8 group 263 -|[[Soil Temperature>>path:#H2.4.6A0SoilTemperature]]|[[Soil P>>path:#H2.4.7A0SoilConductivity28EC29]]H|Time stamp|... 270 +(% style="width:1201px" %) 271 +|**3**|**4**|**1**|**3**|**1**|**3**|4|**8 group**|(% style="width:1px" %) 272 +|The last open duration|Time stamp|Contact Status|Total pulse|Calculate Flag|The last open duration|Time stamp|...|(% style="width:1px" %) 264 264 265 265 If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the CPN01 uplink data. 266 266 ... ... @@ -281,9 +281,9 @@ 281 281 282 282 *(% style="color:#037691" %) **Mod:**(%%) 0x01 = 1 283 283 284 -*(% style="color:#037691" %) **Calculate Flag:**(%%) 0x00= 293 +*(% style="color:#037691" %) **Calculate Flag:**(%%) 0x00=0 285 285 286 -*(% style="color:#037691" %) **Contact Status:**(%%) 0x00= 295 +*(% style="color:#037691" %) **Contact Status:**(%%) 0x00=0 287 287 288 288 *(% style="color:#037691" %) **Alarm:**(%%)0x00 =0 289 289 ... ... @@ -291,17 +291,18 @@ 291 291 292 292 *(% style="color:#037691" %) **The last open duration:**(%%)0x02 =2 293 293 294 -*(% style="color:#037691" %)**Time stamp :**(%%) 0x6315537b =1662342011 303 +*(% style="color:#037691" %)** Time stamp :**(%%) 0x6315537b =1662342011 (Unix Time) 295 295 296 296 *(% style="color:#037691" %) **Contact Status, Total pulse, Calculate Flag, The last open duration ,Time stamp :**(%%) 0100000b0200002663510fed 297 297 298 298 *(% style="color:#037691" %) **8 sets of recorded data: Contact Status, Total pulse, Calculate Flag, The last open duration ,Time stamp :**(%%) 0100000e0200002663510f39,....... 299 299 309 + 300 300 == **2.4 Payload Explanation and Sensor Interface** == 301 301 302 302 === **2.4.1 Device ID** === 303 303 304 -By default, the Device ID equal to the last 15 bits of IMEI. 314 +By default, the Device ID is equal to the last 15 bits of IMEI. 305 305 306 306 User can use **AT+DEUI** to set Device ID 307 307 ... ... @@ -309,14 +309,16 @@ 309 309 310 310 AT+DEUI=868411056754138 311 311 312 -The Device ID is stored in a non e-erase area, Upgrade the firmware or run AT+FDR won't erase Device ID.322 +The Device ID is stored in a non-erase area, Upgrade the firmware or run AT+FDR won't erase the Device ID. 313 313 324 + 314 314 === **2.4.2 Version Info** === 315 315 316 -Specify the software version: 0x64=100, means firmware version 1.00. 327 +Specify the software version: 0x64=100, which means firmware version 1.00. 317 317 318 -For example :0x00 64 :this device is CPN01 with firmware version 1.0.0.329 +For example 0x00 64 : This device is CPN01 with firmware version 1.0.0. 319 319 331 + 320 320 === **2.4.3 Battery Info** === 321 321 322 322 Check the battery voltage for CPN01. ... ... @@ -325,6 +325,7 @@ 325 325 326 326 Ex2: 0x0B49 = 2889mV 327 327 340 + 328 328 === **2.4.4 Signal Strength** === 329 329 330 330 NB-IoT Network signal Strength. ... ... @@ -341,9 +341,10 @@ 341 341 342 342 **99** Not known or not detectable 343 343 357 + 344 344 === **2.4.5 Calculate Flag** === 345 345 346 -The calculate flag is a user define field, IoT server can use this filed to handle different meter with different pulse factor. For example, if there are 100 water meters, meter 1 360 +The calculate flag is a user defined field, IoT server can use this filed to handle different meters with different pulse factors. For example, if there are 100 water meters, meter 1~~50 are 1 liter/pulse and meter 51 ~~ 100 has 1.5 liter/pulse. 347 347 348 348 User can set calculate flag to 1 for meter 1~~50 and 2 for meter 51 ~~ 100, So IoT Server can use this field for calculation. 349 349 ... ... @@ -351,10 +351,12 @@ 351 351 352 352 Range (6 bits): (b)000000 ~~ (b) 111111 353 353 368 + 354 354 === **2.4.6 Alarm** === 355 355 356 356 See [[Alarm Base on Timeout>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/CPL01%20LoRaWAN%20Outdoor%20PulseContact%20%20Sensor%20Manual/#H3.5AlarmBaseonTimeout]] 357 357 373 + 358 358 === **2.4.7 Contact Status** === 359 359 360 360 0: Open ... ... @@ -361,12 +361,14 @@ 361 361 362 362 1: Close 363 363 380 + 364 364 === **2.4.8 Total pulse** === 365 365 366 -Total pulse/counting base on dry [[contact trigger event>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/CPL01%20LoRaWAN%20Outdoor%20PulseContact%20%20Sensor%20Manual/#H2.3.2SensorConfiguration2CFPORT3D4]] 383 +Total pulse/counting based on dry [[contact trigger event>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/CPL01%20LoRaWAN%20Outdoor%20PulseContact%20%20Sensor%20Manual/#H2.3.2SensorConfiguration2CFPORT3D4]] 367 367 368 368 Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215 369 369 387 + 370 370 === **2.4.9 The last open duration** === 371 371 372 372 Dry Contact last open duration. ... ... @@ -378,7 +378,7 @@ 378 378 379 379 === **2.4.10 Timestamp** === 380 380 381 -Time 399 +Timestamp : 0x6315537b =1662342011 382 382 383 383 Convert Unix timestamp to time 2022-9-5 9:40:11. 384 384 ... ... @@ -410,7 +410,7 @@ 410 410 411 411 == **2.6 LED Indicator** == 412 412 413 -The CPN01 has an internal LED which is to show the status of different state. 431 +The CPN01 has an internal LED which is to show the status of different states. 414 414 415 415 * When power on, CPN01 will detect if sensor probe is connected, if probe detected, LED will blink four times. (no blinks in this step is no probe) 416 416 * Then the LED will be on for 1 second means device is boot normally. ... ... @@ -419,7 +419,7 @@ 419 419 420 420 == **2.7 Alarm Base on Timeout** == 421 421 422 -CP L01 can monitor the timeout for a status change, this feature can be used to monitor some events such as door opening too long etc. Related Parameters are:440 +CPN01 can monitor the timeout for a status change, this feature can be used to monitor some events such as door opening too long etc. Related Parameters are: 423 423 424 424 425 425 **~1. Keep Status: Status to be monitor** ... ... @@ -440,10 +440,11 @@ 440 440 441 441 **AT Command** to configure: 442 442 443 -**AT+TTRIG=1,30** ~-~-> When the **Keep Status** change from connect to disconnect, and device remains in disconnect status for more than 30 seconds. CP L01 will send an uplink packet, the [[Alarm bit>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/CPL01%20LoRaWAN%20Outdoor%20PulseContact%20%20Sensor%20Manual/#H2.3.3Real-TimeOpen2FCloseStatus2CUplinkFPORT3D2]] (the second bit of 1^^st^^ byte of payload) on this uplink packet is set to 1.461 +**AT+TTRIG=1,30** ~-~-> When the **Keep Status** change from connected to disconnect, and device remains in disconnect status for more than 30 seconds. CPN01 will send an uplink packet, the [[Alarm bit>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/CPL01%20LoRaWAN%20Outdoor%20PulseContact%20%20Sensor%20Manual/#H2.3.3Real-TimeOpen2FCloseStatus2CUplinkFPORT3D2]] (the second bit of 1^^st^^ byte of payload) on this uplink packet is set to 1. 444 444 445 445 **AT+TTIG=0,0 ** ~-~-> Default Value, disable timeout Alarm. 446 446 465 + 447 447 == **2.8 Set debug mode** == 448 448 449 449 Feature: Enable or Disable debug mode ... ... @@ -515,11 +515,11 @@ 515 515 516 516 === **2.16.1 Battery Type** === 517 517 518 -The CPN01 battery is a combination of an 8500mAh Li/SOCI2 Battery and a Super Capacitor. The battery is non e-rechargeable battery type with a low discharge rate (<2% per year). This type of battery is commonly used in IoT devices such as water meter.537 +The CPN01 battery is a combination of an 8500mAh Li/SOCI2 Battery and a Super Capacitor. The battery is non-rechargeable battery type with a low discharge rate (<2% per year). This type of battery is commonly used in IoT devices such as water meter. 519 519 520 -The battery is designed to last for several years depends on the actual lyuse environment and update interval.539 +The battery is designed to last for several years depends on the actual use environment and update interval. 521 521 522 -The battery 541 +The battery-related documents as below: 523 523 524 524 * [[Battery Dimension>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]] 525 525 * [[Lithium-Thionyl Chloride Battery datasheet>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]] ... ... @@ -553,6 +553,7 @@ 553 553 554 554 The default battery pack of CPN01 includes a ER26500 plus super capacitor. If user can't find this pack locally, they can find ER26500 or equivalence without the SPC1520 capacitor, which will also work in most case. The SPC can enlarge the battery life for high frequency use (update period below 5 minutes). 555 555 575 + 556 556 = **3. Access NB-IoT Module** = 557 557 558 558 Users can directly access the AT command set of the NB-IoT module. ... ... @@ -652,12 +652,9 @@ 652 652 653 653 Please see this link for how to upgrade: [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/#H2.HardwareUpgradeMethodSupportList>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/#H2.HardwareUpgradeMethodSupportList]] 654 654 655 -**Notice, **CPN01 **and **CP N01 **share the same mother board. They use the same connection and method to update.**675 +**Notice, **CPN01 **and **CPL01 **share the same mother board. They use the same connection and method to update.** 656 656 657 -== **5.2 Can I calibrate CPN01 to different soil types?** == 658 658 659 -CPN01 is calibrated for saline-alkali soil and loamy soil. If users want to use it for other soil, they can calibrate the value in the IoT platform base on the value measured by saline-alkali soil and loamy soil. The formula can be found at [[this link>>url:https://www.dragino.com/downloads/downloads/LoRa_End_Node/LSE01/Calibrate_to_other_Soil_20220605.pdf]]. 660 - 661 661 = **6. Trouble Shooting** = 662 662 663 663 == **6.1 Connection problem when uploading firmware** == ... ... @@ -664,19 +664,22 @@ 664 664 665 665 **Please see: **[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/#H3.3Troubleshooting>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/#H3.3Troubleshooting]] 666 666 684 + 667 667 == **6.2 AT Command input doesn't work** == 668 668 669 669 In the case if user can see the console output but can't type input to the device. Please check if you already include the **ENTER** while sending out the command. Some serial tool doesn't send **ENTER** while press the send key, user need to add ENTER in their string. 670 670 689 + 671 671 = **7. Order Info** = 672 672 673 673 Part Number**:** CPN01 674 674 694 + 675 675 = **8. Packing Info** = 676 676 677 677 **Package Includes**: 678 678 679 -* CPN01 NB-IoT SoilMoisture& ECSensor x 1699 +* CPN01 Open/Close Sensor x 1 680 680 * External antenna x 1 681 681 682 682 **Dimension and weight**: