Changes for page PS-LB/LS -- LoRaWAN Air Water Pressure Sensor User Manual
Last modified by Xiaoling on 2025/04/19 17:58
Change comment:
There is no comment for this version
Summary
-
Page properties (2 modified, 0 added, 0 removed)
-
Attachments (0 modified, 3 added, 0 removed)
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. Xiaoling1 +XWiki.Bei - Content
-
... ... @@ -43,7 +43,6 @@ 43 43 [[image:1675071321348-194.png]] 44 44 45 45 46 - 47 47 == 1.2 Features == 48 48 49 49 ... ... @@ -59,7 +59,9 @@ 59 59 * Uplink on periodically 60 60 * Downlink to change configure 61 61 * 8500mAh Battery for long term use 61 +* Controllable 3.3v,5v and 12v output to power external sensor 62 62 63 + 63 63 == 1.3 Specification == 64 64 65 65 ... ... @@ -106,6 +106,7 @@ 106 106 * Sleep Mode: 5uA @ 3.3v 107 107 * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm 108 108 110 + 109 109 == 1.4 Probe Types == 110 110 111 111 === 1.4.1 Thread Installation Type === ... ... @@ -124,6 +124,7 @@ 124 124 * Operating temperature: -20℃~~60℃ 125 125 * Connector Type: Various Types, see order info 126 126 129 + 127 127 === 1.4.2 Immersion Type === 128 128 129 129 ... ... @@ -140,11 +140,11 @@ 140 140 * Operating temperature: -40℃~~85℃ 141 141 * Material: 316 stainless steels 142 142 146 + 143 143 == 1.5 Probe Dimension == 144 144 145 145 146 146 147 - 148 148 == 1.6 Application and Installation == 149 149 150 150 === 1.6.1 Thread Installation Type === ... ... @@ -199,18 +199,19 @@ 199 199 200 200 201 201 (% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %) 202 -|=(% style="width: 1 50px;" %)**Behavior on ACT**|=(% style="width:90px;" %)**Function**|=**Action**203 -|(% style="width: 260px" %)Pressing ACT between 1s < time < 3s|(% style="width:100px" %)Send an uplink|(((205 +|=(% style="width: 167px;" %)**Behavior on ACT**|=(% style="width: 117px;" %)**Function**|=(% style="width: 225px;" %)**Action** 206 +|(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:117px" %)Send an uplink|(% style="width:225px" %)((( 204 204 If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once. 205 205 Meanwhile, BLE module will be active and user can connect via BLE to configure device. 206 206 ))) 207 -|(% style="width:1 38px" %)Pressing ACT for more than 3s|(% style="width:100px" %)Active Device|(((210 +|(% style="width:167px" %)Pressing ACT for more than 3s|(% style="width:117px" %)Active Device|(% style="width:225px" %)((( 208 208 (% style="color:green" %)**Green led**(%%) will fast blink 5 times, device will enter (% style="color:#037691" %)**OTA mode**(%%) for 3 seconds. And then start to JOIN LoRaWAN network. 209 209 (% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network. 210 210 Once sensor is active, BLE module will be active and user can connect via BLE to configure device, no matter if device join or not join LoRaWAN network. 211 211 ))) 212 -|(% style="width:1 38px" %)Fast press ACT 5 times.|(% style="width:100px" %)Deactivate Device|red led will solid on for 5 seconds. Means PS-LB is in Deep Sleep Mode.215 +|(% style="width:167px" %)Fast press ACT 5 times.|(% style="width:117px" %)Deactivate Device|(% style="width:225px" %)(% style="color:red" %)**Red led**(%%) will solid on for 5 seconds. Means PS-LB is in Deep Sleep Mode. 213 213 217 + 214 214 == 1.9 Pin Mapping == 215 215 216 216 ... ... @@ -235,8 +235,6 @@ 235 235 == 1.11 Mechanical == 236 236 237 237 238 - 239 - 240 240 [[image:1675143884058-338.png]] 241 241 242 242 ... ... @@ -254,7 +254,6 @@ 254 254 The PS-LB is configured as (% style="color:#037691" %)**LoRaWAN OTAA Class A**(%%) mode by default. It has OTAA keys to join LoRaWAN network. To connect a local LoRaWAN network, you need to input the OTAA keys in the LoRaWAN IoT server and activate the PS-LB. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 20 minutes. 255 255 256 256 257 - 258 258 == 2.2 Quick guide to connect to LoRaWAN server (OTAA) == 259 259 260 260 ... ... @@ -308,18 +308,8 @@ 308 308 After join success, it will start to upload messages to TTN and you can see the messages in the panel. 309 309 310 310 311 - 312 312 == 2.3 Uplink Payload == 313 313 314 - 315 -Uplink payloads have two types: 316 - 317 -* Distance Value: Use FPORT=2 318 -* Other control commands: Use other FPORT fields. 319 - 320 -The application server should parse the correct value based on FPORT settings. 321 - 322 - 323 323 === 2.3.1 Device Status, FPORT~=5 === 324 324 325 325 ... ... @@ -330,8 +330,8 @@ 330 330 331 331 (% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %) 332 332 |(% colspan="6" %)**Device Status (FPORT=5)** 333 -|(% style="width:103px" %)**Size (bytes)**|(% style="width:72px" %)**1**|**2**|**1**|**1**|**2** 334 -|(% style="width:103px" %)**Value**|(% style="width:72px" %)Sensor Model|Firmware Version|Frequency Band|Sub-band|BAT 324 +|(% style="width:103px" %)**Size (bytes)**|(% style="width:72px" %)**1**|**2**|(% style="width:91px" %)**1**|(% style="width:86px" %)**1**|(% style="width:44px" %)**2** 325 +|(% style="width:103px" %)**Value**|(% style="width:72px" %)Sensor Model|Firmware Version|(% style="width:91px" %)Frequency Band|(% style="width:86px" %)Sub-band|(% style="width:44px" %)BAT 335 335 336 336 Example parse in TTNv3 337 337 ... ... @@ -401,12 +401,14 @@ 401 401 |(% style="width:97px" %)((( 402 402 **Size(bytes)** 403 403 )))|(% style="width:48px" %)**2**|(% style="width:71px" %)**2**|(% style="width:98px" %)**2**|(% style="width:73px" %)**2**|(% style="width:122px" %)**1** 404 -|(% style="width:97px" %) **Value**|(% style="width:48px" %)[[BAT>>||anchor="H2.3.3BatteryInfo"]]|(% style="width:71px" %)[[Probe Model>>||anchor="H2.3.4ProbeModel"]]|(% style="width:98px" %)[[0 ~~~~ 20mA value>>||anchor="H2.3.507E20mAvalue28IDC_IN29"]]|(% style="width:73px" %)[[0 ~~~~ 30v value>>||anchor="H2.3.607E30Vvalue28pinVDC_IN29"]]|(% style="width:122px" %)[[IN1 &IN2 Interrupt flag>>||anchor="H2.3.7IN126IN226INTpin"]]395 +|(% style="width:97px" %)Value|(% style="width:48px" %)[[BAT>>||anchor="H2.3.4BatteryInfo"]]|(% style="width:71px" %)[[Probe Model>>||anchor="H2.3.5ProbeModel"]]|(% style="width:98px" %)[[0 ~~~~ 20mA value>>||anchor="H2.3.607E20mAvalue28IDC_IN29"]]|(% style="width:73px" %)[[0 ~~~~ 30v value>>||anchor="H2.3.707E30Vvalue28pinVDC_IN29"]]|(% style="width:122px" %)[[IN1 &IN2 Interrupt flag>>||anchor="H2.3.8IN126IN226INTpin"]] 405 405 406 406 [[image:1675144608950-310.png]] 407 407 408 408 400 +=== === 409 409 402 + 410 410 === 2.3.3 Battery Info === 411 411 412 412 ... ... @@ -420,19 +420,22 @@ 420 420 === 2.3.4 Probe Model === 421 421 422 422 423 -PS-LB has different kind of probe, 0~~20mA represent the full scale of the measuring range. So a 15mA output means different meaning for different probe.416 +PS-LB has different kind of probe, 4~~20mA represent the full scale of the measuring range. So a 12mA output means different meaning for different probe. 424 424 425 425 426 426 For example. 427 427 428 428 (% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %) 429 -|(% style="width:111px" %)**Part Number**|(% style="width:158px" %)**Probe Used**|**0~~20mA scale**|**Example: 10mA meaning** 430 -|(% style="width:111px" %)PS-LB-I3|(% style="width:158px" %)immersion type with 3 meters cable|0~~3 meters|1.5 meters pure water 431 -|(% style="width:111px" %)PS-LB-I5|(% style="width:158px" %)immersion type with 5 meters cable|0~~5 meters|2.5 meters pure water 422 +|**Part Number**|**Probe Used**|**4~~20mA scale**|**Example: 12mA meaning** 423 +|PS-LB-I3|immersion type with 3 meters cable|0~~3 meters|1.5 meters pure water 424 +|PS-LB-I5|immersion type with 5 meters cable|0~~5 meters|2.5 meters pure water 425 +|PS-LB-T20-B|T20 threaded probe|0~~1MPa|0.5MPa air / gas or water pressure 432 432 433 - Theprobe model field provides the convenient for server to identical how it should parse the 0~~20mA sensor value and get the correct value.427 + 434 434 429 +The probe model field provides the convenient for server to identical how it should parse the 4~~20mA sensor value and get the correct value. 435 435 431 + 436 436 === 2.3.5 0~~20mA value (IDC_IN) === 437 437 438 438 ... ... @@ -475,10 +475,27 @@ 475 475 476 476 0x01: Interrupt Uplink Packet. 477 477 474 +=== (% id="cke_bm_109176S" style="display:none" %) (%%)2.3.8 Sensor value, FPORT~=7 === 478 478 479 -=== 2.3.8 Decode payload in The Things Network === 480 480 477 +(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:508.222px" %) 478 +|(% style="width:94px" %)((( 479 +**Size(bytes)** 480 +)))|(% style="width:43px" %)2|(% style="width:367px" %)n 481 +|(% style="width:94px" %)**Value**|(% style="width:43px" %)[[BAT>>||anchor="H2.3.4BatteryInfo"]]|(% style="width:367px" %)((( 482 +Voltage value, each 2 bytes is a set of voltage values. 483 +))) 481 481 485 +[[image:image-20230220171300-1.png||height="207" width="863"]] 486 + 487 +Multiple sets of data collected are displayed in this form: 488 + 489 +[voltage value1], [voltage value2], [voltage value3],…[voltage value n] 490 + 491 + 492 +=== 2.3.9 Decode payload in The Things Network === 493 + 494 + 482 482 While using TTN network, you can add the payload format to decode the payload. 483 483 484 484 ... ... @@ -534,7 +534,6 @@ 534 534 [[image:1675145060812-420.png]] 535 535 536 536 537 - 538 538 After added, the sensor data arrive TTN, it will also arrive and show in Datacake. 539 539 540 540 ... ... @@ -557,7 +557,6 @@ 557 557 [[https:~~/~~/www.dropbox.com/sh/gf1glloczbzz19h/AABbuYI4WY6VdAmpXo6o1V2Ka?dl=0>>url:https://www.dropbox.com/sh/gf1glloczbzz19h/AABbuYI4WY6VdAmpXo6o1V2Ka?dl=0]] 558 558 559 559 560 - 561 561 = 3. Configure PS-LB via AT Command or LoRaWAN Downlink = 562 562 563 563 ... ... @@ -568,7 +568,7 @@ 568 568 569 569 There are two kinds of commands to configure PS-LB, they are: 570 570 571 -* (% style="color:#037691" %)**General Commands** .582 +* (% style="color:#037691" %)**General Commands** 572 572 573 573 These commands are to configure: 574 574 ... ... @@ -608,11 +608,12 @@ 608 608 609 609 Format: Command Code (0x01) followed by 3 bytes time value. 610 610 611 -If the downlink payload=0100003C, it means set the END Node ’s Transmit Interval to 0x00003C=60(S), while type code is 01.622 +If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01. 612 612 613 -* Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds 614 -* Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 624 +* Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds 625 +* Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 615 615 627 + 616 616 == 3.2 Set Interrupt Mode == 617 617 618 618 ... ... @@ -621,19 +621,19 @@ 621 621 (% style="color:blue" %)**AT Command: AT+INTMOD** 622 622 623 623 (% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %) 624 -|=**Command Example**|=**Function**|=**Response** 625 -|AT+INTMOD=?|Show current interrupt mode|((( 636 +|=(% style="width: 154px;" %)**Command Example**|=(% style="width: 196px;" %)**Function**|=(% style="width: 157px;" %)**Response** 637 +|(% style="width:154px" %)AT+INTMOD=?|(% style="width:196px" %)Show current interrupt mode|(% style="width:157px" %)((( 626 626 0 627 627 OK 628 -the mode is 0 = Nointerruption640 +the mode is 0 =Disable Interrupt 629 629 ))) 630 -|AT+INTMOD=2|((( 642 +|(% style="width:154px" %)AT+INTMOD=2|(% style="width:196px" %)((( 631 631 Set Transmit Interval 632 - ~1. (Disable Interrupt),633 - 2. (Trigger by rising and falling edge)634 - 3. (Trigger by falling edge)635 - 4. (Trigger by rising edge)636 -)))|OK 644 +0. (Disable Interrupt), 645 +~1. (Trigger by rising and falling edge) 646 +2. (Trigger by falling edge) 647 +3. (Trigger by rising edge) 648 +)))|(% style="width:157px" %)OK 637 637 638 638 (% style="color:blue" %)**Downlink Command: 0x06** 639 639 ... ... @@ -641,9 +641,10 @@ 641 641 642 642 This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06. 643 643 644 -* Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode 645 -* Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 656 +* Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode 657 +* Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 646 646 659 + 647 647 == 3.3 Set the output time == 648 648 649 649 ... ... @@ -706,39 +706,97 @@ 706 706 707 707 The first byte is which power, the second and third bytes are the time to turn on. 708 708 709 -* Example 1: Downlink Payload: 070101F4 -> AT+3V3T=500 710 -* Example 2: Downlink Payload: 0701FFFF -> AT+3V3T=65535 711 -* Example 3: Downlink Payload: 070203E8 -> AT+5VT=1000 712 -* Example 4: Downlink Payload: 07020000 -> AT+5VT=0 713 -* Example 5: Downlink Payload: 070301F4 -> AT+12VT=500 714 -* Example 6: Downlink Payload: 07030000 -> AT+12VT=0 722 +* Example 1: Downlink Payload: 070101F4 **~-~-->** AT+3V3T=500 723 +* Example 2: Downlink Payload: 0701FFFF **~-~-->** AT+3V3T=65535 724 +* Example 3: Downlink Payload: 070203E8 **~-~-->** AT+5VT=1000 725 +* Example 4: Downlink Payload: 07020000 **~-~-->** AT+5VT=0 726 +* Example 5: Downlink Payload: 070301F4 **~-~-->** AT+12VT=500 727 +* Example 6: Downlink Payload: 07030000 **~-~-->** AT+12VT=0 715 715 729 + 716 716 == 3.4 Set the Probe Model == 717 717 718 718 719 - (%style="color:blue"%)**ATCommand:AT****+PROBE**733 +Users need to configure this parameter according to the type of external probe. In this way, the server can decode according to this value, and convert the current value output by the sensor into water depth or pressure value. 720 720 721 -(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:448px" %) 722 -|=(% style="width: 154px;" %)**Command Example**|=(% style="width: 204px;" %)**Function**|=(% style="width: 85px;" %)**Response** 723 -|(% style="width:154px" %)AT +PROBE =?|(% style="width:204px" %)Get or Set the probe model.|(% style="width:85px" %)((( 724 -0 735 +**AT Command: AT** **+PROBE** 736 + 737 +AT+PROBE=aabb 738 + 739 +When aa=00, it is the water depth mode, and the current is converted into the water depth value; bb is the probe at a depth of several meters. 740 + 741 +When aa=01, it is the pressure mode, which converts the current into a pressure value; 742 + 743 +bb represents which type of pressure sensor it is. 744 + 745 +(A->01,B->02,C->03,D->04,E->05,F->06,G->07,H->08,I->09,J->0A,K->0B,L->0C) 746 + 747 +(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %) 748 +|**Command Example**|**Function**|**Response** 749 +|AT +PROBE =?|Get or Set the probe model.|0 725 725 OK 726 -))) 727 -|(% style="width:154px" %)AT +PROBE =0003|(% style="width:204px" %)Set water depth sensor mode, 3m type.|(% style="width:85px" %)OK 728 -|(% style="width:154px" %)AT +PROBE =0101|(% style="width:204px" %)Set pressure transmitters mode, first type.|(% style="width:85px" %)((( 751 +|AT +PROBE =0003|Set water depth sensor mode, 3m type.|OK 752 +|((( 753 +AT +PROBE =000A 754 + 755 + 756 +)))|Set water depth sensor mode, 10m type.|OK 757 +|AT +PROBE =0101|Set pressure transmitters mode, first type(A).|OK 758 +|AT +PROBE =0000|Initial state, no settings.|OK 759 + 760 + 761 + 762 +**Downlink Command: 0x08** 763 + 764 +Format: Command Code (0x08) followed by 2 bytes. 765 + 766 +* Example 1: Downlink Payload: 080003 **~-~-->** AT+PROBE=0003 767 +* Example 2: Downlink Payload: 080101 **~-~-->** AT+PROBE=0101 768 + 769 + 770 +== 3.5 Multiple collections are one uplink(Since firmware V1.1) == 771 + 772 + 773 +Added AT+STDC command to collect the voltage of VDC_INPUT multiple times and upload it at one time. 774 + 775 +(% style="color:blue" %)**AT Command: AT** **+STDC** 776 + 777 +AT+STDC=aa,bb,bb 778 + 779 +(% style="color:#037691" %)**aa:**(%%) 780 +**0:** means disable this function and use TDC to send packets. 781 +**1:** means enable this function, use the method of multiple acquisitions to send packets. 782 +(% style="color:#037691" %)**bb:**(%%) Each collection interval (s), the value is 1~~65535 783 +(% style="color:#037691" %)**cc:**(%%)** **the number of collection times, the value is 1~~120 784 + 785 +(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %) 786 +|**Command Example**|**Function**|**Response** 787 +|AT+STDC=?|Get the mode of multiple acquisitions and one uplink.|1,10,18 729 729 OK 789 +|AT+STDC=1,10,18|Set the mode of multiple acquisitions and one uplink, collect once every 10 seconds, and report after 18 times.|((( 790 +Attention:Take effect after ATZ 791 + 792 +OK 730 730 ))) 731 -|(% style="width:154px" %)AT +PROBE =0000|(% style="width:204px" %)Initial state, no settings.|(% style="width:85px" %)((( 794 +|AT+STDC=0, 0,0|((( 795 +Use the TDC interval to send packets.(default) 796 + 797 + 798 +)))|((( 799 +Attention:Take effect after ATZ 800 + 732 732 OK 733 733 ))) 734 734 735 - (%style="color:blue" %)**Downlink Command: 0x08**804 + 736 736 737 - Format: CommandCode (0x08) followed by 2 bytes.806 +(% style="color:blue" %)**Downlink Command: 0xAE** 738 738 739 -* Example 1: Downlink Payload: 080003 -> AT+PROBE=0003 740 -* Example 2: Downlink Payload: 080101 -> AT+PROBE=0101 808 +Format: Command Code (0x08) followed by 5 bytes. 741 741 810 +* Example 1: Downlink Payload: AE 01 02 58 12** ~-~-->** AT+STDC=1,600,18 811 + 812 + 742 742 = 4. Battery & how to replace = 743 743 744 744 == 4.1 Battery Type == ... ... @@ -746,7 +746,6 @@ 746 746 747 747 PS-LB is equipped with a [[8500mAH ER26500 Li-SOCI2 battery>>https://www.dropbox.com/sh/w9l2oa3ytpculph/AAAPtt-apH4lYfCj-2Y6lHvQa?dl=0]]. The battery is un-rechargeable battery with low discharge rate targeting for 8~~10 years use. This type of battery is commonly used in IoT target for long-term running, such as water meter. 748 748 749 - 750 750 The discharge curve is not linear so can’t simply use percentage to show the battery level. Below is the battery performance. 751 751 752 752 [[image:1675146710956-626.png]] ... ... @@ -770,15 +770,10 @@ 770 770 771 771 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. 772 772 773 - 774 774 Instruction to use as below: 775 775 845 +(% style="color:blue" %)**Step 1:**(%%) Downlink the up-to-date DRAGINO_Battery_Life_Prediction_Table.xlsx from: [[https:~~/~~/www.dropbox.com/sh/zwex6i331j5oeq2/AACIMf9f_v2qsJ39CuMQ5Py_a?dl=0>>https://www.dropbox.com/sh/zwex6i331j5oeq2/AACIMf9f_v2qsJ39CuMQ5Py_a?dl=0]] 776 776 777 -(% style="color:blue" %)**Step 1:**(%%) Downlink the up-to-date DRAGINO_Battery_Life_Prediction_Table.xlsx from: 778 - 779 -[[https:~~/~~/www.dropbox.com/sh/zwex6i331j5oeq2/AACIMf9f_v2qsJ39CuMQ5Py_a?dl=0>>https://www.dropbox.com/sh/zwex6i331j5oeq2/AACIMf9f_v2qsJ39CuMQ5Py_a?dl=0]] 780 - 781 - 782 782 (% style="color:blue" %)**Step 2:**(%%) Open it and choose 783 783 784 784 * Product Model ... ... @@ -872,6 +872,7 @@ 872 872 * Package Size / pcs : cm 873 873 * Weight / pcs : g 874 874 940 + 875 875 = 10. Support = 876 876 877 877
- image-20230201090514-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +560.9 KB - Content
- image-20230220171300-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Bei - Size
-
... ... @@ -1,0 +1,1 @@ 1 +98.0 KB - Content
- image-20230222174559-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Bei - Size
-
... ... @@ -1,0 +1,1 @@ 1 +19.4 KB - Content