Changes for page NSPH01-NB-IoT Soil pH Sensor User Manual
Last modified by Bei Jinggeng on 2024/03/30 17:53
Summary
-
Page properties (1 modified, 0 added, 0 removed)
-
Attachments (0 modified, 0 added, 2 removed)
Details
- Page properties
-
- Content
-
... ... @@ -18,14 +18,11 @@ 18 18 NSPH01 probe is made by Solid AgCl reference electrode and Pure metal pH sensitive electrode. It can detect soil's** (% style="color:blue" %)pH (%%)**with high accuracy and stable value. The NSPH01 probe can be buried into soil for long time use. 19 19 20 20 NarrowBand-Internet of Things (NB-IoT) is a standards-based low power wide area (LPWA) technology developed to enable a wide range of new IoT devices and services. NB-IoT significantly improves the power consumption of user devices, system capacity and spectrum efficiency, especially in deep coverage. 21 +\\NSPH01 supports different uplink methods include (% style="color:blue" %)**TCP,MQTT,UDP and CoAP **(%%)for different application requirement. 22 +\\NSPH01 is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), It is designed for long term use up to 5 years. (Actually Battery life depends on the use environment, update period & uplink method) 23 +\\To use NSPH01, user needs to check if there is NB-IoT coverage in the installation area and with the bands NSPH01 supports. If the local operator supports it, user needs to get a (% style="color:blue" %)**NB-IoT SIM card** (%%)from local operator and install NSPH01 to get NB-IoT network connection. 21 21 22 -NSPH01 supports different uplink methods include (% style="color:blue" %)**TCP,MQTT,UDP and CoAP **(%%)for different application requirement. 23 23 24 -NSPH01 is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), It is designed for long term use up to 5 years. (Actually Battery life depends on the use environment, update period & uplink method) 25 - 26 -To use NSPH01, user needs to check if there is NB-IoT coverage in the installation area and with the bands NSPH01 supports. If the local operator supports it, user needs to get a (% style="color:blue" %)**NB-IoT SIM card** (%%)from local operator and install NSPH01 to get NB-IoT network connection. 27 - 28 - 29 29 [[image:image-20220907153151-1.png]] 30 30 31 31 ... ... @@ -51,8 +51,6 @@ 51 51 * Micro SIM card slot 52 52 * 8500mAh Battery for long term use 53 53 54 - 55 - 56 56 == 1.3 Specification == 57 57 58 58 ... ... @@ -70,8 +70,6 @@ 70 70 * - B20 @H-FDD: 800MHz 71 71 * - B28 @H-FDD: 700MHz 72 72 73 - 74 - 75 75 == 1.4 Probe Specification == 76 76 77 77 ... ... @@ -92,18 +92,13 @@ 92 92 * IP68 Protection 93 93 * Length: 3.5 meters 94 94 88 +== 1.5 Applications == 95 95 96 - 97 -== 1.5 Applications == 98 - 99 - 100 100 * Smart Agriculture 101 101 92 +== 1.6 Pin mapping and power on == 102 102 103 103 104 -== 1.6 Pin mapping and power on == 105 - 106 - 107 107 [[image:image-20220907153300-2.png]] 108 108 109 109 ... ... @@ -135,7 +135,7 @@ 135 135 * The local NB-IoT network used the band that NSPH01 supports. 136 136 * Your operator is able to distribute the data received in their NB-IoT network to your IoT server. 137 137 138 -Below figure shows our testing structure. Here we have NB-IoT network coverage by China Mobile, the band they use is B8. The NSPH01 will use **CoAP(120.24.4.116:5683)**or raw**UDP(120.24.4.116:5601)**or**MQTT(120.24.4.116:1883)**or**TCP(120.24.4.116:5600)**protocol to send data to the test server.126 +Below figure shows our testing structure. Here we have NB-IoT network coverage by China Mobile, the band they use is B8. The NSPH01 will use CoAP(120.24.4.116:5683) or raw UDP(120.24.4.116:5601) or MQTT(120.24.4.116:1883)or TCP(120.24.4.116:5600)protocol to send data to the test server. 139 139 140 140 141 141 [[image:image-20220907153445-4.png]] ... ... @@ -147,7 +147,6 @@ 147 147 148 148 User need to take out the NB-IoT module and insert the SIM card like below. ((% style="color:red" %) Pay attention to the direction(%%)) 149 149 150 - 151 151 [[image:image-20220907153505-5.png]] 152 152 153 153 ... ... @@ -174,6 +174,7 @@ 174 174 * Stop bits: (% style="color:green" %)**1** 175 175 * Parity: (% style="color:green" %)**None** 176 176 * Flow Control: (% style="color:green" %)**None** 164 +* 177 177 178 178 Make sure the switch is in FLASH position, then power on device by connecting the jumper on NSPH01. NSPH01 will output system info once power on as below, we can enter the (% style="color:green" %)**password: 12345678**(%%) to access AT Command input. 179 179 ... ... @@ -219,6 +219,7 @@ 219 219 * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5601 ** (%%) ~/~/ to set UDP server address and port 220 220 * (% style="color:blue" %)**AT+CFM=1 ** (%%) ~/~/ If the server does not respond, this command is unnecessar 221 221 210 + 222 222 [[image:image-20220907153643-9.png||height="401" width="734"]] 223 223 224 224 ... ... @@ -239,6 +239,7 @@ 239 239 * (% style="color:blue" %)**AT+PUBTOPIC=NSE01_PUB **(%%)~/~/ Set the sending topic of MQTT 240 240 * (% style="color:blue" %)**AT+SUBTOPIC=NSE01_SUB ** (%%) ~/~/ Set the subscription topic of MQTT 241 241 231 + 242 242 [[image:image-20220907153739-11.png||height="491" width="764"]] 243 243 244 244 ... ... @@ -249,6 +249,7 @@ 249 249 250 250 251 251 242 + 252 252 === 2.2.7 Use TCP protocol to uplink data === 253 253 254 254 ... ... @@ -257,6 +257,7 @@ 257 257 * (% style="color:blue" %)**AT+PRO=4 ** (%%) ~/~/ Set to use TCP protocol to uplink 258 258 * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5600 ** (%%) ~/~/ to set TCP server address and port 259 259 251 + 260 260 [[image:image-20220907153818-13.png||height="486" width="668"]] 261 261 262 262 ... ... @@ -271,6 +271,7 @@ 271 271 272 272 * (% style="color:blue" %)**AT+TDC=7200 ** (%%) ~/~/ Set Update Interval to 7200s (2 hour) 273 273 266 + 274 274 (% style="color:red" %)**NOTE: By default, the device will send an uplink message every 2 hours. Each Uplink Include 8 set of records in this 2 hour (15 minute interval / record).** 275 275 276 276 ... ... @@ -282,9 +282,9 @@ 282 282 283 283 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. 284 284 285 -(% border=" 1.5" style="background-color:#ffffcc; color:green; width:520px" %)286 -| =(% scope="row" style="width:50px;" %)**Size(bytes)**|(% style="width:40px" %)**8**|(% style="width:20px" %)**2**|(% style="width:25px" %)**2**|(% style="width:60px" %)**1**|(% style="width:20px" %)**1**|(% style="width:40px" %)**1**|(% style="width:40px" %)**2**|(% style="width:50px" %)**2**|(% style="width:50px" %)**4**|(% style="width:50px" %)**2**|(% style="width:35px" %)**2**|(% style="width:40px" %)**4**287 -| =(% style="width:;" %)**Value**|(% style="width:83px" %)Device ID|(% style="width:44px" %)Ver|(% style="width:42px" %)BAT|(% style="width:124px" %)Signal Strength|(% style="width:57px" %)MOD|(% style="width:80px" %)Interrupt|(% style="width:69px" %)Soil PH|(% style="width:134px" %)Soil Temperature|(% style="width:98px" %)Time stamp|(% style="width:134px" %)Soil Temperature|(% style="width:68px" %)Soil PH|(% style="width:125px" %)Time stamp .....278 +(% border="2" style="background-color:#ffffcc; color:green; width:1160px" %) 279 +|(% style="width:96px" %)**Size(bytes)**|(% style="width:83px" %)**8**|(% style="width:44px" %)**2**|(% style="width:42px" %)**2**|(% style="width:124px" %)1|(% style="width:57px" %)1|(% style="width:80px" %)1|(% style="width:69px" %)2|(% style="width:134px" %)2|(% style="width:98px" %)4|(% style="width:134px" %)2|(% style="width:68px" %)2|(% style="width:125px" %)4 280 +|(% style="width:96px" %)**Value**|(% style="width:83px" %)Device ID|(% style="width:44px" %)Ver|(% style="width:42px" %)BAT|(% style="width:124px" %)Signal Strength|(% style="width:57px" %)MOD|(% style="width:80px" %)Interrupt|(% style="width:69px" %)Soil PH|(% style="width:134px" %)Soil Temperature|(% style="width:98px" %)Time stamp|(% style="width:134px" %)Soil Temperature|(% style="width:68px" %)Soil PH|(% style="width:125px" %)Time stamp ..... 288 288 289 289 If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NSPH01 uplink data. 290 290 ... ... @@ -291,48 +291,25 @@ 291 291 [[image:image-20220907153902-15.png||height="581" width="804"]] 292 292 293 293 294 -((( 295 295 The payload is ASCII string, representative same HEX: 296 -))) 297 297 298 -((( 299 - 300 -))) 289 +0x(% style="color:red" %)f868411056754138(% style="color:blue" %)0064(% style="color:green" %)0c78(% style="color:red" %)17(% style="color:blue" %)01(% style="color:green" %)00(% style="color:red" %)**//0225010b6315537b//**010b0226631550fb//**010e022663154d77**//01110225631549f1//**011502246315466b**//01190223631542e5//**011d022163153f62**//011e022163153bde//**011e022163153859**//(%%) where: 301 301 302 -((( 303 -**0x (% style="color:red" %)__f868411056754138__ (% style="color:blue" %)__0064 __ (% style="color:green" %)__0c78__ (% style="color:#00b0f0" %)__17__ (% style="color:#7030a0" %)__01__ (% style="color:#d60093" %)__00__ (% style="color:#a14d07" %)__0225 __ (% style="color:#0020b0" %) __010b__ (% style="color:#420042" %)__6315537b__ (% style="color:#663300" %)//__010b0226631550fb__ __010e022663154d77 01110225631549f1 011502246315466b 01190223631542e5 011d022163153f62 011e022163153bde 011e022163153859__//(%%)** 304 -))) 291 +* (% style="color:red" %)Device ID: 0xf868411056754138 = f868411056754138 292 +* (% style="color:blue" %)Version: 0x0064=100=1.0.0 293 +* (% style="color:green" %)BAT: 0x0c78 = 3192 mV = 3.192V 294 +* (% style="color:red" %)Singal: 0x17 = 23 295 +* (% style="color:blue" %)Mod: 0x01 = 1 296 +* (% style="color:green" %)Interrupt: 0x00= 0 297 +* Soil PH: 0x0225= 549 = 5.49 298 +* Soil Temperature: 0x010B =267=26.7 °C 299 +* Time stamp : 0x6315537b =1662342011 ([[Unix Epoch Time>>url:http://www.epochconverter.com/]]) 300 +* Soil Temperature,Soil PH,Time stamp : 010b0226631550fb 301 +* (% style="color:red" %)8 sets of recorded data: Temperature,Soil PH,Time stamp : 010e022663154d77,....... 305 305 306 -((( 307 - 308 308 309 -**where:** 310 -))) 311 311 312 -* (% style="color:#037691" %)**Device ID:**(%%)** **0xf868411056754138 = f868411056754138 313 313 314 -* (% style="color:#037691" %)**Version:** (%%) 0x0064=100=1.0.0 315 - 316 -* (% style="color:#037691" %)**BAT:** (%%) 0x0c78 = 3192 mV = 3.192V 317 - 318 -* (% style="color:#037691" %)**Singal:** (%%)0x17 = 23 319 - 320 -* (% style="color:#037691" %)**Mod:** (%%) 0x01 = 1 321 - 322 -* (% style="color:#037691" %)**Interrupt:**(%%) 0x00= 0 323 - 324 -* (% style="color:#037691" %)**Soil PH:** (%%) 0x0225= 549 = 5.49 325 - 326 -* (% style="color:#037691" %)**Soil Temperature:**(%%) 0x010b =267=26.7 °C 327 - 328 -* (% style="color:#037691" %)**Time stamp :** (%%) 0x6315537b =1662342011 ([[Unix Epoch Time>>url:http://www.epochconverter.com/]]) 329 - 330 -* (% style="color:#037691" %)**Soil Temperature,Soil PH,Time stamp : **(%%) 010b0226631550fb 331 - 332 -* (% style="color:#037691" %)**8 sets of recorded data:**(%%) Temperature,Soil PH,Time stamp : 010e022663154d77,....... 333 - 334 - 335 - 336 336 == 2.4 Payload Explanation and Sensor Interface == 337 337 338 338 ... ... @@ -396,9 +396,9 @@ 396 396 397 397 Get the PH content of the soil. The value range of the register is 300-1000(Decimal), divide this value by 100 to get the percentage of PH in the soil. 398 398 399 -For example, if the data you get from the register is (% style="color:blue" %)**__0x05 0xDC__**(%%), the PH content in the soil is369 +For example, if the data you get from the register is **__0x05 0xDC__**, the PH content in the soil is 400 400 401 - (% style="color:blue" %)**0229(H) = 549(D) /100 = 5.49.**371 +**0229(H) = 549(D) /100 = 5.49.** 402 402 403 403 404 404 ... ... @@ -405,9 +405,8 @@ 405 405 === 2.4.6 Soil Temperature === 406 406 407 407 408 -Get the temperature in the soil. The value range of the register is -4000 - +800(Decimal), divide this value by 100 to get the temperature in the soil. For example, if the data you get from the register is (% style="color:blue" %)**__0x09 0xEC__**(%%), the temperature content in the soil is378 +Get the temperature in the soil. The value range of the register is -4000 - +800(Decimal), divide this value by 100 to get the temperature in the soil. For example, if the data you get from the register is **__0x09 0xEC__**, the temperature content in the soil is 409 409 410 - 411 411 **Example**: 412 412 413 413 If payload is 0105H: ((0x0105 & 0x8000)>>15 === 0),temp = 0105(H)/10 = 26.1 °C ... ... @@ -436,9 +436,8 @@ 436 436 437 437 The lower four bits of this data field shows if this packet is generated by interrupt or not. Click here for the hardware and software set up. 438 438 408 +Example: 439 439 440 -**Example:** 441 - 442 442 0x(00): Normal uplink packet. 443 443 444 444 0x(01): Interrupt Uplink Packet. ... ... @@ -498,6 +498,7 @@ 498 498 499 499 500 500 469 + 501 501 == 2.7 Installation and Maintain == 502 502 503 503 ... ... @@ -511,7 +511,7 @@ 511 511 === 2.7.2 Measurement === 512 512 513 513 514 -(% style="color:#037691" %) **Measurement the soil surface:**483 +**(% style="color:#037691" %)Measurement the soil surface:** 515 515 516 516 517 517 [[image:image-20220907154700-18.png]] ... ... @@ -525,7 +525,7 @@ 525 525 Put soil over the probe after insert. And start to measure. 526 526 527 527 528 -(% style="color:#037691" %) **Measurement inside soil:**497 +**(% style="color:#037691" %)Measurement inside soil:** 529 529 530 530 Dig a hole with diameter > 20CM. 531 531 ... ... @@ -545,12 +545,13 @@ 545 545 546 546 547 547 517 + 548 548 == 2.8 PH and Temperature alarm function == 549 549 550 550 551 -(% style="color:#037691" %) **➢ AT Command:**521 +**(% style="color:#037691" %)➢ AT Command:** 552 552 553 -(% style="color:blue" %) **AT+ PHALARM=min,max**523 +**(% style="color:blue" %)AT+ PHALARM=min,max** 554 554 555 555 ² When min=3, and max≠0, Alarm higher than max 556 556 ... ... @@ -559,7 +559,7 @@ 559 559 ² When min≠0 and max≠0, Alarm higher than max or lower than min 560 560 561 561 562 -(% style="color:blue" %) **Example:**532 +**(% style="color:blue" %)Example:** 563 563 564 564 AT+ PHALARM =5,8 ~/~/ Alarm when PH lower than 5. 565 565 ... ... @@ -572,33 +572,31 @@ 572 572 ² When min≠0 and max≠0, Alarm higher than max or lower than min 573 573 574 574 575 -(% style="color:blue" %) **Example:**545 +**(% style="color:blue" %)Example:** 576 576 577 577 AT+ TEMPALARM=20,30 ~/~/ Alarm when temperature lower than 20. 578 578 579 579 580 580 581 -== 2.9 551 +== 2.9 Set the number of data to be uploaded and the recording time == 582 582 583 583 584 -(% style="color:#037691" %) **➢ AT Command:**554 +**(% style="color:#037691" %)➢ AT Command:** 585 585 586 -* (% style="color:blue" %)**AT+TR=900** (%%) ~/~/ The unit is seconds, and the default is to record data once every 900 seconds.( The minimum can be set to 180 seconds) 587 -* (% style="color:blue" %)**AT+NOUD=8** (%%) ~/~/ The device uploads 8 sets of recorded data by default. Up to 32 sets of record data can be uploaded. 556 +**(% style="color:blue" %)AT+TR=900** (%%) ~/~/ The unit is seconds, and the default is to record data once every 900 seconds.( The minimum can be set to 180 seconds) 588 588 589 - The di agram belowexplainsthe relationshipbetweenTR, NOUD,andTDCmore clearly**:**558 +**(% style="color:blue" %)AT+NOUD=8** (%%) ~/~/ The device uploads 8 sets of recorded data by default. Up to 32 sets of record data can be uploaded. 590 590 591 -[[image:image-20221009000933-1.png||height="750" width="1043"]] 592 592 561 +== 2.10 Read or Clear cached data == 593 593 594 594 595 - ==2.10 Reador Clearcacheddata==564 +**(% style="color:#037691" %)➢ AT Command:** 596 596 566 +**(% style="color:blue" %)AT+CDP** (%%) ~/~/ Read cached data 597 597 598 -(% style="color: #037691" %)**➢ATCommand:**568 +**(% style="color:blue" %)AT+CDP=0** (%%) ~/~/ Clear cached data 599 599 600 -* (% style="color:blue" %)**AT+CDP** (%%) ~/~/ Read cached data 601 -* (% style="color:blue" %)**AT+CDP=0** (%%) ~/~/ Clear cached data 602 602 603 603 [[image:image-20220907154700-19.png]] 604 604 ... ... @@ -619,9 +619,9 @@ 619 619 == 2.12 Firmware Change Log == 620 620 621 621 622 -Download URL & Firmware Change log: [[https:~~/~~/www.dropbox.com/sh/1 tv07fro2pvjqj8/AAD-2wbfGfluTZfh38fQqdA_a?dl=0>>https://www.dropbox.com/sh/1tv07fro2pvjqj8/AAD-2wbfGfluTZfh38fQqdA_a?dl=0]]590 +Download URL & Firmware Change log: [[https:~~/~~/www.dropbox.com/sh/1zmcakvbkf24f8x/AACmq2dZ3iRB9F1nVWeEB9Moa?dl=0>>url:https://www.dropbox.com/sh/1zmcakvbkf24f8x/AACmq2dZ3iRB9F1nVWeEB9Moa?dl=0]] 623 623 624 -Upgrade Instruction: [[Upgrade Firmware>> ||anchor="H5.1200BHowtoUpgradeFirmware"]]592 +Upgrade Instruction: [[Upgrade Firmware>>path:#H5.1200BHowtoUpgradeFirmware]] 625 625 626 626 627 627 ... ... @@ -652,9 +652,9 @@ 652 652 653 653 Instruction to use as below: 654 654 655 -(% style="color:blue" %) **Step 1: **(%%)Downlink the up-to-date DRAGINO_Battery_Life_Prediction_Table.xlsx from: [[https:~~/~~/www.dragino.com/downloads/index.php?dir=LoRa_End_Node/Battery_Analyze/>>url:https://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/Battery_Analyze/]]623 +**(% style="color:blue" %)Step 1: **(%%)Downlink the up-to-date DRAGINO_Battery_Life_Prediction_Table.xlsx from: [[https:~~/~~/www.dragino.com/downloads/index.php?dir=LoRa_End_Node/Battery_Analyze/>>url:https://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/Battery_Analyze/]] 656 656 657 -(% style="color: blue" %)**Step 2: **(%%) Open it and choose625 +**(% style="color:#037691" %)Step 2: **(%%) Open it and choose 658 658 659 659 * Product Model 660 660 * Uplink Interval ... ... @@ -712,7 +712,7 @@ 712 712 AT+<CMD>=? : Get the value 713 713 714 714 715 -(% style="color:#037691" %) **General Commands**683 +**(% style="color:#037691" %)General Commands** 716 716 717 717 AT : Attention 718 718 ... ... @@ -757,17 +757,17 @@ 757 757 AT+ PHCAL : calibrate PH value 758 758 759 759 760 -(% style="color:#037691" %) **COAP Management**728 +**(% style="color:#037691" %)COAP Management** 761 761 762 762 AT+URI : Resource parameters 763 763 764 764 765 -(% style="color:#037691" %) **UDP Management**733 +**(% style="color:#037691" %)UDP Management** 766 766 767 767 AT+CFM : Upload confirmation mode (only valid for UDP) 768 768 769 769 770 -(% style="color:#037691" %) **MQTT Management**738 +**(% style="color:#037691" %)MQTT Management** 771 771 772 772 AT+CLIENT : Get or Set MQTT client 773 773 ... ... @@ -780,7 +780,7 @@ 780 780 AT+SUBTOPIC : Get or Set MQTT subscription topic 781 781 782 782 783 -(% style="color:#037691" %) **Information**751 +**(% style="color:#037691" %)Information** 784 784 785 785 AT+FDR : Factory Data Reset 786 786 ... ... @@ -798,7 +798,7 @@ 798 798 799 799 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]] 800 800 801 -(% style="color:red" %) **Notice, NSPH01 and LSPH01 share the same mother board. They use the same connection and method to update.**769 +**(% style="color:red" %)Notice, **NSPH01 **and **LSPH01 **share the same mother board. They use the same connection and method to update.** 802 802 803 803 804 804 ... ... @@ -822,7 +822,7 @@ 822 822 == 6.2 AT Command input doesn't work == 823 823 824 824 825 -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 (% style="color:green" %) **ENTER**(%%) while sending out the command. Some serial tool doesn't send (% style="color:green" %)**ENTER** (%%)while press the send key, user need to add ENTER in their string.793 +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 **(% style="color:green" %)ENTER**(%%) while sending out the command. Some serial tool doesn't send **(% style="color:green" %)ENTER** (%%)while press the send key, user need to add ENTER in their string. 826 826 827 827 828 828 ... ... @@ -843,13 +843,12 @@ 843 843 844 844 **Dimension and weight**: 845 845 846 -* Device Size: cm 847 -* Device Weight: g 848 -* Package Size / pcs : cm 849 -* Weight / pcs : g 814 +* Size: 195 x 125 x 55 mm 815 +* Weight: 420g 850 850 851 851 852 852 819 + 853 853 = 9. Support = 854 854 855 855
- image-20220923101327-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -12.1 KB - Content
- image-20221009000933-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Edwin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -282.9 KB - Content