Last modified by Xiaoling on 2024/01/17 16:19
<
From version < 73.2 >
edited by Xiaoling
on 2022/06/07 17:24
To version < 76.2 >
edited by Xiaoling
on 2022/06/07 18:00
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -65,23 +65,29 @@
65 65  
66 66  
67 67  
68 -
69 -
70 -
71 -
72 72  = 1. Introduction =
73 73  
74 74  == 1.1 ​What is LoRaWAN Soil pH Sensor ==
75 75  
72 +(((
76 76  The Dragino LSPH01 is a (% style="color:#4f81bd" %)**LoRaWAN 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.
74 +)))
77 77  
76 +(((
78 78  LSPH01 probe is made by Solid AgCl reference electrode and Pure metal pH sensitive electrode. It can detect soil's** (% style="color:#4f81bd" %)pH (%%)**with high accuracy and stable value. The LSPH01 probe can be buried into soil for long time use.
78 +)))
79 79  
80 +(((
80 80  The LoRa wireless technology used in LSPH01 allows device to send data and reach extremely long ranges at low data-rates. It provides ultra-long range spread spectrum communication and high interference immunity whilst minimizing current consumption.
82 +)))
81 81  
84 +(((
82 82  LSPH01 is powered by (% style="color:#4f81bd" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long term use up to 5 years.
86 +)))
83 83  
88 +(((
84 84  Each LSPH01 is pre-load with a set of unique keys for LoRaWAN registrations, register these keys to local LoRaWAN server and it will auto connect after power on.
90 +)))
85 85  
86 86  
87 87  [[image:1654592435432-887.png]]
... ... @@ -104,9 +104,6 @@
104 104  * IP68 rate for the Sensor Probe
105 105  * 8500mAh Battery for long term use
106 106  
107 -
108 -
109 -
110 110  == 1.3 Probe Specification ==
111 111  
112 112  
... ... @@ -209,7 +209,9 @@
209 209  [[image:image-20220607170442-2.png]]
210 210  
211 211  
215 +(((
212 212  (% style="color:blue" %)**Step 3**(%%)**:** The LSPH01 will auto join to the TTN network. After join success, it will start to upload messages to TTN and you can see the messages in the panel.
217 +)))
213 213  
214 214  [[image:1654592697690-910.png]]
215 215  
... ... @@ -217,11 +217,17 @@
217 217  
218 218  == 2.3 ​Uplink Payload ==
219 219  
225 +(((
220 220  LSPH01 will uplink payload via LoRaWAN with below payload format: 
227 +)))
221 221  
229 +(((
222 222  Uplink payload includes in total 11 bytes.
231 +)))
223 223  
233 +(((
224 224  Normal uplink payload:
235 +)))
225 225  
226 226  (% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %)
227 227  |(((
... ... @@ -305,18 +305,21 @@
305 305  
306 306  === 2.3.6 Message Type ===
307 307  
319 +(((
308 308  For a normal uplink payload, the message type is always 0x01.
321 +)))
309 309  
323 +(((
310 310  Valid Message Type:
325 +)))
311 311  
312 312  
313 313  (% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %)
314 -|**Message Type Code**|**Description**|**Payload**
329 +|=**Message Type Code**|=**Description**|=**Payload**
315 315  |0x01|Normal Uplink|[[Normal Uplink Payload>>path:#H2.3200BUplinkPayload]]
316 316  |0x02|Reply configures info|[[Configure Info Payload>>path:#H3.4GetFirmwareVersionInfo]]
317 317  |0x03|Reply Calibration Info|[[Calibration Payload>>path:#H2.7Calibration]]
318 318  
319 -
320 320  === 2.3.7 Decode payload in The Things Network ===
321 321  
322 322  While using TTN network, you can add the payload format to decode the payload.
... ... @@ -342,12 +342,21 @@
342 342  
343 343  == 2.5 ​Show Data in DataCake IoT Server ==
344 344  
359 +(((
345 345  [[DATACAKE>>url:https://datacake.co/]] provides a human friendly interface to show the sensor data, once we have data in TTN, we can use [[DATACAKE>>url:https://datacake.co/]] to connect to TTN and see the data in DATACAKE. Below are the steps:
361 +)))
346 346  
363 +(((
364 +
365 +)))
347 347  
367 +(((
348 348  (% style="color:blue" %)**Step 1**(%%)**: Be sure that your device is programmed and properly connected to the network at this time.**
369 +)))
349 349  
371 +(((
350 350  (% style="color:blue" %)**Step 2**(%%)**: To configure the Application to forward data to DATACAKE you will need to add integration. To add the DATACAKE integration, perform the following steps:**
373 +)))
351 351  
352 352  
353 353  [[image:1654592790040-760.png]]
... ... @@ -370,9 +370,13 @@
370 370  [[image:1654592856403-259.png]]
371 371  
372 372  
396 +(((
373 373  (% style="color:blue" %)**Step 5**(%%)**: add payload decode**
398 +)))
374 374  
400 +(((
375 375  Download Datacake decoder from: [[https:~~/~~/www.dragino.com/downloads/index.pHp?dir=LoRa_End_Node/LSPH01/Decoder/>>url:https://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LSNPK01/Decoder/]]
402 +)))
376 376  
377 377  
378 378  [[image:1654592878525-845.png]]
... ... @@ -395,8 +395,10 @@
395 395  === 2.6.1 Before measurement ===
396 396  
397 397  (((
425 +(((
398 398  If the LSPH01 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. 
399 399  )))
428 +)))
400 400  
401 401  
402 402  
... ... @@ -403,24 +403,45 @@
403 403  === 2.6.2 Measurement ===
404 404  
405 405  
435 +(((
406 406  (% style="color:#4f81bd" %)**Measurement the soil surface:**
437 +)))
407 407  
439 +(((
408 408  [[image:1654592946732-634.png]]
441 +)))
409 409  
443 +(((
410 410  Choose the proper measuring position. Split the surface soil according to the measured deep.
445 +)))
411 411  
447 +(((
412 412  Put pure water, or rainwater to make the soil of measurement point to moist mud. Remove rocks or hard things.
449 +)))
413 413  
451 +(((
414 414  Slowly insert the probe to the measure point. Don’t use large force which will break the probe. Make sure not shake when inserting.
453 +)))
415 415  
455 +(((
416 416  Put soil over the probe after insert. And start to measure.
457 +)))
417 417  
459 +(((
460 +
461 +)))
418 418  
463 +(((
419 419  (% style="color:#4f81bd" %)**Measurement inside soil:**
465 +)))
420 420  
467 +(((
421 421  Dig a hole with diameter > 20CM.
469 +)))
422 422  
471 +(((
423 423  Insert the probe inside, method like measure the surface.
473 +)))
424 424  
425 425  
426 426  
... ... @@ -450,9 +450,13 @@
450 450  
451 451  == 2.7 Calibration ==
452 452  
503 +(((
453 453  User can do calibration for the probe. It is limited to use below pH buffer solution to calibrate: 4.00, 6.86, 9.18. When calibration, user need to clean the electrode and put the probe in the pH buffer solution to wait the value stable ( a new clean electrode might need max 24 hours to be stable).
505 +)))
454 454  
507 +(((
455 455  After stable, user can use below command to calibrate.
509 +)))
456 456  
457 457  [[image:image-20220607171149-4.png]]
458 458  
... ... @@ -459,7 +459,7 @@
459 459  
460 460  (% style="color:#037691" %)**Calibration Payload**
461 461  
462 -(% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %)
516 +(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %)
463 463  |(((
464 464  **Size**
465 465  
... ... @@ -487,7 +487,6 @@
487 487  * Reply to the confirmation package: 14 01
488 488  * Reply to non-confirmed packet: 14 00
489 489  
490 -
491 491  == 2.8 Frequency Plans ==
492 492  
493 493  (((
... ... @@ -497,32 +497,61 @@
497 497  
498 498  === 2.8.1 EU863-870 (EU868) ===
499 499  
553 +(((
500 500  (% style="color:blue" %)**Uplink:**
555 +)))
501 501  
557 +(((
502 502  868.1 - SF7BW125 to SF12BW125
559 +)))
503 503  
561 +(((
504 504  868.3 - SF7BW125 to SF12BW125 and SF7BW250
563 +)))
505 505  
565 +(((
506 506  868.5 - SF7BW125 to SF12BW125
567 +)))
507 507  
569 +(((
508 508  867.1 - SF7BW125 to SF12BW125
571 +)))
509 509  
573 +(((
510 510  867.3 - SF7BW125 to SF12BW125
575 +)))
511 511  
577 +(((
512 512  867.5 - SF7BW125 to SF12BW125
579 +)))
513 513  
581 +(((
514 514  867.7 - SF7BW125 to SF12BW125
583 +)))
515 515  
585 +(((
516 516  867.9 - SF7BW125 to SF12BW125
587 +)))
517 517  
589 +(((
518 518  868.8 - FSK
591 +)))
519 519  
593 +(((
594 +
595 +)))
520 520  
597 +(((
521 521  (% style="color:blue" %)**Downlink:**
599 +)))
522 522  
601 +(((
523 523  Uplink channels 1-9 (RX1)
603 +)))
524 524  
605 +(((
525 525  869.525 - SF9BW125 (RX2 downlink only)
607 +)))
526 526  
527 527  
528 528  
... ... @@ -544,49 +544,91 @@
544 544  * Use the Join successful sub-band if the server doesn’t include sub-band info in the OTAA Join Accept message ( TTN v2 doesn't include)
545 545  
546 546  
547 -
548 548  === 2.8.3 CN470-510 (CN470) ===
549 549  
631 +(((
550 550  Used in China, Default use CHE=1
633 +)))
551 551  
635 +(((
552 552  (% style="color:blue" %)**Uplink:**
637 +)))
553 553  
639 +(((
554 554  486.3 - SF7BW125 to SF12BW125
641 +)))
555 555  
643 +(((
556 556  486.5 - SF7BW125 to SF12BW125
645 +)))
557 557  
647 +(((
558 558  486.7 - SF7BW125 to SF12BW125
649 +)))
559 559  
651 +(((
560 560  486.9 - SF7BW125 to SF12BW125
653 +)))
561 561  
655 +(((
562 562  487.1 - SF7BW125 to SF12BW125
657 +)))
563 563  
659 +(((
564 564  487.3 - SF7BW125 to SF12BW125
661 +)))
565 565  
663 +(((
566 566  487.5 - SF7BW125 to SF12BW125
665 +)))
567 567  
667 +(((
568 568  487.7 - SF7BW125 to SF12BW125
669 +)))
569 569  
671 +(((
672 +
673 +)))
570 570  
675 +(((
571 571  (% style="color:blue" %)**Downlink:**
677 +)))
572 572  
679 +(((
573 573  506.7 - SF7BW125 to SF12BW125
681 +)))
574 574  
683 +(((
575 575  506.9 - SF7BW125 to SF12BW125
685 +)))
576 576  
687 +(((
577 577  507.1 - SF7BW125 to SF12BW125
689 +)))
578 578  
691 +(((
579 579  507.3 - SF7BW125 to SF12BW125
693 +)))
580 580  
695 +(((
581 581  507.5 - SF7BW125 to SF12BW125
697 +)))
582 582  
699 +(((
583 583  507.7 - SF7BW125 to SF12BW125
701 +)))
584 584  
703 +(((
585 585  507.9 - SF7BW125 to SF12BW125
705 +)))
586 586  
707 +(((
587 587  508.1 - SF7BW125 to SF12BW125
709 +)))
588 588  
711 +(((
589 589  505.3 - SF12BW125 (RX2 downlink only)
713 +)))
590 590  
591 591  
592 592  
... ... @@ -611,112 +611,219 @@
611 611  * Check what sub-band the LoRaWAN server ask from the OTAA Join Accept message and switch to that sub-band
612 612  * Use the Join successful sub-band if the server doesn’t include sub-band info in the OTAA Join Accept message ( TTN v2 doesn't include)
613 613  
614 -
615 -
616 616  === 2.8.5 AS920-923 & AS923-925 (AS923) ===
617 617  
740 +(((
618 618  (% style="color:blue" %)**Default Uplink channel:**
742 +)))
619 619  
744 +(((
620 620  923.2 - SF7BW125 to SF10BW125
746 +)))
621 621  
748 +(((
622 622  923.4 - SF7BW125 to SF10BW125
750 +)))
623 623  
752 +(((
753 +
754 +)))
624 624  
756 +(((
625 625  (% style="color:blue" %)**Additional Uplink Channel**:
758 +)))
626 626  
760 +(((
627 627  (OTAA mode, channel added by JoinAccept message)
762 +)))
628 628  
764 +(((
765 +
766 +)))
629 629  
768 +(((
630 630  (% style="color:blue" %)**AS920~~AS923 for Japan, Malaysia, Singapore**:
770 +)))
631 631  
772 +(((
632 632  922.2 - SF7BW125 to SF10BW125
774 +)))
633 633  
776 +(((
634 634  922.4 - SF7BW125 to SF10BW125
778 +)))
635 635  
780 +(((
636 636  922.6 - SF7BW125 to SF10BW125
782 +)))
637 637  
784 +(((
638 638  922.8 - SF7BW125 to SF10BW125
786 +)))
639 639  
788 +(((
640 640  923.0 - SF7BW125 to SF10BW125
790 +)))
641 641  
792 +(((
642 642  922.0 - SF7BW125 to SF10BW125
794 +)))
643 643  
796 +(((
797 +
798 +)))
644 644  
800 +(((
645 645  (% style="color:blue" %)**AS923 ~~ AS925 for Brunei, Cambodia, Hong Kong, Indonesia, Laos, Taiwan, Thailand, Vietnam**:
802 +)))
646 646  
804 +(((
647 647  923.6 - SF7BW125 to SF10BW125
806 +)))
648 648  
808 +(((
649 649  923.8 - SF7BW125 to SF10BW125
810 +)))
650 650  
812 +(((
651 651  924.0 - SF7BW125 to SF10BW125
814 +)))
652 652  
816 +(((
653 653  924.2 - SF7BW125 to SF10BW125
818 +)))
654 654  
820 +(((
655 655  924.4 - SF7BW125 to SF10BW125
822 +)))
656 656  
824 +(((
657 657  924.6 - SF7BW125 to SF10BW125
826 +)))
658 658  
828 +(((
829 +
830 +)))
659 659  
832 +(((
660 660  (% style="color:blue" %)**Downlink:**
834 +)))
661 661  
836 +(((
662 662  Uplink channels 1-8 (RX1)
838 +)))
663 663  
840 +(((
664 664  923.2 - SF10BW125 (RX2)
842 +)))
665 665  
666 666  
667 667  
668 668  === 2.8.6 KR920-923 (KR920) ===
669 669  
848 +(((
670 670  (% style="color:blue" %)**Default channel:**
850 +)))
671 671  
852 +(((
672 672  922.1 - SF7BW125 to SF12BW125
854 +)))
673 673  
856 +(((
674 674  922.3 - SF7BW125 to SF12BW125
858 +)))
675 675  
860 +(((
676 676  922.5 - SF7BW125 to SF12BW125
862 +)))
677 677  
864 +(((
865 +
866 +)))
678 678  
868 +(((
679 679  (% style="color:blue" %)**Uplink: (OTAA mode, channel added by JoinAccept message)**
870 +)))
680 680  
872 +(((
681 681  922.1 - SF7BW125 to SF12BW125
874 +)))
682 682  
876 +(((
683 683  922.3 - SF7BW125 to SF12BW125
878 +)))
684 684  
880 +(((
685 685  922.5 - SF7BW125 to SF12BW125
882 +)))
686 686  
884 +(((
687 687  922.7 - SF7BW125 to SF12BW125
886 +)))
688 688  
888 +(((
689 689  922.9 - SF7BW125 to SF12BW125
890 +)))
690 690  
892 +(((
691 691  923.1 - SF7BW125 to SF12BW125
894 +)))
692 692  
896 +(((
693 693  923.3 - SF7BW125 to SF12BW125
898 +)))
694 694  
900 +(((
901 +
902 +)))
695 695  
904 +(((
696 696  (% style="color:blue" %)**Downlink:**
906 +)))
697 697  
908 +(((
698 698  Uplink channels 1-7(RX1)
910 +)))
699 699  
912 +(((
700 700  921.9 - SF12BW125 (RX2 downlink only; SF12BW125 might be changed to SF9BW125)
914 +)))
701 701  
702 702  
703 703  
704 704  === 2.8.7 IN865-867 (IN865) ===
705 705  
920 +(((
706 706  (% style="color:blue" %)**Uplink:**
922 +)))
707 707  
924 +(((
708 708  865.0625 - SF7BW125 to SF12BW125
926 +)))
709 709  
928 +(((
710 710  865.4025 - SF7BW125 to SF12BW125
930 +)))
711 711  
932 +(((
712 712  865.9850 - SF7BW125 to SF12BW125
934 +)))
713 713  
936 +(((
937 +
938 +)))
714 714  
940 +(((
715 715  (% style="color:blue" %)**Downlink:**
942 +)))
716 716  
944 +(((
717 717  Uplink channels 1-3 (RX1)
946 +)))
718 718  
948 +(((
719 719  866.550 - SF10BW125 (RX2)
950 +)))
720 720  
721 721  
722 722  
... ... @@ -743,26 +743,51 @@
743 743  
744 744  = 3. Configure LSPH01 via AT Command or LoRaWAN Downlink =
745 745  
977 +(((
746 746  Use can configure LSPH01 via AT Command or LoRaWAN Downlink.
979 +)))
747 747  
748 -* AT Command Connection: See [[FAQ>>path:#H6.FAQ]].
749 -* LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>path:/xwiki/bin/view/Main/]]
981 +* (((
982 +AT Command Connection: See [[FAQ>>path:#H6.FAQ]].
983 +)))
984 +* (((
985 +LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>path:/xwiki/bin/view/Main/]]
986 +)))
750 750  
988 +(((
751 751  There are two kinds of commands to configure LSPH01, they are:
990 +)))
752 752  
753 -* (% style="color:#4f81bd" %)** General Commands**.
992 +* (((
993 +(% style="color:#4f81bd" %)** General Commands**.
994 +)))
754 754  
996 +(((
755 755  These commands are to configure:
998 +)))
756 756  
757 -* General system settings like: uplink interval.
758 -* LoRaWAN protocol & radio related command.
1000 +* (((
1001 +General system settings like: uplink interval.
1002 +)))
1003 +* (((
1004 +LoRaWAN protocol & radio related command.
1005 +)))
759 759  
1007 +(((
760 760  They are same for all Dragino Device which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki:[[End Device AT Commands and Downlink Command>>path:/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/]]
1009 +)))
761 761  
1011 +(((
1012 +
1013 +)))
762 762  
763 -* (% style="color:#4f81bd" %)** Commands special design for LSPH01**
1015 +* (((
1016 +(% style="color:#4f81bd" %)** Commands special design for LSPH01**
1017 +)))
764 764  
1019 +(((
765 765  These commands only valid for LSPH01, as below:
1021 +)))
766 766  
767 767  
768 768  
... ... @@ -776,16 +776,29 @@
776 776  
777 777  
778 778  
1035 +(((
779 779  (% style="color:#037691" %)**Downlink Command: 0x01**
1037 +)))
780 780  
1039 +(((
781 781  Format: Command Code (0x01) followed by 3 bytes time value.
1041 +)))
782 782  
1043 +(((
783 783  If the downlink payload=0100003C, it means set the END Node’s Transmit Interval to 0x00003C=60(S), while type code is 01.
1045 +)))
784 784  
785 -* Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds
786 -* Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
1047 +* (((
1048 +Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds
1049 +)))
1050 +* (((
1051 +Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
787 787  
788 788  
1054 +
1055 +
1056 +)))
1057 +
789 789  == 3.2 Set Interrupt Mode ==
790 790  
791 791  Feature, Set Interrupt mode for GPIO_EXIT.
... ... @@ -795,17 +795,31 @@
795 795  [[image:image-20220607171716-9.png]]
796 796  
797 797  
1067 +(((
798 798  (% style="color:#037691" %)**Downlink Command: 0x06**
1069 +)))
799 799  
1071 +(((
800 800  Format: Command Code (0x06) followed by 3 bytes.
1073 +)))
801 801  
1075 +(((
802 802  This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
1077 +)))
803 803  
804 -* Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode
805 -* Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger
1079 +* (((
1080 +Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode
1081 +)))
1082 +* (((
1083 +Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger
1084 +)))
806 806  
1086 +(((
1087 +
1088 +)))
807 807  
808 808  
1091 +
809 809  == 3.3 Calibrate Sensor ==
810 810  
811 811  Detail See [[Calibration Guide>>path:#H2.7Calibration]] for the user of 0x13 and 0x14 downlink commands
... ... @@ -980,9 +980,13 @@
980 980  
981 981  === ​4.3.2 Replace the battery ===
982 982  
1266 +(((
983 983  You can change the battery in the LSPH01.The type of battery is not limited as long as the output is between 3v to 3.6v. On the main board, there is a diode (D1) between the battery and the main circuit. If you need to use a battery with less than 3.3v, please remove the D1 and shortcut the two pads of it so there won’t be voltage drop between battery and main board.
1268 +)))
984 984  
1270 +(((
985 985  The default battery pack of LSPH01 includes a ER26500 plus super capacitor. If user can’t find this pack locally, they can find ER26500 or equivalence, which will also work in most case. The SPC can enlarge the battery life for high frequency use (update period below 5 minutes)
1272 +)))
986 986  
987 987  
988 988  
... ... @@ -1003,7 +1003,9 @@
1003 1003  (% style="background-color:yellow" %)** USB TTL RXD  <~-~-~-~-> UART_TXD**
1004 1004  
1005 1005  
1293 +(((
1006 1006  In the PC, you need to set the serial baud rate to (% style="color:green" %)**9600**(%%) to access the serial console for LSPH01. LSPH01 will output system info once power on as below:
1295 +)))
1007 1007  
1008 1008  
1009 1009   [[image:1654593712276-618.png]]
... ... @@ -1046,7 +1046,6 @@
1046 1046  * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
1047 1047  
1048 1048  
1049 -
1050 1050  = 9. ​Packing Info =
1051 1051  
1052 1052  
... ... @@ -1062,7 +1062,6 @@
1062 1062  * Weight / pcs : g
1063 1063  
1064 1064  
1065 -
1066 1066  = 10. ​Support =
1067 1067  
1068 1068  * Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8. Due to different timezones we cannot offer live support. However, your questions will be answered as soon as possible in the before-mentioned schedule.

Applications

Navigation

Copyright ©2010-2024 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0