Changes for page PS-LB/LS -- LoRaWAN Air Water Pressure Sensor User Manual
Last modified by Xiaoling on 2025/04/27 10:31
Summary
-
Page properties (1 modified, 0 added, 0 removed)
-
Attachments (0 modified, 4 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -8,27 +8,41 @@ 8 8 9 9 10 10 11 + 12 + 13 + 11 11 = 1. Introduction = 12 12 13 13 == 1.1 What is LoRaWAN Pressure Sensor == 14 14 15 15 16 -The Dragino PS-LB series sensors are **LoRaWAN Pressure Sensor** for Internet of Things solution. PS-LB can measure Air, Water pressure and liquid level and upload the sensor data via wireless to LoRaWAN IoT server. 19 +((( 20 +The Dragino PS-LB series sensors are (% style="color:blue" %)**LoRaWAN Pressure Sensor**(%%) for Internet of Things solution. PS-LB can measure Air, Water pressure and liquid level and upload the sensor data via wireless to LoRaWAN IoT server. 21 +))) 17 17 18 -The PS-LB series sensors include **Thread Installation Type** and **Immersion Type**, it supports different pressure range which can be used for different measurement requirement. 23 +((( 24 +The PS-LB series sensors include (% style="color:blue" %)**Thread Installation Type**(%%) and (% style="color:blue" %)**Immersion Type**(%%), it supports different pressure range which can be used for different measurement requirement. 25 +))) 19 19 27 +((( 20 20 The LoRa wireless technology used in PS-LB 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. 29 +))) 21 21 31 +((( 22 22 PS-LB supports BLE configure and wireless OTA update which make user easy to use. 33 +))) 23 23 24 -PS-LB is powered by **8500mAh Li-SOCI2 battery**, it is designed for long term use up to 5 years. 35 +((( 36 +PS-LB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long term use up to 5 years. 37 +))) 25 25 39 +((( 26 26 Each PS-LB 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. 41 +))) 27 27 28 28 [[image:1675071321348-194.png]] 29 29 30 30 31 - 32 32 == 1.2 Features == 33 33 34 34 ... ... @@ -44,23 +44,25 @@ 44 44 * Uplink on periodically 45 45 * Downlink to change configure 46 46 * 8500mAh Battery for long term use 61 +* Controllable 3.3v,5v and 12v output to power external sensor 47 47 48 48 64 + 49 49 == 1.3 Specification == 50 50 51 51 52 -**Micro Controller:** 68 +(% style="color:#037691" %)**Micro Controller:** 53 53 54 54 * MCU: 48Mhz ARM 55 55 * Flash: 256KB 56 56 * RAM: 64KB 57 57 58 -**Common DC Characteristics:** 74 +(% style="color:#037691" %)**Common DC Characteristics:** 59 59 60 60 * Supply Voltage: 2.5v ~~ 3.6v 61 61 * Operating Temperature: -40 ~~ 85°C 62 62 63 -**LoRa Spec:** 79 +(% style="color:#037691" %)**LoRa Spec:** 64 64 65 65 * Frequency Range, Band 1 (HF): 862 ~~ 1020 Mhz 66 66 * Max +22 dBm constant RF output vs. ... ... @@ -67,19 +67,19 @@ 67 67 * RX sensitivity: down to -139 dBm. 68 68 * Excellent blocking immunity 69 69 70 -**Current Input Measuring :** 86 +(% style="color:#037691" %)**Current Input Measuring :** 71 71 72 72 * Range: 0 ~~ 20mA 73 73 * Accuracy: 0.02mA 74 74 * Resolution: 0.001mA 75 75 76 -**Voltage Input Measuring:** 92 +(% style="color:#037691" %)**Voltage Input Measuring:** 77 77 78 78 * Range: 0 ~~ 30v 79 79 * Accuracy: 0.02v 80 80 * Resolution: 0.001v 81 81 82 -**Battery:** 98 +(% style="color:#037691" %)**Battery:** 83 83 84 84 * Li/SOCI2 un-chargeable battery 85 85 * Capacity: 8500mAh ... ... @@ -87,12 +87,13 @@ 87 87 * Max continuously current: 130mA 88 88 * Max boost current: 2A, 1 second 89 89 90 -**Power Consumption** 106 +(% style="color:#037691" %)**Power Consumption** 91 91 92 92 * Sleep Mode: 5uA @ 3.3v 93 93 * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm 94 94 95 95 112 + 96 96 == 1.4 Probe Types == 97 97 98 98 === 1.4.1 Thread Installation Type === ... ... @@ -112,6 +112,7 @@ 112 112 * Connector Type: Various Types, see order info 113 113 114 114 132 + 115 115 === 1.4.2 Immersion Type === 116 116 117 117 ... ... @@ -129,17 +129,17 @@ 129 129 * Material: 316 stainless steels 130 130 131 131 150 + 132 132 == 1.5 Probe Dimension == 133 133 134 134 135 135 136 - 137 137 == 1.6 Application and Installation == 138 138 139 139 === 1.6.1 Thread Installation Type === 140 140 141 141 142 -**Application:** 160 +(% style="color:blue" %)**Application:** 143 143 144 144 * Hydraulic Pressure 145 145 * Petrochemical Industry ... ... @@ -157,7 +157,7 @@ 157 157 === 1.6.2 Immersion Type === 158 158 159 159 160 -**Application:** 178 +(% style="color:blue" %)**Application:** 161 161 162 162 Liquid & Water Pressure / Level detect. 163 163 ... ... @@ -176,9 +176,9 @@ 176 176 == 1.7 Sleep mode and working mode == 177 177 178 178 179 -**Deep Sleep Mode: **Sensor doesn't have any LoRaWAN activate. This mode is used for storage and shipping to save battery life. 197 +(% style="color:blue" %)**Deep Sleep Mode: **(%%)Sensor doesn't have any LoRaWAN activate. This mode is used for storage and shipping to save battery life. 180 180 181 -**Working Mode:** In this mode, Sensor will work as LoRaWAN Sensor to Join LoRaWAN network and send out sensor data to server. Between each sampling/tx/rx periodically, sensor will be in IDLE mode), in IDLE mode, sensor has the same power consumption as Deep Sleep mode. 199 +(% style="color:blue" %)**Working Mode:** (%%)In this mode, Sensor will work as LoRaWAN Sensor to Join LoRaWAN network and send out sensor data to server. Between each sampling/tx/rx periodically, sensor will be in IDLE mode), in IDLE mode, sensor has the same power consumption as Deep Sleep mode. 182 182 183 183 184 184 == 1.8 Button & LEDs == ... ... @@ -188,20 +188,17 @@ 188 188 189 189 190 190 (% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %) 191 -|(% style="width:138px" %)**Behavior on ACT**|(% style="width:100px" %)**Function**|**Action** 192 -|(% style="width:138px" %)Pressing ACT between 1s < time < 3s|(% style="width:100px" %)Send an uplink|((( 193 -If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, **blue led** will blink once. 194 - 209 +|=(% style="width: 167px;" %)**Behavior on ACT**|=(% style="width: 117px;" %)**Function**|=(% style="width: 225px;" %)**Action** 210 +|(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:117px" %)Send an uplink|(% style="width:225px" %)((( 211 +If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once. 195 195 Meanwhile, BLE module will be active and user can connect via BLE to configure device. 196 196 ))) 197 -|(% style="width:138px" %)Pressing ACT for more than 3s|(% style="width:100px" %)Active Device|((( 198 -**Green led** will fast blink 5 times, device will enter **OTA mode** for 3 seconds. And then start to JOIN LoRaWAN network. 199 - 200 -**Green led** will solidly turn on for 5 seconds after joined in network. 201 - 214 +|(% style="width:167px" %)Pressing ACT for more than 3s|(% style="width:117px" %)Active Device|(% style="width:225px" %)((( 215 +(% 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. 216 +(% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network. 202 202 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. 203 203 ))) 204 -|(% 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.219 +|(% 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. 205 205 206 206 207 207 ... ... @@ -229,8 +229,6 @@ 229 229 == 1.11 Mechanical == 230 230 231 231 232 - 233 - 234 234 [[image:1675143884058-338.png]] 235 235 236 236 ... ... @@ -245,10 +245,9 @@ 245 245 == 2.1 How it works == 246 246 247 247 248 -The PS-LB is configured as **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. 261 +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. 249 249 250 250 251 - 252 252 == 2.2 Quick guide to connect to LoRaWAN server (OTAA) == 253 253 254 254 ... ... @@ -261,7 +261,7 @@ 261 261 The LPS8V2 is already set to connected to [[TTN network >>url:https://console.cloud.thethings.network/]], so what we need to now is configure the TTN server. 262 262 263 263 264 -**Step 1** :Create a device in TTN with the OTAA keys from PS-LB.276 +(% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from PS-LB. 265 265 266 266 Each PS-LB is shipped with a sticker with the default device EUI as below: 267 267 ... ... @@ -272,48 +272,38 @@ 272 272 You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot: 273 273 274 274 275 -**Register the device** 287 +(% style="color:blue" %)**Register the device** 276 276 277 277 [[image:1675144099263-405.png]] 278 278 279 279 280 -**Add APP EUI and DEV EUI** 292 +(% style="color:blue" %)**Add APP EUI and DEV EUI** 281 281 282 282 [[image:1675144117571-832.png]] 283 283 284 284 285 -**Add APP EUI in the application** 297 +(% style="color:blue" %)**Add APP EUI in the application** 286 286 287 287 288 288 [[image:1675144143021-195.png]] 289 289 290 290 291 -**Add APP KEY** 303 +(% style="color:blue" %)**Add APP KEY** 292 292 293 293 [[image:1675144157838-392.png]] 294 294 295 -**Step 2** :Activate on PS-LB307 +(% style="color:blue" %)**Step 2:**(%%) Activate on PS-LB 296 296 297 297 298 298 Press the button for 5 seconds to activate the PS-LB. 299 299 300 -**Green led** will fast blink 5 times, device will enter **OTA mode** for 3 seconds. And then start to JOIN LoRaWAN network. **Green led** will solidly turn on for 5 seconds after joined in network. 312 +(% style="color:green" %)**Green led**(%%) will fast blink 5 times, device will enter (% style="color:blue" %)**OTA mode**(%%) for 3 seconds. And then start to JOIN LoRaWAN network. (% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network. 301 301 302 302 After join success, it will start to upload messages to TTN and you can see the messages in the panel. 303 303 304 304 305 - 306 306 == 2.3 Uplink Payload == 307 307 308 - 309 -Uplink payloads have two types: 310 - 311 -* Distance Value: Use FPORT=2 312 -* Other control commands: Use other FPORT fields. 313 - 314 -The application server should parse the correct value based on FPORT settings. 315 - 316 - 317 317 === 2.3.1 Device Status, FPORT~=5 === 318 318 319 319 ... ... @@ -324,8 +324,8 @@ 324 324 325 325 (% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %) 326 326 |(% colspan="6" %)**Device Status (FPORT=5)** 327 -|(% style="width:103px" %)**Size (bytes)**|(% style="width:72px" %)**1**|**2**|**1**|**1**|**2** 328 -|(% style="width:103px" %)**Value**|(% style="width:72px" %)Sensor Model|Firmware Version|Frequency Band|Sub-band|BAT 329 +|(% style="width:103px" %)**Size (bytes)**|(% style="width:72px" %)**1**|**2**|(% style="width:91px" %)**1**|(% style="width:86px" %)**1**|(% style="width:44px" %)**2** 330 +|(% 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 329 329 330 330 Example parse in TTNv3 331 331 ... ... @@ -332,11 +332,11 @@ 332 332 [[image:1675144504430-490.png]] 333 333 334 334 335 -**Sensor Model**: For PS-LB, this value is 0x16 337 +(% style="color:#037691" %)**Sensor Model**(%%): For PS-LB, this value is 0x16 336 336 337 -**Firmware Version**: 0x0100, Means: v1.0.0 version 339 +(% style="color:#037691" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version 338 338 339 -**Frequency Band**: 341 +(% style="color:#037691" %)**Frequency Band**: 340 340 341 341 *0x01: EU868 342 342 ... ... @@ -367,7 +367,7 @@ 367 367 *0x0e: MA869 368 368 369 369 370 -**Sub-Band**: 372 +(% style="color:#037691" %)**Sub-Band**: 371 371 372 372 AU915 and US915:value 0x00 ~~ 0x08 373 373 ... ... @@ -376,7 +376,7 @@ 376 376 Other Bands: Always 0x00 377 377 378 378 379 -**Battery Info**: 381 +(% style="color:#037691" %)**Battery Info**: 380 380 381 381 Check the battery voltage. 382 382 ... ... @@ -385,7 +385,7 @@ 385 385 Ex2: 0x0B49 = 2889mV 386 386 387 387 388 -=== 1.3.2 Sensor value, FPORT~=2 ===390 +=== 2.3.2 Sensor value, FPORT~=2 === 389 389 390 390 391 391 Uplink payload includes in total 9 bytes. ... ... @@ -394,13 +394,12 @@ 394 394 (% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %) 395 395 |(% style="width:97px" %)((( 396 396 **Size(bytes)** 397 -)))|(% style="width:48px" %)**2**|(% style="width: 58px" %)**2**|**2**|**2**|**1**398 -|(% style="width:97px" %) **Value**|(% style="width:48px" %)[[BAT>>path:#bat]]|(% style="width:58px" %)[[Probe Model>>path:#Probe_Model]]|0 ~~ 20mA value|[[0 ~~~~ 30v value>>path:#Voltage_30v]]|[[IN1 &IN2 Interrupt flag>>path:#Int_pin]]399 +)))|(% style="width:48px" %)**2**|(% style="width:71px" %)**2**|(% style="width:98px" %)**2**|(% style="width:73px" %)**2**|(% style="width:122px" %)**1** 400 +|(% 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"]] 399 399 400 400 [[image:1675144608950-310.png]] 401 401 402 402 403 - 404 404 === 2.3.3 Battery Info === 405 405 406 406 ... ... @@ -414,35 +414,41 @@ 414 414 === 2.3.4 Probe Model === 415 415 416 416 417 -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.418 +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. 418 418 419 419 420 420 For example. 421 421 422 422 (% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %) 423 -|(% style="width:111px" %)**Part Number**|(% style="width:158px" %)**Probe Used**|**0~~20mA scale**|**Example: 10mA meaning** 424 -|(% style="width:111px" %)PS-LB-I3|(% style="width:158px" %)immersion type with 3 meters cable|0~~3 meters|1.5 meters pure water 425 -|(% style="width:111px" %)PS-LB-I5|(% style="width:158px" %)immersion type with 5 meters cable|0~~5 meters|2.5 meters pure water 424 +|**Part Number**|**Probe Used**|**4~~20mA scale**|**Example: 12mA meaning** 425 +|PS-LB-I3|immersion type with 3 meters cable|0~~3 meters|1.5 meters pure water 426 +|PS-LB-I5|immersion type with 5 meters cable|0~~5 meters|2.5 meters pure water 427 +|PS-LB-T20-B|T20 threaded probe|0~~1MPa|0.5MPa air / gas or water pressure 426 426 427 -The probe model field provides the convenient for server to identical how it should parse the 0~~20mA sensor value and get the correct value.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. 428 428 429 429 430 430 === 2.3.5 0~~20mA value (IDC_IN) === 431 431 432 432 433 -The output value from Pressure Probe, use together with Probe Model to get the pressure value or water level. 435 +The output value from **Pressure Probe**, use together with Probe Model to get the pressure value or water level. 434 434 435 -**Example**: 437 +(% style="color:#037691" %)**Example**: 436 436 437 437 27AE(H) = 10158 (D)/1000 = 10.158mA. 438 438 439 439 442 +Instead of pressure probe, User can also connect a general 4~~20mA in this port to support different types of 4~~20mA sensors. below is the connection example: 443 + 444 +[[image:image-20230225154759-1.png||height="408" width="741"]] 445 + 446 + 440 440 === 2.3.6 0~~30V value ( pin VDC_IN) === 441 441 442 442 443 443 Measure the voltage value. The range is 0 to 30V. 444 444 445 -**Example**: 452 +(% style="color:#037691" %)**Example**: 446 446 447 447 138E(H) = 5006(D)/1000= 5.006V 448 448 ... ... @@ -452,27 +452,45 @@ 452 452 453 453 IN1 and IN2 are used as digital input pins. 454 454 455 -**Example**: 462 +(% style="color:#037691" %)**Example**: 456 456 457 -09 (H) 464 +09 (H): (0x09&0x08)>>3=1 IN1 pin is high level. 458 458 459 -09 (H) 466 +09 (H): (0x09&0x04)>>2=0 IN2 pin is low level. 460 460 461 461 462 -This data field shows if this packet is generated by **Interrupt Pin** or not. [[Click here>> path:#Int_mod]] for the hardware and software set up. Note: The Internet Pin is a separate pin in the screw terminal.469 +This data field shows if this packet is generated by (% style="color:blue" %)**Interrupt Pin** (%%)or not. [[Click here>>||anchor="H3.2SetInterruptMode"]] for the hardware and software set up. Note: The Internet Pin is a separate pin in the screw terminal. 463 463 464 -**Example:** 471 +(% style="color:#037691" %)**Example:** 465 465 466 -09 (H) 473 +09 (H): (0x09&0x02)>>1=1 The level of the interrupt pin. 467 467 468 -09 (H) 475 +09 (H): 0x09&0x01=1 0x00: Normal uplink packet. 469 469 470 470 0x01: Interrupt Uplink Packet. 471 471 472 472 473 -=== 2.3.8DecodepayloadTheThingsNetwork===480 +=== (% id="cke_bm_109176S" style="display:none" %) (%%)2.3.8 Sensor value, FPORT~=7 === 474 474 475 475 483 +(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:508.222px" %) 484 +|(% style="width:94px" %)((( 485 +**Size(bytes)** 486 +)))|(% style="width:43px" %)2|(% style="width:367px" %)n 487 +|(% style="width:94px" %)**Value**|(% style="width:43px" %)[[BAT>>||anchor="H2.3.4BatteryInfo"]]|(% style="width:367px" %)((( 488 +Voltage value, each 2 bytes is a set of voltage values. 489 +))) 490 + 491 +[[image:image-20230220171300-1.png||height="207" width="863"]] 492 + 493 +Multiple sets of data collected are displayed in this form: 494 + 495 +[voltage value1], [voltage value2], [voltage value3],…[voltage value n/2] 496 + 497 + 498 +=== 2.3.9 Decode payload in The Things Network === 499 + 500 + 476 476 While using TTN network, you can add the payload format to decode the payload. 477 477 478 478 ... ... @@ -494,9 +494,9 @@ 494 494 [[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: 495 495 496 496 497 -**Step 1: **Be sure that your device is programmed and properly connected to the network at this time. 522 +(% style="color:blue" %)**Step 1: **(%%)Be sure that your device is programmed and properly connected to the network at this time. 498 498 499 -**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: 524 +(% 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: 500 500 501 501 502 502 [[image:1675144951092-237.png]] ... ... @@ -505,9 +505,9 @@ 505 505 [[image:1675144960452-126.png]] 506 506 507 507 508 -**Step 3:** Create an account or log in Datacake. 533 +(% style="color:blue" %)**Step 3:**(%%) Create an account or log in Datacake. 509 509 510 -**Step 4:** Create PS-LB product. 535 +(% style="color:blue" %)**Step 4:** (%%)Create PS-LB product. 511 511 512 512 [[image:1675145004465-869.png]] 513 513 ... ... @@ -520,7 +520,7 @@ 520 520 [[image:1675145029119-717.png]] 521 521 522 522 523 -**Step 5: **add payload decode 548 +(% style="color:blue" %)**Step 5: **(%%)add payload decode 524 524 525 525 [[image:1675145051360-659.png]] 526 526 ... ... @@ -528,7 +528,6 @@ 528 528 [[image:1675145060812-420.png]] 529 529 530 530 531 - 532 532 After added, the sensor data arrive TTN, it will also arrive and show in Datacake. 533 533 534 534 ... ... @@ -551,19 +551,17 @@ 551 551 [[https:~~/~~/www.dropbox.com/sh/gf1glloczbzz19h/AABbuYI4WY6VdAmpXo6o1V2Ka?dl=0>>url:https://www.dropbox.com/sh/gf1glloczbzz19h/AABbuYI4WY6VdAmpXo6o1V2Ka?dl=0]] 552 552 553 553 554 - 555 555 = 3. Configure PS-LB via AT Command or LoRaWAN Downlink = 556 556 557 557 558 558 Use can configure PS-LB via AT Command or LoRaWAN Downlink. 559 559 560 -* AT Command Connection: See [[FAQ>> path:#AT_COMMAND]].583 +* AT Command Connection: See [[FAQ>>||anchor="H7.FAQ"]]. 561 561 * LoRaWAN Downlink instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section. 562 562 563 - 564 564 There are two kinds of commands to configure PS-LB, they are: 565 565 566 -* **General Commands** .588 +* (% style="color:#037691" %)**General Commands** 567 567 568 568 These commands are to configure: 569 569 ... ... @@ -575,7 +575,7 @@ 575 575 [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/]] 576 576 577 577 578 -* **Commands special design for PS-LB** 600 +* (% style="color:#037691" %)**Commands special design for PS-LB** 579 579 580 580 These commands only valid for PS-LB, as below: 581 581 ... ... @@ -585,69 +585,61 @@ 585 585 586 586 Feature: Change LoRaWAN End Node Transmit Interval. 587 587 588 -**AT Command: AT+TDC** 610 +(% style="color:blue" %)**AT Command: AT+TDC** 589 589 590 590 (% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %) 591 -|**Command Example**|**Function**|**Response** 592 -|AT+TDC=?|Show current transmit Interval|((( 613 +|=(% style="width: 156px;" %)**Command Example**|=(% style="width: 137px;" %)**Function**|=**Response** 614 +|(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|((( 593 593 30000 594 - 595 595 OK 596 - 597 597 the interval is 30000ms = 30s 598 598 ))) 599 -|AT+TDC=60000|Set Transmit Interval|((( 619 +|(% style="width:156px" %)AT+TDC=60000|(% style="width:137px" %)Set Transmit Interval|((( 600 600 OK 601 - 602 602 Set transmit interval to 60000ms = 60 seconds 603 603 ))) 604 604 605 -**Downlink Command: 0x01** 624 +(% style="color:blue" %)**Downlink Command: 0x01** 606 606 607 607 Format: Command Code (0x01) followed by 3 bytes time value. 608 608 609 -If the downlink payload=0100003C, it means set the END Node ’s Transmit Interval to 0x00003C=60(S), while type code is 01.628 +If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01. 610 610 611 -* Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds 612 -* Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 630 +* Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds 631 +* Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 613 613 614 614 634 + 615 615 == 3.2 Set Interrupt Mode == 616 616 617 617 618 618 Feature, Set Interrupt mode for GPIO_EXIT. 619 619 620 -**AT Command: AT+INTMOD** 640 +(% style="color:blue" %)**AT Command: AT+INTMOD** 621 621 622 622 (% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %) 623 -|**Command Example**|**Function**|**Response** 624 -|AT+INTMOD=?|Show current interrupt mode|((( 643 +|=(% style="width: 154px;" %)**Command Example**|=(% style="width: 196px;" %)**Function**|=(% style="width: 157px;" %)**Response** 644 +|(% style="width:154px" %)AT+INTMOD=?|(% style="width:196px" %)Show current interrupt mode|(% style="width:157px" %)((( 625 625 0 626 - 627 627 OK 628 - 629 -the mode is 0 = No interruption 647 +the mode is 0 =Disable Interrupt 630 630 ))) 631 -|AT+INTMOD=2|((( 649 +|(% style="width:154px" %)AT+INTMOD=2|(% style="width:196px" %)((( 632 632 Set Transmit Interval 651 +0. (Disable Interrupt), 652 +~1. (Trigger by rising and falling edge) 653 +2. (Trigger by falling edge) 654 +3. (Trigger by rising edge) 655 +)))|(% style="width:157px" %)OK 633 633 634 - ~1.(DisableInterrupt),657 +(% style="color:blue" %)**Downlink Command: 0x06** 635 635 636 -2. (Trigger by rising and falling edge), 637 - 638 -3. (Trigger by falling edge) 639 - 640 -4. (Trigger by rising edge) 641 -)))|OK 642 - 643 -**Downlink Command: 0x06** 644 - 645 645 Format: Command Code (0x06) followed by 3 bytes. 646 646 647 647 This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06. 648 648 649 -* Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode 650 -* Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 663 +* Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode 664 +* Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 651 651 652 652 653 653 ... ... @@ -656,87 +656,69 @@ 656 656 657 657 Feature, Control the output 3V3 , 5V or 12V. 658 658 659 -**AT Command: AT+3V3T** 673 +(% style="color:blue" %)**AT Command: AT+3V3T** 660 660 661 -(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width: 510px" %)662 -|(% style="width:15 6px" %)**Command Example**|(% style="width:236px" %)**Function**|(% style="width:117px" %)**Response**663 -|(% style="width:15 6px" %)AT+3V3T=?|(% style="width:236px" %)Show 3V3 open time.|(% style="width:117px" %)(((675 +(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:474px" %) 676 +|=(% style="width: 154px;" %)**Command Example**|=(% style="width: 201px;" %)**Function**|=(% style="width: 116px;" %)**Response** 677 +|(% style="width:154px" %)AT+3V3T=?|(% style="width:201px" %)Show 3V3 open time.|(% style="width:116px" %)((( 664 664 0 665 - 666 666 OK 667 667 ))) 668 -|(% style="width:15 6px" %)AT+3V3T=0|(% style="width:236px" %)Normally open 3V3 power supply.|(% style="width:117px" %)(((681 +|(% style="width:154px" %)AT+3V3T=0|(% style="width:201px" %)Normally open 3V3 power supply.|(% style="width:116px" %)((( 669 669 OK 670 - 671 671 default setting 672 672 ))) 673 -|(% style="width:15 6px" %)AT+3V3T=1000|(% style="width:236px" %)Close after a delay of 1000 milliseconds.|(% style="width:117px" %)(((685 +|(% style="width:154px" %)AT+3V3T=1000|(% style="width:201px" %)Close after a delay of 1000 milliseconds.|(% style="width:116px" %)((( 674 674 OK 675 - 676 - 677 677 ))) 678 -|(% style="width:15 6px" %)AT+3V3T=65535|(% style="width:236px" %)Normally closed 3V3 power supply.|(% style="width:117px" %)(((688 +|(% style="width:154px" %)AT+3V3T=65535|(% style="width:201px" %)Normally closed 3V3 power supply.|(% style="width:116px" %)((( 679 679 OK 680 - 681 - 682 682 ))) 683 683 692 +(% style="color:blue" %)**AT Command: AT+5VT** 684 684 685 -**AT Command: AT+5VT** 686 - 687 -(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %) 688 -|(% style="width:158px" %)**Command Example**|(% style="width:232px" %)**Function**|(% style="width:119px" %)**Response** 689 -|(% style="width:158px" %)AT+5VT=?|(% style="width:232px" %)Show 5V open time.|(% style="width:119px" %)((( 694 +(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:470px" %) 695 +|=(% style="width: 155px;" %)**Command Example**|=(% style="width: 196px;" %)**Function**|=(% style="width: 114px;" %)**Response** 696 +|(% style="width:155px" %)AT+5VT=?|(% style="width:196px" %)Show 5V open time.|(% style="width:114px" %)((( 690 690 0 691 - 692 692 OK 693 693 ))) 694 -|(% style="width:15 8px" %)AT+5VT=0|(% style="width:232px" %)Normally closed 5V power supply.|(% style="width:119px" %)(((700 +|(% style="width:155px" %)AT+5VT=0|(% style="width:196px" %)Normally closed 5V power supply.|(% style="width:114px" %)((( 695 695 OK 696 - 697 697 default setting 698 698 ))) 699 -|(% style="width:15 8px" %)AT+5VT=1000|(% style="width:232px" %)Close after a delay of 1000 milliseconds.|(% style="width:119px" %)(((704 +|(% style="width:155px" %)AT+5VT=1000|(% style="width:196px" %)Close after a delay of 1000 milliseconds.|(% style="width:114px" %)((( 700 700 OK 701 - 702 - 703 703 ))) 704 -|(% style="width:15 8px" %)AT+5VT=65535|(% style="width:232px" %)Normally open 5V power supply.|(% style="width:119px" %)(((707 +|(% style="width:155px" %)AT+5VT=65535|(% style="width:196px" %)Normally open 5V power supply.|(% style="width:114px" %)((( 705 705 OK 706 - 707 - 708 708 ))) 709 709 711 +(% style="color:blue" %)**AT Command: AT+12VT** 710 710 711 -**AT Command: AT+12VT** 712 - 713 -(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %) 714 -|(% style="width:156px" %)**Command Example**|(% style="width:268px" %)**Function**|**Response** 715 -|(% style="width:156px" %)AT+12VT=?|(% style="width:268px" %)Show 12V open time.|((( 713 +(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:443px" %) 714 +|=(% style="width: 156px;" %)**Command Example**|=(% style="width: 199px;" %)**Function**|=(% style="width: 83px;" %)**Response** 715 +|(% style="width:156px" %)AT+12VT=?|(% style="width:199px" %)Show 12V open time.|(% style="width:83px" %)((( 716 716 0 717 - 718 718 OK 719 719 ))) 720 -|(% style="width:156px" %)AT+12VT=0|(% style="width: 268px" %)Normally closed 12V power supply.|OK721 -|(% style="width:156px" %)AT+12VT=500|(% style="width: 268px" %)Close after a delay of 500 milliseconds.|(((719 +|(% style="width:156px" %)AT+12VT=0|(% style="width:199px" %)Normally closed 12V power supply.|(% style="width:83px" %)OK 720 +|(% style="width:156px" %)AT+12VT=500|(% style="width:199px" %)Close after a delay of 500 milliseconds.|(% style="width:83px" %)((( 722 722 OK 723 - 724 - 725 725 ))) 726 726 724 +(% style="color:blue" %)**Downlink Command: 0x07** 727 727 728 -**Downlink Command: 0x07** 729 - 730 730 Format: Command Code (0x07) followed by 3 bytes. 731 731 732 732 The first byte is which power, the second and third bytes are the time to turn on. 733 733 734 -* Example 1: Downlink Payload: 070101F4 -> AT+3V3T=500 735 -* Example 2: Downlink Payload: 0701FFFF -> AT+3V3T=65535 736 -* Example 3: Downlink Payload: 070203E8 -> AT+5VT=1000 737 -* Example 4: Downlink Payload: 07020000 -> AT+5VT=0 738 -* Example 5: Downlink Payload: 070301F4 -> AT+12VT=500 739 -* Example 6: Downlink Payload: 07030000 -> AT+12VT=0 730 +* Example 1: Downlink Payload: 070101F4 **~-~-->** AT+3V3T=500 731 +* Example 2: Downlink Payload: 0701FFFF **~-~-->** AT+3V3T=65535 732 +* Example 3: Downlink Payload: 070203E8 **~-~-->** AT+5VT=1000 733 +* Example 4: Downlink Payload: 07020000 **~-~-->** AT+5VT=0 734 +* Example 5: Downlink Payload: 070301F4 **~-~-->** AT+12VT=500 735 +* Example 6: Downlink Payload: 07030000 **~-~-->** AT+12VT=0 740 740 741 741 742 742 ... ... @@ -743,33 +743,81 @@ 743 743 == 3.4 Set the Probe Model == 744 744 745 745 746 - **ATCommand:AT****+PROBE**742 +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. 747 747 748 -(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %) 749 -|(% style="width:157px" %)**Command Example**|(% style="width:267px" %)**Function**|**Response** 750 -|(% style="width:157px" %)AT +PROBE =?|(% style="width:267px" %)Get or Set the probe model.|((( 751 -0 744 +**AT Command: AT** **+PROBE** 752 752 746 +AT+PROBE=aabb 747 + 748 +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. 749 + 750 +When aa=01, it is the pressure mode, which converts the current into a pressure value; 751 + 752 +bb represents which type of pressure sensor it is. 753 + 754 +(A->01,B->02,C->03,D->04,E->05,F->06,G->07,H->08,I->09,J->0A,K->0B,L->0C) 755 + 756 +(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %) 757 +|**Command Example**|**Function**|**Response** 758 +|AT +PROBE =?|Get or Set the probe model.|0 753 753 OK 754 -))) 755 -|(% style="width:157px" %)AT +PROBE =0003|(% style="width:267px" %)Set water depth sensor mode, 3m type.|OK 756 -|(% style="width:157px" %)AT +PROBE =0101|(% style="width:267px" %)Set pressure transmitters mode, first type.|((( 757 -OK 760 +|AT +PROBE =0003|Set water depth sensor mode, 3m type.|OK 761 +|((( 762 +AT +PROBE =000A 758 758 759 759 760 -))) 761 -|(% style="width:157px" %)AT +PROBE =0000|(% style="width:267px" %)Initial state, no settings.|((( 765 +)))|Set water depth sensor mode, 10m type.|OK 766 +|AT +PROBE =0101|Set pressure transmitters mode, first type(A).|OK 767 +|AT +PROBE =0000|Initial state, no settings.|OK 768 + 769 +**Downlink Command: 0x08** 770 + 771 +Format: Command Code (0x08) followed by 2 bytes. 772 + 773 +* Example 1: Downlink Payload: 080003 **~-~-->** AT+PROBE=0003 774 +* Example 2: Downlink Payload: 080101 **~-~-->** AT+PROBE=0101 775 + 776 + 777 + 778 +== 3.5 Multiple collections are one uplink(Since firmware V1.1) == 779 + 780 + 781 +Added AT+STDC command to collect the voltage of VDC_INPUT multiple times and upload it at one time. 782 + 783 +(% style="color:blue" %)**AT Command: AT** **+STDC** 784 + 785 +AT+STDC=aa,bb,bb 786 + 787 +(% style="color:#037691" %)**aa:**(%%) 788 +**0:** means disable this function and use TDC to send packets. 789 +**1:** means enable this function, use the method of multiple acquisitions to send packets. 790 +(% style="color:#037691" %)**bb:**(%%) Each collection interval (s), the value is 1~~65535 791 +(% style="color:#037691" %)**cc:**(%%)** **the number of collection times, the value is 1~~120 792 + 793 +(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %) 794 +|**Command Example**|**Function**|**Response** 795 +|AT+STDC=?|Get the mode of multiple acquisitions and one uplink.|1,10,18 762 762 OK 797 +|AT+STDC=1,10,18|Set the mode of multiple acquisitions and one uplink, collect once every 10 seconds, and report after 18 times.|((( 798 +Attention:Take effect after ATZ 763 763 800 +OK 801 +))) 802 +|AT+STDC=0, 0,0|((( 803 +Use the TDC interval to send packets.(default) 804 + 764 764 806 +)))|((( 807 +Attention:Take effect after ATZ 808 + 809 +OK 765 765 ))) 766 766 767 -**Downlink Command: 0x 08**812 +(% style="color:blue" %)**Downlink Command: 0xAE** 768 768 769 -Format: Command Code (0x08) followed by 2bytes.814 +Format: Command Code (0x08) followed by 5 bytes. 770 770 771 -* Example 1: Downlink Payload: 080003 -> AT+PROBE=0003 772 -* Example 2: Downlink Payload: 080101 -> AT+PROBE=0101 816 +* Example 1: Downlink Payload: AE 01 02 58 12** ~-~-->** AT+STDC=1,600,18 773 773 774 774 775 775 ... ... @@ -780,7 +780,6 @@ 780 780 781 781 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. 782 782 783 - 784 784 The discharge curve is not linear so can’t simply use percentage to show the battery level. Below is the battery performance. 785 785 786 786 [[image:1675146710956-626.png]] ... ... @@ -804,17 +804,12 @@ 804 804 805 805 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. 806 806 807 - 808 808 Instruction to use as below: 809 809 852 +(% 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]] 810 810 811 -**Step 1:**Downlinktheup-to-date DRAGINO_Battery_Life_Prediction_Table.xlsx from:854 +(% style="color:blue" %)**Step 2:**(%%) Open it and choose 812 812 813 -[[https:~~/~~/www.dropbox.com/sh/zwex6i331j5oeq2/AACIMf9f_v2qsJ39CuMQ5Py_a?dl=0>>https://www.dropbox.com/sh/zwex6i331j5oeq2/AACIMf9f_v2qsJ39CuMQ5Py_a?dl=0]] 814 - 815 - 816 -**Step 2:** Open it and choose 817 - 818 818 * Product Model 819 819 * Uplink Interval 820 820 * Working Mode ... ... @@ -895,11 +895,11 @@ 895 895 = 9. Packing Info = 896 896 897 897 898 -**Package Includes**: 936 +(% style="color:#037691" %)**Package Includes**: 899 899 900 900 * PS-LB LoRaWAN Pressure Sensor 901 901 902 -**Dimension and weight**: 940 +(% style="color:#037691" %)**Dimension and weight**: 903 903 904 904 * Device Size: cm 905 905 * Device Weight: g ... ... @@ -912,6 +912,7 @@ 912 912 913 913 914 914 * 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. 953 + 915 915 * Provide as much information as possible regarding your enquiry (product models, accurately describe your problem and steps to replicate it etc) and send a mail to [[support@dragino.com>>url:http://../../../../../../D:%5C%E5%B8%82%E5%9C%BA%E8%B5%84%E6%96%99%5C%E8%AF%B4%E6%98%8E%E4%B9%A6%5CLoRa%5CLT%E7%B3%BB%E5%88%97%5Csupport@dragino.com]] 916 916 917 917
- 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
- image-20230225154759-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Edwin - Size
-
... ... @@ -1,0 +1,1 @@ 1 +468.9 KB - Content