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)
Details
- Page properties
-
- Content
-
... ... @@ -9,32 +9,21 @@ 9 9 10 10 = 1. Introduction = 11 11 12 + 12 12 == 1.1 What is NSPH01 Soil pH Sensor == 13 13 14 14 15 -((( 16 16 The Dragino NSPH01 is a (% style="color:blue" %)**NB-IoT soil pH sensor**(%%) for IoT of Agriculture. It is designed to measure the soil pH and soil temperature, so to send to the platform to analyze the soil acid or alkali level. The probe is IP68 waterproof. 17 -))) 18 18 19 -((( 20 20 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. 21 -))) 22 22 23 -((( 24 24 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. 25 -))) 26 26 27 -((( 28 28 NSPH01 supports different uplink methods include (% style="color:blue" %)**TCP,MQTT,UDP and CoAP **(%%)for different application requirement. 29 -))) 30 30 31 -((( 32 32 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) 33 -))) 34 34 35 -((( 36 36 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. 37 -))) 38 38 39 39 40 40 [[image:image-20220907153151-1.png]] ... ... @@ -43,6 +43,7 @@ 43 43 [[image:M_K`YF9`CAYAE\@}3T]FHT$9.png]] 44 44 45 45 35 + 46 46 == 1.2 Features == 47 47 48 48 ... ... @@ -61,6 +61,7 @@ 61 61 * Micro SIM card slot 62 62 * 8500mAh Battery for long term use 63 63 54 + 64 64 == 1.3 Specification == 65 65 66 66 ... ... @@ -71,13 +71,14 @@ 71 71 72 72 (% style="color:#037691" %)**NB-IoT Spec:** 73 73 74 -* B1 @H-FDD: 2100MHz 75 -* B3 @H-FDD: 1800MHz 76 -* B8 @H-FDD: 900MHz 77 -* B5 @H-FDD: 850MHz 78 -* B20 @H-FDD: 800MHz 79 -* B28 @H-FDD: 700MHz 65 +* - B1 @H-FDD: 2100MHz 66 +* - B3 @H-FDD: 1800MHz 67 +* - B8 @H-FDD: 900MHz 68 +* - B5 @H-FDD: 850MHz 69 +* - B20 @H-FDD: 800MHz 70 +* - B28 @H-FDD: 700MHz 80 80 72 + 81 81 == 1.4 Probe Specification == 82 82 83 83 ... ... @@ -98,11 +98,13 @@ 98 98 * IP68 Protection 99 99 * Length: 3.5 meters 100 100 93 + 101 101 == 1.5 Applications == 102 102 103 103 104 104 * Smart Agriculture 105 105 99 + 106 106 == 1.6 Pin mapping and power on == 107 107 108 108 ... ... @@ -109,8 +109,10 @@ 109 109 [[image:image-20220907153300-2.png]] 110 110 111 111 106 + 112 112 = 2. Use NSPH01 to communicate with IoT Server = 113 113 109 + 114 114 == 2.1 How it works == 115 115 116 116 ... ... @@ -122,8 +122,10 @@ 122 122 [[image:image-20220907153416-3.png]] 123 123 124 124 121 + 125 125 == 2.2 Configure the NSPH01 == 126 126 124 + 127 127 === 2.2.1 Test Requirement === 128 128 129 129 ... ... @@ -139,6 +139,7 @@ 139 139 [[image:image-20220907153445-4.png]] 140 140 141 141 140 + 142 142 === 2.2.2 Insert SIM card === 143 143 144 144 ... ... @@ -148,6 +148,7 @@ 148 148 [[image:image-20220907153505-5.png]] 149 149 150 150 150 + 151 151 === 2.2.3 Connect USB – TTL to NSPH01 to configure it === 152 152 153 153 ... ... @@ -180,6 +180,7 @@ 180 180 (% style="color:red" %)**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]] 181 181 182 182 183 + 183 183 === 2.2.4 Use CoAP protocol to uplink data === 184 184 185 185 ... ... @@ -204,6 +204,7 @@ 204 204 [[image:image-20220907153612-8.png||height="529" width="729"]] 205 205 206 206 208 + 207 207 === 2.2.5 Use UDP protocol to uplink data(Default protocol) === 208 208 209 209 ... ... @@ -219,6 +219,7 @@ 219 219 [[image:image-20220907153703-10.png||height="309" width="738"]] 220 220 221 221 224 + 222 222 === 2.2.6 Use MQTT protocol to uplink data === 223 223 224 224 ... ... @@ -241,6 +241,8 @@ 241 241 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. 242 242 243 243 247 + 248 + 244 244 === 2.2.7 Use TCP protocol to uplink data === 245 245 246 246 ... ... @@ -255,6 +255,7 @@ 255 255 [[image:image-20220907153827-14.png||height="236" width="684"]] 256 256 257 257 263 + 258 258 === 2.2.8 Change Update Interval === 259 259 260 260 ... ... @@ -265,6 +265,7 @@ 265 265 (% 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).** 266 266 267 267 274 + 268 268 == 2.3 Uplink Payload == 269 269 270 270 ... ... @@ -272,9 +272,9 @@ 272 272 273 273 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. 274 274 275 -(% border="1 " cellspacing="5" style="background-color:#f2f2f2; width:520px" %)276 -|(% s tyle="background-color:#d9e2f3;color:#0070c0;width:50px" %)**Size(bytes)**|(% style="background-color:#d9e2f3; color:#0070c0;width:40px" %)**8**|(% style="background-color:#d9e2f3; color:#0070c0;width:20px" %)**2**|(% style="background-color:#d9e2f3; color:#0070c0;width:25px" %)**2**|(% style="background-color:#d9e2f3; color:#0070c0;width:60px" %)**1**|(% style="background-color:#d9e2f3; color:#0070c0;width:20px" %)**1**|(% style="background-color:#d9e2f3; color:#0070c0;width:40px" %)**1**|(% style="background-color:#d9e2f3; color:#0070c0;width:40px" %)**2**|(% style="background-color:#d9e2f3; color:#0070c0;width:50px" %)**2**|(% style="background-color:#d9e2f3; color:#0070c0;width:50px" %)**4**|(% style="background-color:#d9e2f3; color:#0070c0;width:50px" %)**2**|(% style="background-color:#d9e2f3; color:#0070c0;width:35px" %)**2**|(% style="background-color:#d9e2f3; color:#0070c0;width:40px" %)**4**277 -|(% 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 ..... 282 +(% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %) 283 +|=(% 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:30px" %)**2**|(% style="width:40px" %)**4** 284 +|=(% 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 ..... 278 278 279 279 If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NSPH01 uplink data. 280 280 ... ... @@ -321,8 +321,10 @@ 321 321 322 322 * (% style="color:#037691" %)**8 sets of recorded data:**(%%) Temperature,Soil PH,Time stamp : 010e022663154d77,....... 323 323 331 + 324 324 == 2.4 Payload Explanation and Sensor Interface == 325 325 334 + 326 326 === 2.4.1 Device ID === 327 327 328 328 ... ... @@ -338,6 +338,7 @@ 338 338 The Device ID is stored in a none-erase area, Upgrade the firmware or run AT+FDR won't erase Device ID. 339 339 340 340 350 + 341 341 === 2.4.2 Version Info === 342 342 343 343 ... ... @@ -346,6 +346,7 @@ 346 346 For example: 0x00 64 : this device is NSPH01 with firmware version 1.0.0. 347 347 348 348 359 + 349 349 === 2.4.3 Battery Info === 350 350 351 351 ... ... @@ -356,6 +356,7 @@ 356 356 Ex2: 0x0B49 = 2889mV 357 357 358 358 370 + 359 359 === 2.4.4 Signal Strength === 360 360 361 361 ... ... @@ -374,6 +374,7 @@ 374 374 **99** Not known or not detectable 375 375 376 376 389 + 377 377 === 2.4.5 Soil PH === 378 378 379 379 ... ... @@ -384,6 +384,7 @@ 384 384 (% style="color:blue" %)**0229(H) = 549(D) /100 = 5.49.** 385 385 386 386 400 + 387 387 === 2.4.6 Soil Temperature === 388 388 389 389 ... ... @@ -397,6 +397,7 @@ 397 397 If payload is FF7EH: ((FF7E & 0x8000)>>15 ===1),temp = (FF7E(H)-FFFF(H))/10 = -12.9 °C 398 398 399 399 414 + 400 400 === 2.4.7 Timestamp === 401 401 402 402 ... ... @@ -405,6 +405,7 @@ 405 405 Convert Unix timestamp to time 2022-9-5 9:40:11. 406 406 407 407 423 + 408 408 === 2.4.8 Digital Interrupt === 409 409 410 410 ... ... @@ -424,6 +424,7 @@ 424 424 0x(01): Interrupt Uplink Packet. 425 425 426 426 443 + 427 427 === 2.4.9 +5V Output === 428 428 429 429 ... ... @@ -436,17 +436,15 @@ 436 436 Means set 5V valid time to have 1000ms. So the real 5V output will actually have 1000ms + sampling time for other sensors.** ** 437 437 438 438 456 + 439 439 == 2.5 Downlink Payload == 440 440 441 441 442 442 By default, NSPH01 prints the downlink payload to console port. 443 443 444 -(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:479.818px" %) 445 -|=(% style="width: 183px; background-color:#D9E2F3;color:#0070C0" %)**Downlink Control Type**|=(% style="width: 55px; background-color:#D9E2F3;color:#0070C0" %)FPort|=(% style="width: 93px; background-color:#D9E2F3;color:#0070C0" %)**Type Code**|=(% style="width: 146px; background-color: rgb(217, 226, 243); color: rgb(0, 112, 192);" %)**Downlink payload size(bytes)** 446 -|(% style="width:183px" %)TDC (Transmit Time Interval)|(% style="width:55px" %)Any|(% style="width:93px" %)01|(% style="width:146px" %)4 447 -|(% style="width:183px" %)RESET|(% style="width:55px" %)Any|(% style="width:93px" %)04|(% style="width:146px" %)2 448 -|(% style="width:183px" %)INTMOD|(% style="width:55px" %)Any|(% style="width:93px" %)06|(% style="width:146px" %)4 462 +[[image:image-20220907154636-17.png]] 449 449 464 + 450 450 (% style="color:blue" %)**Examples:** 451 451 452 452 * (% style="color:#037691" %)** Set TDC** ... ... @@ -466,6 +466,7 @@ 466 466 Downlink Payload: 06000003, Set AT+INTMOD=3 467 467 468 468 484 + 469 469 == 2.6 LED Indicator == 470 470 471 471 ... ... @@ -478,6 +478,7 @@ 478 478 479 479 == 2.7 Installation and Maintain == 480 480 497 + 481 481 === 2.7.1 Before measurement === 482 482 483 483 ... ... @@ -484,6 +484,7 @@ 484 484 If the NSPH01 has more than 7 days not use or just clean the pH probe. User should put the probe inside pure water for more than 24 hours for activation. If no put in water, user need to put inside soil for more than 24 hours to ensure the measurement accuracy. 485 485 486 486 504 + 487 487 === 2.7.2 Measurement === 488 488 489 489 ... ... @@ -508,6 +508,7 @@ 508 508 Insert the probe inside, method like measure the surface. 509 509 510 510 529 + 511 511 === 2.7.3 Maintain Probe === 512 512 513 513 ... ... @@ -550,6 +550,7 @@ 550 550 AT+ TEMPALARM=20,30 ~/~/ Alarm when temperature lower than 20. 551 551 552 552 572 + 553 553 == 2.9 Set the number of data to be uploaded and the recording time == 554 554 555 555 ... ... @@ -563,6 +563,7 @@ 563 563 [[image:image-20221009000933-1.png||height="750" width="1043"]] 564 564 565 565 586 + 566 566 == 2.10 Read or Clear cached data == 567 567 568 568 ... ... @@ -574,6 +574,7 @@ 574 574 [[image:image-20220907154700-19.png]] 575 575 576 576 598 + 577 577 == 2.11 Calibration == 578 578 579 579 ... ... @@ -581,34 +581,11 @@ 581 581 582 582 After stable, user can use below command to calibrate. 583 583 584 -(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:520px" %) 585 -|(% style="background-color:#d9e2f3; color:#0070c0; width:120px" %)**pH buffer solution**|(% style="background-color:#d9e2f3; color:#0070c0; width:150px" %)**AT Command to calibrate**|(% style="background-color:#d9e2f3; color:#0070c0; width:150px" %)**Downlink Command**|(% style="background-color:#d9e2f3; color:#0070c0; width:100px" %)**Read Cal Value** 586 -|(% style="width:149px" %)4.00|(% style="width:197px" %)AT+PHCAL=4|(% style="width:206px" %)((( 587 -0x13 04 588 -Reply with Calibrate payload 589 -)))|(% style="width:136px" %)((( 590 -AT+PHCAL=? 591 -Example 41,61,91 592 -))) 593 -|(% style="width:149px" %)6.86|(% style="width:197px" %)AT+PHCAL=6|(% style="width:206px" %)((( 594 -0x13 06 595 -Reply with Calibrate payload 596 -)))|(% style="width:136px" %)AT+PHCAL=? 597 -|(% style="width:149px" %)9.18|(% style="width:197px" %)AT+PHCAL=9|(% style="width:206px" %)((( 598 -0x13 09 599 -Reply with Calibrate payload 600 -)))|(% style="width:136px" %)AT+PHCAL=? 601 -|(% style="width:149px" %)Factory Default|(% style="width:197px" %)AT+PHCAL=15|(% style="width:206px" %)((( 602 -0x13 15 603 -Reply with Calibrate payload 604 -)))|(% style="width:136px" %)((( 605 -AT+PHCAL=? 606 -Example 151 607 -))) 608 608 609 - 607 +[[image:image-20220907154700-20.png]] 610 610 611 611 610 + 612 612 == 2.12 Firmware Change Log == 613 613 614 614 ... ... @@ -617,14 +617,64 @@ 617 617 Upgrade Instruction: [[Upgrade Firmware>>||anchor="H5.1200BHowtoUpgradeFirmware"]] 618 618 619 619 620 -== 2.13 Battery & Power Consumption == 621 621 620 +== 2.13 Battery Analysis == 622 622 623 -NSPH01 uses ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace. 624 624 625 - [[**BatteryInfo & Power Consumption Analyze**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]].623 +=== 2.13.1 Battery Type === 626 626 627 627 626 +The NSPH01 battery is a combination of an 8500mAh Li/SOCI2 Battery and a Super Capacitor. The battery is none-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. 627 + 628 +The battery is designed to last for several years depends on the actually use environment and update interval. 629 + 630 +The battery-related documents as below: 631 + 632 +* [[Battery Dimension>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]] 633 +* [[Lithium-Thionyl Chloride Battery datasheet>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]] 634 +* [[Lithium-ion Battery-Capacitor datasheet>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]] 635 + 636 +[[image:image-20220907154700-21.png]] 637 + 638 + 639 + 640 +=== 2.13.2 Power consumption Analyze === 641 + 642 + 643 +Dragino battery powered product are all runs in Low Power mode. We have an update battery calculator which base on the measurement of the real device. User can use this calculator to check the battery life and calculate the battery life if want to use different transmit interval. 644 + 645 +Instruction to use as below: 646 + 647 +(% 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/]] 648 + 649 +(% style="color:blue" %)**Step 2: **(%%) Open it and choose 650 + 651 +* Product Model 652 +* Uplink Interval 653 +* Working Mode 654 + 655 +And the Life expectation in difference case will be shown on the right. 656 + 657 + 658 +[[image:image-20220907154700-22.jpeg]] 659 + 660 + 661 + 662 + 663 +=== 2.13.3 Battery Note === 664 + 665 + 666 +The Li-SICO battery is designed for small current / long period application. It is not good to use a high current, short period transmit method. The recommended minimum period for use of this battery is 5 minutes. If you use a shorter period time to transmit LoRa, then the battery life may be decreased. 667 + 668 + 669 + 670 +=== 2.13.4 Replace the battery === 671 + 672 + 673 +The default battery pack of NSPH01 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). 674 + 675 + 676 + 628 628 = 3. Access NB-IoT Module = 629 629 630 630 ... ... @@ -637,8 +637,10 @@ 637 637 638 638 639 639 689 + 640 640 = 4. Using the AT Commands = 641 641 692 + 642 642 == 4.1 Access AT Commands == 643 643 644 644 ... ... @@ -728,8 +728,10 @@ 728 728 AT+PWORD : Serial Access Password 729 729 730 730 782 + 731 731 = 5. FAQ = 732 732 785 + 733 733 == 5.1 How to Upgrade Firmware == 734 734 735 735 ... ... @@ -740,6 +740,7 @@ 740 740 (% style="color:red" %)**Notice, NSPH01 and LSPH01 share the same mother board. They use the same connection and method to update.** 741 741 742 742 796 + 743 743 == 5.2 Can I calibrate NSPH01 to different soil types? == 744 744 745 745 ... ... @@ -746,8 +746,10 @@ 746 746 NSPH01 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]]. 747 747 748 748 803 + 749 749 = 6. Trouble Shooting = 750 750 806 + 751 751 == 6.1 Connection problem when uploading firmware == 752 752 753 753 ... ... @@ -754,6 +754,7 @@ 754 754 **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]] 755 755 756 756 813 + 757 757 == 6.2 AT Command input doesn't work == 758 758 759 759 ... ... @@ -760,12 +760,7 @@ 760 760 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. 761 761 762 762 763 -== 6.3 Not able to connect to NB-IoT network and keep showing "Signal Strength:99". == 764 764 765 - 766 -This means sensor is trying to join the NB-IoT network but fail. Please see this link for **//[[trouble shooting for signal strenght:99>>doc:Main.CSQ\:99,99.WebHome]]//**. 767 - 768 - 769 769 = 7. Order Info = 770 770 771 771 ... ... @@ -772,6 +772,7 @@ 772 772 Part Number**:** NSPH01 773 773 774 774 827 + 775 775 = 8. Packing Info = 776 776 777 777 ... ... @@ -787,6 +787,7 @@ 787 787 * Package Size / pcs : cm 788 788 * Weight / pcs : g 789 789 843 + 790 790 = 9. Support = 791 791 792 792