<
From version < 73.13 >
edited by Xiaoling
on 2022/06/07 17:39
To version < 85.2 >
edited by Xiaoling
on 2022/06/07 18:10
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -68,6 +68,7 @@
68 68  
69 69  
70 70  
71 +
71 71  = 1. Introduction =
72 72  
73 73  == 1.1 ​What is LoRaWAN Soil pH Sensor ==
... ... @@ -221,7 +221,9 @@
221 221  [[image:image-20220607170442-2.png]]
222 222  
223 223  
225 +(((
224 224  (% 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.
227 +)))
225 225  
226 226  [[image:1654592697690-910.png]]
227 227  
... ... @@ -229,11 +229,17 @@
229 229  
230 230  == 2.3 ​Uplink Payload ==
231 231  
235 +(((
232 232  LSPH01 will uplink payload via LoRaWAN with below payload format: 
237 +)))
233 233  
239 +(((
234 234  Uplink payload includes in total 11 bytes.
241 +)))
235 235  
243 +(((
236 236  Normal uplink payload:
245 +)))
237 237  
238 238  (% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %)
239 239  |(((
... ... @@ -317,20 +317,21 @@
317 317  
318 318  === 2.3.6 Message Type ===
319 319  
329 +(((
320 320  For a normal uplink payload, the message type is always 0x01.
331 +)))
321 321  
333 +(((
322 322  Valid Message Type:
335 +)))
323 323  
324 324  
325 325  (% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %)
326 -|**Message Type Code**|**Description**|**Payload**
339 +|=**Message Type Code**|=**Description**|=**Payload**
327 327  |0x01|Normal Uplink|[[Normal Uplink Payload>>path:#H2.3200BUplinkPayload]]
328 328  |0x02|Reply configures info|[[Configure Info Payload>>path:#H3.4GetFirmwareVersionInfo]]
329 329  |0x03|Reply Calibration Info|[[Calibration Payload>>path:#H2.7Calibration]]
330 330  
331 -
332 -
333 -
334 334  === 2.3.7 Decode payload in The Things Network ===
335 335  
336 336  While using TTN network, you can add the payload format to decode the payload.
... ... @@ -356,12 +356,21 @@
356 356  
357 357  == 2.5 ​Show Data in DataCake IoT Server ==
358 358  
369 +(((
359 359  [[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 +)))
360 360  
373 +(((
374 +
375 +)))
361 361  
377 +(((
362 362  (% style="color:blue" %)**Step 1**(%%)**: Be sure that your device is programmed and properly connected to the network at this time.**
379 +)))
363 363  
381 +(((
364 364  (% 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 +)))
365 365  
366 366  
367 367  [[image:1654592790040-760.png]]
... ... @@ -384,9 +384,13 @@
384 384  [[image:1654592856403-259.png]]
385 385  
386 386  
406 +(((
387 387  (% style="color:blue" %)**Step 5**(%%)**: add payload decode**
408 +)))
388 388  
410 +(((
389 389  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 +)))
390 390  
391 391  
392 392  [[image:1654592878525-845.png]]
... ... @@ -409,8 +409,10 @@
409 409  === 2.6.1 Before measurement ===
410 410  
411 411  (((
435 +(((
412 412  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. 
413 413  )))
438 +)))
414 414  
415 415  
416 416  
... ... @@ -417,24 +417,45 @@
417 417  === 2.6.2 Measurement ===
418 418  
419 419  
445 +(((
420 420  (% style="color:#4f81bd" %)**Measurement the soil surface:**
447 +)))
421 421  
449 +(((
422 422  [[image:1654592946732-634.png]]
451 +)))
423 423  
453 +(((
424 424  Choose the proper measuring position. Split the surface soil according to the measured deep.
455 +)))
425 425  
457 +(((
426 426  Put pure water, or rainwater to make the soil of measurement point to moist mud. Remove rocks or hard things.
459 +)))
427 427  
461 +(((
428 428  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 +)))
429 429  
465 +(((
430 430  Put soil over the probe after insert. And start to measure.
467 +)))
431 431  
469 +(((
470 +
471 +)))
432 432  
473 +(((
433 433  (% style="color:#4f81bd" %)**Measurement inside soil:**
475 +)))
434 434  
477 +(((
435 435  Dig a hole with diameter > 20CM.
479 +)))
436 436  
481 +(((
437 437  Insert the probe inside, method like measure the surface.
483 +)))
438 438  
439 439  
440 440  
... ... @@ -464,9 +464,13 @@
464 464  
465 465  == 2.7 Calibration ==
466 466  
513 +(((
467 467  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 +)))
468 468  
517 +(((
469 469  After stable, user can use below command to calibrate.
519 +)))
470 470  
471 471  [[image:image-20220607171149-4.png]]
472 472  
... ... @@ -473,7 +473,7 @@
473 473  
474 474  (% style="color:#037691" %)**Calibration Payload**
475 475  
476 -(% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %)
526 +(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %)
477 477  |(((
478 478  **Size**
479 479  
... ... @@ -503,7 +503,6 @@
503 503  
504 504  
505 505  
506 -
507 507  == 2.8 Frequency Plans ==
508 508  
509 509  (((
... ... @@ -513,32 +513,61 @@
513 513  
514 514  === 2.8.1 EU863-870 (EU868) ===
515 515  
565 +(((
516 516  (% style="color:blue" %)**Uplink:**
567 +)))
517 517  
569 +(((
518 518  868.1 - SF7BW125 to SF12BW125
571 +)))
519 519  
573 +(((
520 520  868.3 - SF7BW125 to SF12BW125 and SF7BW250
575 +)))
521 521  
577 +(((
522 522  868.5 - SF7BW125 to SF12BW125
579 +)))
523 523  
581 +(((
524 524  867.1 - SF7BW125 to SF12BW125
583 +)))
525 525  
585 +(((
526 526  867.3 - SF7BW125 to SF12BW125
587 +)))
527 527  
589 +(((
528 528  867.5 - SF7BW125 to SF12BW125
591 +)))
529 529  
593 +(((
530 530  867.7 - SF7BW125 to SF12BW125
595 +)))
531 531  
597 +(((
532 532  867.9 - SF7BW125 to SF12BW125
599 +)))
533 533  
601 +(((
534 534  868.8 - FSK
603 +)))
535 535  
605 +(((
606 +
607 +)))
536 536  
609 +(((
537 537  (% style="color:blue" %)**Downlink:**
611 +)))
538 538  
613 +(((
539 539  Uplink channels 1-9 (RX1)
615 +)))
540 540  
617 +(((
541 541  869.525 - SF9BW125 (RX2 downlink only)
619 +)))
542 542  
543 543  
544 544  
... ... @@ -560,48 +560,92 @@
560 560  * 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)
561 561  
562 562  
641 +
563 563  === 2.8.3 CN470-510 (CN470) ===
564 564  
644 +(((
565 565  Used in China, Default use CHE=1
646 +)))
566 566  
648 +(((
567 567  (% style="color:blue" %)**Uplink:**
650 +)))
568 568  
652 +(((
569 569  486.3 - SF7BW125 to SF12BW125
654 +)))
570 570  
656 +(((
571 571  486.5 - SF7BW125 to SF12BW125
658 +)))
572 572  
660 +(((
573 573  486.7 - SF7BW125 to SF12BW125
662 +)))
574 574  
664 +(((
575 575  486.9 - SF7BW125 to SF12BW125
666 +)))
576 576  
668 +(((
577 577  487.1 - SF7BW125 to SF12BW125
670 +)))
578 578  
672 +(((
579 579  487.3 - SF7BW125 to SF12BW125
674 +)))
580 580  
676 +(((
581 581  487.5 - SF7BW125 to SF12BW125
678 +)))
582 582  
680 +(((
583 583  487.7 - SF7BW125 to SF12BW125
682 +)))
584 584  
684 +(((
685 +
686 +)))
585 585  
688 +(((
586 586  (% style="color:blue" %)**Downlink:**
690 +)))
587 587  
692 +(((
588 588  506.7 - SF7BW125 to SF12BW125
694 +)))
589 589  
696 +(((
590 590  506.9 - SF7BW125 to SF12BW125
698 +)))
591 591  
700 +(((
592 592  507.1 - SF7BW125 to SF12BW125
702 +)))
593 593  
704 +(((
594 594  507.3 - SF7BW125 to SF12BW125
706 +)))
595 595  
708 +(((
596 596  507.5 - SF7BW125 to SF12BW125
710 +)))
597 597  
712 +(((
598 598  507.7 - SF7BW125 to SF12BW125
714 +)))
599 599  
716 +(((
600 600  507.9 - SF7BW125 to SF12BW125
718 +)))
601 601  
720 +(((
602 602  508.1 - SF7BW125 to SF12BW125
722 +)))
603 603  
724 +(((
604 604  505.3 - SF12BW125 (RX2 downlink only)
726 +)))
605 605  
606 606  
607 607  
... ... @@ -626,112 +626,219 @@
626 626  * Check what sub-band the LoRaWAN server ask from the OTAA Join Accept message and switch to that sub-band
627 627  * 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)
628 628  
629 -
630 -
631 631  === 2.8.5 AS920-923 & AS923-925 (AS923) ===
632 632  
753 +(((
633 633  (% style="color:blue" %)**Default Uplink channel:**
755 +)))
634 634  
757 +(((
635 635  923.2 - SF7BW125 to SF10BW125
759 +)))
636 636  
761 +(((
637 637  923.4 - SF7BW125 to SF10BW125
763 +)))
638 638  
765 +(((
766 +
767 +)))
639 639  
769 +(((
640 640  (% style="color:blue" %)**Additional Uplink Channel**:
771 +)))
641 641  
773 +(((
642 642  (OTAA mode, channel added by JoinAccept message)
775 +)))
643 643  
777 +(((
778 +
779 +)))
644 644  
781 +(((
645 645  (% style="color:blue" %)**AS920~~AS923 for Japan, Malaysia, Singapore**:
783 +)))
646 646  
785 +(((
647 647  922.2 - SF7BW125 to SF10BW125
787 +)))
648 648  
789 +(((
649 649  922.4 - SF7BW125 to SF10BW125
791 +)))
650 650  
793 +(((
651 651  922.6 - SF7BW125 to SF10BW125
795 +)))
652 652  
797 +(((
653 653  922.8 - SF7BW125 to SF10BW125
799 +)))
654 654  
801 +(((
655 655  923.0 - SF7BW125 to SF10BW125
803 +)))
656 656  
805 +(((
657 657  922.0 - SF7BW125 to SF10BW125
807 +)))
658 658  
809 +(((
810 +
811 +)))
659 659  
813 +(((
660 660  (% style="color:blue" %)**AS923 ~~ AS925 for Brunei, Cambodia, Hong Kong, Indonesia, Laos, Taiwan, Thailand, Vietnam**:
815 +)))
661 661  
817 +(((
662 662  923.6 - SF7BW125 to SF10BW125
819 +)))
663 663  
821 +(((
664 664  923.8 - SF7BW125 to SF10BW125
823 +)))
665 665  
825 +(((
666 666  924.0 - SF7BW125 to SF10BW125
827 +)))
667 667  
829 +(((
668 668  924.2 - SF7BW125 to SF10BW125
831 +)))
669 669  
833 +(((
670 670  924.4 - SF7BW125 to SF10BW125
835 +)))
671 671  
837 +(((
672 672  924.6 - SF7BW125 to SF10BW125
839 +)))
673 673  
841 +(((
842 +
843 +)))
674 674  
845 +(((
675 675  (% style="color:blue" %)**Downlink:**
847 +)))
676 676  
849 +(((
677 677  Uplink channels 1-8 (RX1)
851 +)))
678 678  
853 +(((
679 679  923.2 - SF10BW125 (RX2)
855 +)))
680 680  
681 681  
682 682  
683 683  === 2.8.6 KR920-923 (KR920) ===
684 684  
861 +(((
685 685  (% style="color:blue" %)**Default channel:**
863 +)))
686 686  
865 +(((
687 687  922.1 - SF7BW125 to SF12BW125
867 +)))
688 688  
869 +(((
689 689  922.3 - SF7BW125 to SF12BW125
871 +)))
690 690  
873 +(((
691 691  922.5 - SF7BW125 to SF12BW125
875 +)))
692 692  
877 +(((
878 +
879 +)))
693 693  
881 +(((
694 694  (% style="color:blue" %)**Uplink: (OTAA mode, channel added by JoinAccept message)**
883 +)))
695 695  
885 +(((
696 696  922.1 - SF7BW125 to SF12BW125
887 +)))
697 697  
889 +(((
698 698  922.3 - SF7BW125 to SF12BW125
891 +)))
699 699  
893 +(((
700 700  922.5 - SF7BW125 to SF12BW125
895 +)))
701 701  
897 +(((
702 702  922.7 - SF7BW125 to SF12BW125
899 +)))
703 703  
901 +(((
704 704  922.9 - SF7BW125 to SF12BW125
903 +)))
705 705  
905 +(((
706 706  923.1 - SF7BW125 to SF12BW125
907 +)))
707 707  
909 +(((
708 708  923.3 - SF7BW125 to SF12BW125
911 +)))
709 709  
913 +(((
914 +
915 +)))
710 710  
917 +(((
711 711  (% style="color:blue" %)**Downlink:**
919 +)))
712 712  
921 +(((
713 713  Uplink channels 1-7(RX1)
923 +)))
714 714  
925 +(((
715 715  921.9 - SF12BW125 (RX2 downlink only; SF12BW125 might be changed to SF9BW125)
927 +)))
716 716  
717 717  
718 718  
719 719  === 2.8.7 IN865-867 (IN865) ===
720 720  
933 +(((
721 721  (% style="color:blue" %)**Uplink:**
935 +)))
722 722  
937 +(((
723 723  865.0625 - SF7BW125 to SF12BW125
939 +)))
724 724  
941 +(((
725 725  865.4025 - SF7BW125 to SF12BW125
943 +)))
726 726  
945 +(((
727 727  865.9850 - SF7BW125 to SF12BW125
947 +)))
728 728  
949 +(((
950 +
951 +)))
729 729  
953 +(((
730 730  (% style="color:blue" %)**Downlink:**
955 +)))
731 731  
957 +(((
732 732  Uplink channels 1-3 (RX1)
959 +)))
733 733  
961 +(((
734 734  866.550 - SF10BW125 (RX2)
963 +)))
735 735  
736 736  
737 737  
... ... @@ -758,26 +758,51 @@
758 758  
759 759  = 3. Configure LSPH01 via AT Command or LoRaWAN Downlink =
760 760  
990 +(((
761 761  Use can configure LSPH01 via AT Command or LoRaWAN Downlink.
992 +)))
762 762  
763 -* AT Command Connection: See [[FAQ>>path:#H6.FAQ]].
764 -* LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>path:/xwiki/bin/view/Main/]]
994 +* (((
995 +AT Command Connection: See [[FAQ>>path:#H6.FAQ]].
996 +)))
997 +* (((
998 +LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>path:/xwiki/bin/view/Main/]]
999 +)))
765 765  
1001 +(((
766 766  There are two kinds of commands to configure LSPH01, they are:
1003 +)))
767 767  
768 -* (% style="color:#4f81bd" %)** General Commands**.
1005 +* (((
1006 +(% style="color:#4f81bd" %)** General Commands**.
1007 +)))
769 769  
1009 +(((
770 770  These commands are to configure:
1011 +)))
771 771  
772 -* General system settings like: uplink interval.
773 -* LoRaWAN protocol & radio related command.
1013 +* (((
1014 +General system settings like: uplink interval.
1015 +)))
1016 +* (((
1017 +LoRaWAN protocol & radio related command.
1018 +)))
774 774  
1020 +(((
775 775  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/]]
1022 +)))
776 776  
1024 +(((
1025 +
1026 +)))
777 777  
778 -* (% style="color:#4f81bd" %)** Commands special design for LSPH01**
1028 +* (((
1029 +(% style="color:#4f81bd" %)** Commands special design for LSPH01**
1030 +)))
779 779  
1032 +(((
780 780  These commands only valid for LSPH01, as below:
1034 +)))
781 781  
782 782  
783 783  
... ... @@ -791,18 +791,28 @@
791 791  
792 792  
793 793  
1048 +(((
794 794  (% style="color:#037691" %)**Downlink Command: 0x01**
1050 +)))
795 795  
1052 +(((
796 796  Format: Command Code (0x01) followed by 3 bytes time value.
1054 +)))
797 797  
1056 +(((
798 798  If the downlink payload=0100003C, it means set the END Node’s Transmit Interval to 0x00003C=60(S), while type code is 01.
1058 +)))
799 799  
800 -* Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds
801 -* Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
1060 +* (((
1061 +Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds
1062 +)))
1063 +* (((
1064 +Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
802 802  
803 803  
1067 +
1068 +)))
804 804  
805 -
806 806  == 3.2 Set Interrupt Mode ==
807 807  
808 808  Feature, Set Interrupt mode for GPIO_EXIT.
... ... @@ -812,16 +812,31 @@
812 812  [[image:image-20220607171716-9.png]]
813 813  
814 814  
1079 +(((
815 815  (% style="color:#037691" %)**Downlink Command: 0x06**
1081 +)))
816 816  
1083 +(((
817 817  Format: Command Code (0x06) followed by 3 bytes.
1085 +)))
818 818  
1087 +(((
819 819  This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
1089 +)))
820 820  
821 -* Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode
822 -* Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger
1091 +* (((
1092 +Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode
1093 +)))
1094 +* (((
1095 +Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger
1096 +)))
823 823  
1098 +(((
1099 +
1100 +)))
824 824  
1102 +
1103 +
825 825  == 3.3 Calibrate Sensor ==
826 826  
827 827  Detail See [[Calibration Guide>>path:#H2.7Calibration]] for the user of 0x13 and 0x14 downlink commands
... ... @@ -839,7 +839,6 @@
839 839  * Reply to the confirmation package: 26 01
840 840  * Reply to non-confirmed packet: 26 00
841 841  
842 -
843 843  Device will send an uplink after got this downlink command. With below payload:
844 844  
845 845  Configures info payload:
... ... @@ -997,9 +997,13 @@
997 997  
998 998  === ​4.3.2 Replace the battery ===
999 999  
1278 +(((
1000 1000  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.
1280 +)))
1001 1001  
1282 +(((
1002 1002  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)
1284 +)))
1003 1003  
1004 1004  
1005 1005  
... ... @@ -1020,7 +1020,9 @@
1020 1020  (% style="background-color:yellow" %)** USB TTL RXD  <~-~-~-~-> UART_TXD**
1021 1021  
1022 1022  
1305 +(((
1023 1023  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:
1307 +)))
1024 1024  
1025 1025  
1026 1026   [[image:1654593712276-618.png]]
... ... @@ -1028,7 +1028,6 @@
1028 1028  Valid AT Command please check [[Configure Device>>path:#H3.ConfigureLSPH01viaATCommandorLoRaWANDownlink]].
1029 1029  
1030 1030  
1031 -
1032 1032  = 6. FAQ =
1033 1033  
1034 1034  == 6.1 How to change the LoRa Frequency Bands/Region ==
... ... @@ -1037,7 +1037,6 @@
1037 1037  When downloading the images, choose the required image file for download. ​
1038 1038  
1039 1039  
1040 -
1041 1041  = 7. Trouble Shooting =
1042 1042  
1043 1043  == 7.1 AT Commands input doesn’t work ==
... ... @@ -1045,7 +1045,6 @@
1045 1045  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.
1046 1046  
1047 1047  
1048 -
1049 1049  = 8. Order Info =
1050 1050  
1051 1051  Part Number: (% style="color:blue" %)**LSPH01-XX**
... ... @@ -1062,7 +1062,6 @@
1062 1062  * (% style="color:red" %)**IN865**(%%):  LoRaWAN IN865 band
1063 1063  * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
1064 1064  
1065 -
1066 1066  = 9. ​Packing Info =
1067 1067  
1068 1068  
... ... @@ -1077,7 +1077,6 @@
1077 1077  * Package Size / pcs : cm
1078 1078  * Weight / pcs : g
1079 1079  
1080 -
1081 1081  = 10. ​Support =
1082 1082  
1083 1083  * 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.
Copyright ©2010-2024 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0