Last modified by Xiaoling on 2024/01/17 16:19
<
From version < 73.11 >
edited by Xiaoling
on 2022/06/07 17:37
To version < 81.1 >
edited by Xiaoling
on 2022/06/07 18:04
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -67,20 +67,29 @@
67 67  
68 68  
69 69  
70 -
71 71  = 1. Introduction =
72 72  
73 73  == 1.1 ​What is LoRaWAN Soil pH Sensor ==
74 74  
74 +(((
75 75  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.
76 +)))
76 76  
78 +(((
77 77  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.
80 +)))
78 78  
82 +(((
79 79  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.
84 +)))
80 80  
86 +(((
81 81  LSPH01 is powered by (% style="color:#4f81bd" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long term use up to 5 years.
88 +)))
82 82  
90 +(((
83 83  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.
92 +)))
84 84  
85 85  
86 86  [[image:1654592435432-887.png]]
... ... @@ -211,7 +211,9 @@
211 211  [[image:image-20220607170442-2.png]]
212 212  
213 213  
223 +(((
214 214  (% 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.
225 +)))
215 215  
216 216  [[image:1654592697690-910.png]]
217 217  
... ... @@ -219,11 +219,17 @@
219 219  
220 220  == 2.3 ​Uplink Payload ==
221 221  
233 +(((
222 222  LSPH01 will uplink payload via LoRaWAN with below payload format: 
235 +)))
223 223  
237 +(((
224 224  Uplink payload includes in total 11 bytes.
239 +)))
225 225  
241 +(((
226 226  Normal uplink payload:
243 +)))
227 227  
228 228  (% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %)
229 229  |(((
... ... @@ -307,13 +307,17 @@
307 307  
308 308  === 2.3.6 Message Type ===
309 309  
327 +(((
310 310  For a normal uplink payload, the message type is always 0x01.
329 +)))
311 311  
331 +(((
312 312  Valid Message Type:
333 +)))
313 313  
314 314  
315 315  (% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %)
316 -|**Message Type Code**|**Description**|**Payload**
337 +|=**Message Type Code**|=**Description**|=**Payload**
317 317  |0x01|Normal Uplink|[[Normal Uplink Payload>>path:#H2.3200BUplinkPayload]]
318 318  |0x02|Reply configures info|[[Configure Info Payload>>path:#H3.4GetFirmwareVersionInfo]]
319 319  |0x03|Reply Calibration Info|[[Calibration Payload>>path:#H2.7Calibration]]
... ... @@ -320,7 +320,6 @@
320 320  
321 321  
322 322  
323 -
324 324  === 2.3.7 Decode payload in The Things Network ===
325 325  
326 326  While using TTN network, you can add the payload format to decode the payload.
... ... @@ -346,12 +346,21 @@
346 346  
347 347  == 2.5 ​Show Data in DataCake IoT Server ==
348 348  
369 +(((
349 349  [[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:
371 +)))
350 350  
373 +(((
374 +
375 +)))
351 351  
377 +(((
352 352  (% style="color:blue" %)**Step 1**(%%)**: Be sure that your device is programmed and properly connected to the network at this time.**
379 +)))
353 353  
381 +(((
354 354  (% 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:**
383 +)))
355 355  
356 356  
357 357  [[image:1654592790040-760.png]]
... ... @@ -374,9 +374,13 @@
374 374  [[image:1654592856403-259.png]]
375 375  
376 376  
406 +(((
377 377  (% style="color:blue" %)**Step 5**(%%)**: add payload decode**
408 +)))
378 378  
410 +(((
379 379  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/]]
412 +)))
380 380  
381 381  
382 382  [[image:1654592878525-845.png]]
... ... @@ -399,8 +399,10 @@
399 399  === 2.6.1 Before measurement ===
400 400  
401 401  (((
435 +(((
402 402  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. 
403 403  )))
438 +)))
404 404  
405 405  
406 406  
... ... @@ -407,24 +407,45 @@
407 407  === 2.6.2 Measurement ===
408 408  
409 409  
445 +(((
410 410  (% style="color:#4f81bd" %)**Measurement the soil surface:**
447 +)))
411 411  
449 +(((
412 412  [[image:1654592946732-634.png]]
451 +)))
413 413  
453 +(((
414 414  Choose the proper measuring position. Split the surface soil according to the measured deep.
455 +)))
415 415  
457 +(((
416 416  Put pure water, or rainwater to make the soil of measurement point to moist mud. Remove rocks or hard things.
459 +)))
417 417  
461 +(((
418 418  Slowly insert the probe to the measure point. Don’t use large force which will break the probe. Make sure not shake when inserting.
463 +)))
419 419  
465 +(((
420 420  Put soil over the probe after insert. And start to measure.
467 +)))
421 421  
469 +(((
470 +
471 +)))
422 422  
473 +(((
423 423  (% style="color:#4f81bd" %)**Measurement inside soil:**
475 +)))
424 424  
477 +(((
425 425  Dig a hole with diameter > 20CM.
479 +)))
426 426  
481 +(((
427 427  Insert the probe inside, method like measure the surface.
483 +)))
428 428  
429 429  
430 430  
... ... @@ -454,9 +454,13 @@
454 454  
455 455  == 2.7 Calibration ==
456 456  
513 +(((
457 457  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).
515 +)))
458 458  
517 +(((
459 459  After stable, user can use below command to calibrate.
519 +)))
460 460  
461 461  [[image:image-20220607171149-4.png]]
462 462  
... ... @@ -463,7 +463,7 @@
463 463  
464 464  (% style="color:#037691" %)**Calibration Payload**
465 465  
466 -(% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %)
526 +(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %)
467 467  |(((
468 468  **Size**
469 469  
... ... @@ -493,7 +493,6 @@
493 493  
494 494  
495 495  
496 -
497 497  == 2.8 Frequency Plans ==
498 498  
499 499  (((
... ... @@ -503,32 +503,61 @@
503 503  
504 504  === 2.8.1 EU863-870 (EU868) ===
505 505  
565 +(((
506 506  (% style="color:blue" %)**Uplink:**
567 +)))
507 507  
569 +(((
508 508  868.1 - SF7BW125 to SF12BW125
571 +)))
509 509  
573 +(((
510 510  868.3 - SF7BW125 to SF12BW125 and SF7BW250
575 +)))
511 511  
577 +(((
512 512  868.5 - SF7BW125 to SF12BW125
579 +)))
513 513  
581 +(((
514 514  867.1 - SF7BW125 to SF12BW125
583 +)))
515 515  
585 +(((
516 516  867.3 - SF7BW125 to SF12BW125
587 +)))
517 517  
589 +(((
518 518  867.5 - SF7BW125 to SF12BW125
591 +)))
519 519  
593 +(((
520 520  867.7 - SF7BW125 to SF12BW125
595 +)))
521 521  
597 +(((
522 522  867.9 - SF7BW125 to SF12BW125
599 +)))
523 523  
601 +(((
524 524  868.8 - FSK
603 +)))
525 525  
605 +(((
606 +
607 +)))
526 526  
609 +(((
527 527  (% style="color:blue" %)**Downlink:**
611 +)))
528 528  
613 +(((
529 529  Uplink channels 1-9 (RX1)
615 +)))
530 530  
617 +(((
531 531  869.525 - SF9BW125 (RX2 downlink only)
619 +)))
532 532  
533 533  
534 534  
... ... @@ -550,48 +550,92 @@
550 550  * 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)
551 551  
552 552  
641 +
553 553  === 2.8.3 CN470-510 (CN470) ===
554 554  
644 +(((
555 555  Used in China, Default use CHE=1
646 +)))
556 556  
648 +(((
557 557  (% style="color:blue" %)**Uplink:**
650 +)))
558 558  
652 +(((
559 559  486.3 - SF7BW125 to SF12BW125
654 +)))
560 560  
656 +(((
561 561  486.5 - SF7BW125 to SF12BW125
658 +)))
562 562  
660 +(((
563 563  486.7 - SF7BW125 to SF12BW125
662 +)))
564 564  
664 +(((
565 565  486.9 - SF7BW125 to SF12BW125
666 +)))
566 566  
668 +(((
567 567  487.1 - SF7BW125 to SF12BW125
670 +)))
568 568  
672 +(((
569 569  487.3 - SF7BW125 to SF12BW125
674 +)))
570 570  
676 +(((
571 571  487.5 - SF7BW125 to SF12BW125
678 +)))
572 572  
680 +(((
573 573  487.7 - SF7BW125 to SF12BW125
682 +)))
574 574  
684 +(((
685 +
686 +)))
575 575  
688 +(((
576 576  (% style="color:blue" %)**Downlink:**
690 +)))
577 577  
692 +(((
578 578  506.7 - SF7BW125 to SF12BW125
694 +)))
579 579  
696 +(((
580 580  506.9 - SF7BW125 to SF12BW125
698 +)))
581 581  
700 +(((
582 582  507.1 - SF7BW125 to SF12BW125
702 +)))
583 583  
704 +(((
584 584  507.3 - SF7BW125 to SF12BW125
706 +)))
585 585  
708 +(((
586 586  507.5 - SF7BW125 to SF12BW125
710 +)))
587 587  
712 +(((
588 588  507.7 - SF7BW125 to SF12BW125
714 +)))
589 589  
716 +(((
590 590  507.9 - SF7BW125 to SF12BW125
718 +)))
591 591  
720 +(((
592 592  508.1 - SF7BW125 to SF12BW125
722 +)))
593 593  
724 +(((
594 594  505.3 - SF12BW125 (RX2 downlink only)
726 +)))
595 595  
596 596  
597 597  
... ... @@ -620,108 +620,217 @@
620 620  
621 621  === 2.8.5 AS920-923 & AS923-925 (AS923) ===
622 622  
755 +(((
623 623  (% style="color:blue" %)**Default Uplink channel:**
757 +)))
624 624  
759 +(((
625 625  923.2 - SF7BW125 to SF10BW125
761 +)))
626 626  
763 +(((
627 627  923.4 - SF7BW125 to SF10BW125
765 +)))
628 628  
767 +(((
768 +
769 +)))
629 629  
771 +(((
630 630  (% style="color:blue" %)**Additional Uplink Channel**:
773 +)))
631 631  
775 +(((
632 632  (OTAA mode, channel added by JoinAccept message)
777 +)))
633 633  
779 +(((
780 +
781 +)))
634 634  
783 +(((
635 635  (% style="color:blue" %)**AS920~~AS923 for Japan, Malaysia, Singapore**:
785 +)))
636 636  
787 +(((
637 637  922.2 - SF7BW125 to SF10BW125
789 +)))
638 638  
791 +(((
639 639  922.4 - SF7BW125 to SF10BW125
793 +)))
640 640  
795 +(((
641 641  922.6 - SF7BW125 to SF10BW125
797 +)))
642 642  
799 +(((
643 643  922.8 - SF7BW125 to SF10BW125
801 +)))
644 644  
803 +(((
645 645  923.0 - SF7BW125 to SF10BW125
805 +)))
646 646  
807 +(((
647 647  922.0 - SF7BW125 to SF10BW125
809 +)))
648 648  
811 +(((
812 +
813 +)))
649 649  
815 +(((
650 650  (% style="color:blue" %)**AS923 ~~ AS925 for Brunei, Cambodia, Hong Kong, Indonesia, Laos, Taiwan, Thailand, Vietnam**:
817 +)))
651 651  
819 +(((
652 652  923.6 - SF7BW125 to SF10BW125
821 +)))
653 653  
823 +(((
654 654  923.8 - SF7BW125 to SF10BW125
825 +)))
655 655  
827 +(((
656 656  924.0 - SF7BW125 to SF10BW125
829 +)))
657 657  
831 +(((
658 658  924.2 - SF7BW125 to SF10BW125
833 +)))
659 659  
835 +(((
660 660  924.4 - SF7BW125 to SF10BW125
837 +)))
661 661  
839 +(((
662 662  924.6 - SF7BW125 to SF10BW125
841 +)))
663 663  
843 +(((
844 +
845 +)))
664 664  
847 +(((
665 665  (% style="color:blue" %)**Downlink:**
849 +)))
666 666  
851 +(((
667 667  Uplink channels 1-8 (RX1)
853 +)))
668 668  
855 +(((
669 669  923.2 - SF10BW125 (RX2)
857 +)))
670 670  
671 671  
672 672  
673 673  === 2.8.6 KR920-923 (KR920) ===
674 674  
863 +(((
675 675  (% style="color:blue" %)**Default channel:**
865 +)))
676 676  
867 +(((
677 677  922.1 - SF7BW125 to SF12BW125
869 +)))
678 678  
871 +(((
679 679  922.3 - SF7BW125 to SF12BW125
873 +)))
680 680  
875 +(((
681 681  922.5 - SF7BW125 to SF12BW125
877 +)))
682 682  
879 +(((
880 +
881 +)))
683 683  
883 +(((
684 684  (% style="color:blue" %)**Uplink: (OTAA mode, channel added by JoinAccept message)**
885 +)))
685 685  
887 +(((
686 686  922.1 - SF7BW125 to SF12BW125
889 +)))
687 687  
891 +(((
688 688  922.3 - SF7BW125 to SF12BW125
893 +)))
689 689  
895 +(((
690 690  922.5 - SF7BW125 to SF12BW125
897 +)))
691 691  
899 +(((
692 692  922.7 - SF7BW125 to SF12BW125
901 +)))
693 693  
903 +(((
694 694  922.9 - SF7BW125 to SF12BW125
905 +)))
695 695  
907 +(((
696 696  923.1 - SF7BW125 to SF12BW125
909 +)))
697 697  
911 +(((
698 698  923.3 - SF7BW125 to SF12BW125
913 +)))
699 699  
915 +(((
916 +
917 +)))
700 700  
919 +(((
701 701  (% style="color:blue" %)**Downlink:**
921 +)))
702 702  
923 +(((
703 703  Uplink channels 1-7(RX1)
925 +)))
704 704  
927 +(((
705 705  921.9 - SF12BW125 (RX2 downlink only; SF12BW125 might be changed to SF9BW125)
929 +)))
706 706  
707 707  
708 708  
709 709  === 2.8.7 IN865-867 (IN865) ===
710 710  
935 +(((
711 711  (% style="color:blue" %)**Uplink:**
937 +)))
712 712  
939 +(((
713 713  865.0625 - SF7BW125 to SF12BW125
941 +)))
714 714  
943 +(((
715 715  865.4025 - SF7BW125 to SF12BW125
945 +)))
716 716  
947 +(((
717 717  865.9850 - SF7BW125 to SF12BW125
949 +)))
718 718  
951 +(((
952 +
953 +)))
719 719  
955 +(((
720 720  (% style="color:blue" %)**Downlink:**
957 +)))
721 721  
959 +(((
722 722  Uplink channels 1-3 (RX1)
961 +)))
723 723  
963 +(((
724 724  866.550 - SF10BW125 (RX2)
965 +)))
725 725  
726 726  
727 727  
... ... @@ -747,26 +747,51 @@
747 747  
748 748  = 3. Configure LSPH01 via AT Command or LoRaWAN Downlink =
749 749  
991 +(((
750 750  Use can configure LSPH01 via AT Command or LoRaWAN Downlink.
993 +)))
751 751  
752 -* AT Command Connection: See [[FAQ>>path:#H6.FAQ]].
753 -* LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>path:/xwiki/bin/view/Main/]]
995 +* (((
996 +AT Command Connection: See [[FAQ>>path:#H6.FAQ]].
997 +)))
998 +* (((
999 +LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>path:/xwiki/bin/view/Main/]]
1000 +)))
754 754  
1002 +(((
755 755  There are two kinds of commands to configure LSPH01, they are:
1004 +)))
756 756  
757 -* (% style="color:#4f81bd" %)** General Commands**.
1006 +* (((
1007 +(% style="color:#4f81bd" %)** General Commands**.
1008 +)))
758 758  
1010 +(((
759 759  These commands are to configure:
1012 +)))
760 760  
761 -* General system settings like: uplink interval.
762 -* LoRaWAN protocol & radio related command.
1014 +* (((
1015 +General system settings like: uplink interval.
1016 +)))
1017 +* (((
1018 +LoRaWAN protocol & radio related command.
1019 +)))
763 763  
1021 +(((
764 764  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/]]
1023 +)))
765 765  
1025 +(((
1026 +
1027 +)))
766 766  
767 -* (% style="color:#4f81bd" %)** Commands special design for LSPH01**
1029 +* (((
1030 +(% style="color:#4f81bd" %)** Commands special design for LSPH01**
1031 +)))
768 768  
1033 +(((
769 769  These commands only valid for LSPH01, as below:
1035 +)))
770 770  
771 771  
772 772  
... ... @@ -780,18 +780,28 @@
780 780  
781 781  
782 782  
1049 +(((
783 783  (% style="color:#037691" %)**Downlink Command: 0x01**
1051 +)))
784 784  
1053 +(((
785 785  Format: Command Code (0x01) followed by 3 bytes time value.
1055 +)))
786 786  
1057 +(((
787 787  If the downlink payload=0100003C, it means set the END Node’s Transmit Interval to 0x00003C=60(S), while type code is 01.
1059 +)))
788 788  
789 -* Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds
790 -* Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
1061 +* (((
1062 +Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds
1063 +)))
1064 +* (((
1065 +Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
791 791  
792 792  
1068 +
1069 +)))
793 793  
794 -
795 795  == 3.2 Set Interrupt Mode ==
796 796  
797 797  Feature, Set Interrupt mode for GPIO_EXIT.
... ... @@ -801,16 +801,31 @@
801 801  [[image:image-20220607171716-9.png]]
802 802  
803 803  
1080 +(((
804 804  (% style="color:#037691" %)**Downlink Command: 0x06**
1082 +)))
805 805  
1084 +(((
806 806  Format: Command Code (0x06) followed by 3 bytes.
1086 +)))
807 807  
1088 +(((
808 808  This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
1090 +)))
809 809  
810 -* Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode
811 -* Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger
1092 +* (((
1093 +Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode
1094 +)))
1095 +* (((
1096 +Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger
1097 +)))
812 812  
1099 +(((
1100 +
1101 +)))
813 813  
1103 +
1104 +
814 814  == 3.3 Calibrate Sensor ==
815 815  
816 816  Detail See [[Calibration Guide>>path:#H2.7Calibration]] for the user of 0x13 and 0x14 downlink commands
... ... @@ -828,7 +828,6 @@
828 828  * Reply to the confirmation package: 26 01
829 829  * Reply to non-confirmed packet: 26 00
830 830  
831 -
832 832  Device will send an uplink after got this downlink command. With below payload:
833 833  
834 834  Configures info payload:
... ... @@ -986,9 +986,13 @@
986 986  
987 987  === ​4.3.2 Replace the battery ===
988 988  
1279 +(((
989 989  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.
1281 +)))
990 990  
1283 +(((
991 991  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)
1285 +)))
992 992  
993 993  
994 994  
... ... @@ -1009,7 +1009,9 @@
1009 1009  (% style="background-color:yellow" %)** USB TTL RXD  <~-~-~-~-> UART_TXD**
1010 1010  
1011 1011  
1306 +(((
1012 1012  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:
1308 +)))
1013 1013  
1014 1014  
1015 1015   [[image:1654593712276-618.png]]
... ... @@ -1051,7 +1051,6 @@
1051 1051  * (% style="color:red" %)**IN865**(%%):  LoRaWAN IN865 band
1052 1052  * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
1053 1053  
1054 -
1055 1055  = 9. ​Packing Info =
1056 1056  
1057 1057  
... ... @@ -1066,7 +1066,6 @@
1066 1066  * Package Size / pcs : cm
1067 1067  * Weight / pcs : g
1068 1068  
1069 -
1070 1070  = 10. ​Support =
1071 1071  
1072 1072  * 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