Skip to Content
Last modified by Xiaoling on 2025/04/27 13:43
From version 73.5
edited by Xiaoling
on 2022/06/07 17:28
Change comment: There is no comment for this version
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  
... ... @@ -491,6 +491,8 @@
491 491  * Reply to the confirmation package: 14 01
492 492  * Reply to non-confirmed packet: 14 00
493 493  
554 +
555 +
494 494  == 2.8 Frequency Plans ==
495 495  
496 496  (((
... ... @@ -500,32 +500,61 @@
500 500  
501 501  === 2.8.1 EU863-870 (EU868) ===
502 502  
565 +(((
503 503  (% style="color:blue" %)**Uplink:**
567 +)))
504 504  
569 +(((
505 505  868.1 - SF7BW125 to SF12BW125
571 +)))
506 506  
573 +(((
507 507  868.3 - SF7BW125 to SF12BW125 and SF7BW250
575 +)))
508 508  
577 +(((
509 509  868.5 - SF7BW125 to SF12BW125
579 +)))
510 510  
581 +(((
511 511  867.1 - SF7BW125 to SF12BW125
583 +)))
512 512  
585 +(((
513 513  867.3 - SF7BW125 to SF12BW125
587 +)))
514 514  
589 +(((
515 515  867.5 - SF7BW125 to SF12BW125
591 +)))
516 516  
593 +(((
517 517  867.7 - SF7BW125 to SF12BW125
595 +)))
518 518  
597 +(((
519 519  867.9 - SF7BW125 to SF12BW125
599 +)))
520 520  
601 +(((
521 521  868.8 - FSK
603 +)))
522 522  
605 +(((
606 +
607 +)))
523 523  
609 +(((
524 524  (% style="color:blue" %)**Downlink:**
611 +)))
525 525  
613 +(((
526 526  Uplink channels 1-9 (RX1)
615 +)))
527 527  
617 +(((
528 528  869.525 - SF9BW125 (RX2 downlink only)
619 +)))
529 529  
530 530  
531 531  
... ... @@ -547,48 +547,92 @@
547 547  * 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)
548 548  
549 549  
641 +
550 550  === 2.8.3 CN470-510 (CN470) ===
551 551  
644 +(((
552 552  Used in China, Default use CHE=1
646 +)))
553 553  
648 +(((
554 554  (% style="color:blue" %)**Uplink:**
650 +)))
555 555  
652 +(((
556 556  486.3 - SF7BW125 to SF12BW125
654 +)))
557 557  
656 +(((
558 558  486.5 - SF7BW125 to SF12BW125
658 +)))
559 559  
660 +(((
560 560  486.7 - SF7BW125 to SF12BW125
662 +)))
561 561  
664 +(((
562 562  486.9 - SF7BW125 to SF12BW125
666 +)))
563 563  
668 +(((
564 564  487.1 - SF7BW125 to SF12BW125
670 +)))
565 565  
672 +(((
566 566  487.3 - SF7BW125 to SF12BW125
674 +)))
567 567  
676 +(((
568 568  487.5 - SF7BW125 to SF12BW125
678 +)))
569 569  
680 +(((
570 570  487.7 - SF7BW125 to SF12BW125
682 +)))
571 571  
684 +(((
685 +
686 +)))
572 572  
688 +(((
573 573  (% style="color:blue" %)**Downlink:**
690 +)))
574 574  
692 +(((
575 575  506.7 - SF7BW125 to SF12BW125
694 +)))
576 576  
696 +(((
577 577  506.9 - SF7BW125 to SF12BW125
698 +)))
578 578  
700 +(((
579 579  507.1 - SF7BW125 to SF12BW125
702 +)))
580 580  
704 +(((
581 581  507.3 - SF7BW125 to SF12BW125
706 +)))
582 582  
708 +(((
583 583  507.5 - SF7BW125 to SF12BW125
710 +)))
584 584  
712 +(((
585 585  507.7 - SF7BW125 to SF12BW125
714 +)))
586 586  
716 +(((
587 587  507.9 - SF7BW125 to SF12BW125
718 +)))
588 588  
720 +(((
589 589  508.1 - SF7BW125 to SF12BW125
722 +)))
590 590  
724 +(((
591 591  505.3 - SF12BW125 (RX2 downlink only)
726 +)))
592 592  
593 593  
594 594  
... ... @@ -614,110 +614,220 @@
614 614  * 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)
615 615  
616 616  
752 +
617 617  === 2.8.5 AS920-923 & AS923-925 (AS923) ===
618 618  
755 +(((
619 619  (% style="color:blue" %)**Default Uplink channel:**
757 +)))
620 620  
759 +(((
621 621  923.2 - SF7BW125 to SF10BW125
761 +)))
622 622  
763 +(((
623 623  923.4 - SF7BW125 to SF10BW125
765 +)))
624 624  
767 +(((
768 +
769 +)))
625 625  
771 +(((
626 626  (% style="color:blue" %)**Additional Uplink Channel**:
773 +)))
627 627  
775 +(((
628 628  (OTAA mode, channel added by JoinAccept message)
777 +)))
629 629  
779 +(((
780 +
781 +)))
630 630  
783 +(((
631 631  (% style="color:blue" %)**AS920~~AS923 for Japan, Malaysia, Singapore**:
785 +)))
632 632  
787 +(((
633 633  922.2 - SF7BW125 to SF10BW125
789 +)))
634 634  
791 +(((
635 635  922.4 - SF7BW125 to SF10BW125
793 +)))
636 636  
795 +(((
637 637  922.6 - SF7BW125 to SF10BW125
797 +)))
638 638  
799 +(((
639 639  922.8 - SF7BW125 to SF10BW125
801 +)))
640 640  
803 +(((
641 641  923.0 - SF7BW125 to SF10BW125
805 +)))
642 642  
807 +(((
643 643  922.0 - SF7BW125 to SF10BW125
809 +)))
644 644  
811 +(((
812 +
813 +)))
645 645  
815 +(((
646 646  (% style="color:blue" %)**AS923 ~~ AS925 for Brunei, Cambodia, Hong Kong, Indonesia, Laos, Taiwan, Thailand, Vietnam**:
817 +)))
647 647  
819 +(((
648 648  923.6 - SF7BW125 to SF10BW125
821 +)))
649 649  
823 +(((
650 650  923.8 - SF7BW125 to SF10BW125
825 +)))
651 651  
827 +(((
652 652  924.0 - SF7BW125 to SF10BW125
829 +)))
653 653  
831 +(((
654 654  924.2 - SF7BW125 to SF10BW125
833 +)))
655 655  
835 +(((
656 656  924.4 - SF7BW125 to SF10BW125
837 +)))
657 657  
839 +(((
658 658  924.6 - SF7BW125 to SF10BW125
841 +)))
659 659  
843 +(((
844 +
845 +)))
660 660  
847 +(((
661 661  (% style="color:blue" %)**Downlink:**
849 +)))
662 662  
851 +(((
663 663  Uplink channels 1-8 (RX1)
853 +)))
664 664  
855 +(((
665 665  923.2 - SF10BW125 (RX2)
857 +)))
666 666  
667 667  
668 668  
669 669  === 2.8.6 KR920-923 (KR920) ===
670 670  
863 +(((
671 671  (% style="color:blue" %)**Default channel:**
865 +)))
672 672  
867 +(((
673 673  922.1 - SF7BW125 to SF12BW125
869 +)))
674 674  
871 +(((
675 675  922.3 - SF7BW125 to SF12BW125
873 +)))
676 676  
875 +(((
677 677  922.5 - SF7BW125 to SF12BW125
877 +)))
678 678  
879 +(((
880 +
881 +)))
679 679  
883 +(((
680 680  (% style="color:blue" %)**Uplink: (OTAA mode, channel added by JoinAccept message)**
885 +)))
681 681  
887 +(((
682 682  922.1 - SF7BW125 to SF12BW125
889 +)))
683 683  
891 +(((
684 684  922.3 - SF7BW125 to SF12BW125
893 +)))
685 685  
895 +(((
686 686  922.5 - SF7BW125 to SF12BW125
897 +)))
687 687  
899 +(((
688 688  922.7 - SF7BW125 to SF12BW125
901 +)))
689 689  
903 +(((
690 690  922.9 - SF7BW125 to SF12BW125
905 +)))
691 691  
907 +(((
692 692  923.1 - SF7BW125 to SF12BW125
909 +)))
693 693  
911 +(((
694 694  923.3 - SF7BW125 to SF12BW125
913 +)))
695 695  
915 +(((
916 +
917 +)))
696 696  
919 +(((
697 697  (% style="color:blue" %)**Downlink:**
921 +)))
698 698  
923 +(((
699 699  Uplink channels 1-7(RX1)
925 +)))
700 700  
927 +(((
701 701  921.9 - SF12BW125 (RX2 downlink only; SF12BW125 might be changed to SF9BW125)
929 +)))
702 702  
703 703  
704 704  
705 705  === 2.8.7 IN865-867 (IN865) ===
706 706  
935 +(((
707 707  (% style="color:blue" %)**Uplink:**
937 +)))
708 708  
939 +(((
709 709  865.0625 - SF7BW125 to SF12BW125
941 +)))
710 710  
943 +(((
711 711  865.4025 - SF7BW125 to SF12BW125
945 +)))
712 712  
947 +(((
713 713  865.9850 - SF7BW125 to SF12BW125
949 +)))
714 714  
951 +(((
952 +
953 +)))
715 715  
955 +(((
716 716  (% style="color:blue" %)**Downlink:**
957 +)))
717 717  
959 +(((
718 718  Uplink channels 1-3 (RX1)
961 +)))
719 719  
963 +(((
720 720  866.550 - SF10BW125 (RX2)
965 +)))
721 721  
722 722  
723 723  
... ... @@ -743,26 +743,51 @@
743 743  
744 744  = 3. Configure LSPH01 via AT Command or LoRaWAN Downlink =
745 745  
991 +(((
746 746  Use can configure LSPH01 via AT Command or LoRaWAN Downlink.
993 +)))
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/]]
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 +)))
750 750  
1002 +(((
751 751  There are two kinds of commands to configure LSPH01, they are:
1004 +)))
752 752  
753 -* (% style="color:#4f81bd" %)** General Commands**.
1006 +* (((
1007 +(% style="color:#4f81bd" %)** General Commands**.
1008 +)))
754 754  
1010 +(((
755 755  These commands are to configure:
1012 +)))
756 756  
757 -* General system settings like: uplink interval.
758 -* LoRaWAN protocol & radio related command.
1014 +* (((
1015 +General system settings like: uplink interval.
1016 +)))
1017 +* (((
1018 +LoRaWAN protocol & radio related command.
1019 +)))
759 759  
1021 +(((
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/]]
1023 +)))
761 761  
1025 +(((
1026 +
1027 +)))
762 762  
763 -* (% style="color:#4f81bd" %)** Commands special design for LSPH01**
1029 +* (((
1030 +(% style="color:#4f81bd" %)** Commands special design for LSPH01**
1031 +)))
764 764  
1033 +(((
765 765  These commands only valid for LSPH01, as below:
1035 +)))
766 766  
767 767  
768 768  
... ... @@ -776,15 +776,28 @@
776 776  
777 777  
778 778  
1049 +(((
779 779  (% style="color:#037691" %)**Downlink Command: 0x01**
1051 +)))
780 780  
1053 +(((
781 781  Format: Command Code (0x01) followed by 3 bytes time value.
1055 +)))
782 782  
1057 +(((
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.
1059 +)))
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
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
787 787  
1067 +
1068 +
1069 +)))
1070 +
788 788  == 3.2 Set Interrupt Mode ==
789 789  
790 790  Feature, Set Interrupt mode for GPIO_EXIT.
... ... @@ -794,16 +794,31 @@
794 794  [[image:image-20220607171716-9.png]]
795 795  
796 796  
1080 +(((
797 797  (% style="color:#037691" %)**Downlink Command: 0x06**
1082 +)))
798 798  
1084 +(((
799 799  Format: Command Code (0x06) followed by 3 bytes.
1086 +)))
800 800  
1088 +(((
801 801  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 +)))
802 802  
803 -* Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode
804 -* 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 +)))
805 805  
1099 +(((
1100 +
1101 +)))
806 806  
1103 +
1104 +
807 807  == 3.3 Calibrate Sensor ==
808 808  
809 809  Detail See [[Calibration Guide>>path:#H2.7Calibration]] for the user of 0x13 and 0x14 downlink commands
... ... @@ -978,9 +978,13 @@
978 978  
979 979  === ​4.3.2 Replace the battery ===
980 980  
1279 +(((
981 981  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 +)))
982 982  
1283 +(((
983 983  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 +)))
984 984  
985 985  
986 986  
... ... @@ -1001,7 +1001,9 @@
1001 1001  (% style="background-color:yellow" %)** USB TTL RXD  <~-~-~-~-> UART_TXD**
1002 1002  
1003 1003  
1306 +(((
1004 1004  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 +)))
1005 1005  
1006 1006  
1007 1007   [[image:1654593712276-618.png]]
... ... @@ -1043,7 +1043,6 @@
1043 1043  * (% style="color:red" %)**IN865**(%%):  LoRaWAN IN865 band
1044 1044  * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
1045 1045  
1046 -
1047 1047  = 9. ​Packing Info =
1048 1048  
1049 1049  
... ... @@ -1058,7 +1058,6 @@
1058 1058  * Package Size / pcs : cm
1059 1059  * Weight / pcs : g
1060 1060  
1061 -
1062 1062  = 10. ​Support =
1063 1063  
1064 1064  * 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.