Hide last authors
Xiaoling 16.2 1 [[image:image-20230131115217-1.png]]
Xiaoling 6.2 2
3
4
5 **Table of Contents:**
6
Xiaoling 42.4 7 {{toc/}}
Xiaoling 6.2 8
9
10
Xiaoling 42.5 11
12
13
Xiaoling 16.2 14 = 1. Introduction =
Xiaoling 6.2 15
Xiaoling 9.2 16 == 1.1 What is LoRaWAN Pressure Sensor ==
17
18
Xiaoling 42.17 19 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.
Xiaoling 6.2 20
Xiaoling 42.17 21 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.
Xiaoling 6.2 22
23 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.
24
25 PS-LB supports BLE configure and wireless OTA update which make user easy to use.
26
Xiaoling 42.17 27 PS-LB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long term use up to 5 years.
Xiaoling 6.2 28
29 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.
30
Xiaoling 9.2 31 [[image:1675071321348-194.png]]
Xiaoling 6.2 32
33
34
Xiaoling 9.2 35 == 1.2 ​Features ==
Xiaoling 6.2 36
37
38 * LoRaWAN 1.0.3 Class A
39 * Ultra-low power consumption
40 * Measure air / gas or water pressure
41 * Different pressure range available
42 * Thread Installation Type or Immersion Type
43 * Monitor Battery Level
44 * Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865
45 * Support Bluetooth v5.1 and LoRaWAN remote configure
46 * Support wireless OTA update firmware
47 * Uplink on periodically
48 * Downlink to change configure
49 * 8500mAh Battery for long term use
50
Xiaoling 9.2 51 == 1.3 Specification ==
52
53
Xiaoling 42.17 54 (% style="color:#037691" %)**Micro Controller:**
Xiaoling 6.2 55
56 * MCU: 48Mhz ARM
57 * Flash: 256KB
58 * RAM: 64KB
59
Xiaoling 42.17 60 (% style="color:#037691" %)**Common DC Characteristics:**
Xiaoling 6.2 61
62 * Supply Voltage: 2.5v ~~ 3.6v
63 * Operating Temperature: -40 ~~ 85°C
64
Xiaoling 42.17 65 (% style="color:#037691" %)**LoRa Spec:**
Xiaoling 6.2 66
67 * Frequency Range,  Band 1 (HF): 862 ~~ 1020 Mhz
68 * Max +22 dBm constant RF output vs.
69 * RX sensitivity: down to -139 dBm.
70 * Excellent blocking immunity
71
Xiaoling 42.17 72 (% style="color:#037691" %)**Current Input Measuring :**
Xiaoling 6.2 73
74 * Range: 0 ~~ 20mA
75 * Accuracy: 0.02mA
76 * Resolution: 0.001mA
77
Xiaoling 42.17 78 (% style="color:#037691" %)**Voltage Input Measuring:**
Xiaoling 6.2 79
80 * Range: 0 ~~ 30v
81 * Accuracy: 0.02v
82 * Resolution: 0.001v
83
Xiaoling 42.17 84 (% style="color:#037691" %)**Battery:**
Xiaoling 6.2 85
86 * Li/SOCI2 un-chargeable battery
87 * Capacity: 8500mAh
88 * Self-Discharge: <1% / Year @ 25°C
89 * Max continuously current: 130mA
90 * Max boost current: 2A, 1 second
91
Xiaoling 42.17 92 (% style="color:#037691" %)**Power Consumption**
Xiaoling 6.2 93
94 * Sleep Mode: 5uA @ 3.3v
95 * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm
96
Xiaoling 9.2 97 == 1.4 Probe Types ==
Xiaoling 6.2 98
Xiaoling 9.2 99 === 1.4.1 Thread Installation Type ===
Xiaoling 6.2 100
101
Xiaoling 9.2 102 [[image:1675071448299-229.png]]
Xiaoling 6.2 103
Xiaoling 9.2 104 * Hersman Pressure Transmitter
105 * Measuring Range: -0.1 ~~ 0 ~~ 60MPa, see order info.
106 * Accuracy: 0.2% F.S
107 * Long-Term Stability: 0.2% F.S ±0.05%
108 * Overload 200% F.S
109 * Zero Temperature Drift: 0.03% FS/℃(≤100Kpa), 0.02%FS/℃(>100Kpa)
110 * FS Temperature Drift: 0.003% FS/℃(≤100Kpa), 0.002%FS/℃(>100Kpa)
111 * Storage temperature: -30℃~~80℃
112 * Operating temperature: -20℃~~60℃
113 * Connector Type: Various Types, see order info
Xiaoling 6.2 114
Xiaoling 9.2 115 === 1.4.2 Immersion Type ===
Xiaoling 6.2 116
117
Xiaoling 9.2 118 [[image:1675071521308-426.png]]
119
120 * Immersion Type, Probe IP Level: IP68
121 * Measuring Range: Measure range can be customized, up to 100m.
122 * Accuracy: 0.2% F.S
123 * Long-Term Stability: ±0.2% F.S / Year
124 * Overload 200% F.S
125 * Zero Temperature Drift: ±2% F.S)
126 * FS Temperature Drift: ±2% F.S
127 * Storage temperature: -30℃~~80℃
128 * Operating temperature: -40℃~~85℃
129 * Material: 316 stainless steels
130
Xiaoling 13.2 131 == 1.5 Probe Dimension ==
Xiaoling 6.2 132
133
Xiaoling 13.2 134
135
136 == 1.6 Application and Installation ==
137
138 === 1.6.1 Thread Installation Type ===
139
140
Xiaoling 42.17 141 (% style="color:blue" %)**Application:**
Xiaoling 6.2 142
143 * Hydraulic Pressure
144 * Petrochemical Industry
145 * Health and Medical
146 * Food & Beverage Processing
147 * Auto-controlling house
148 * Constant Pressure Water Supply
149 * Liquid Pressure measuring
150
151 Order the suitable thread size and install to measure the air / liquid pressure
152
Xiaoling 13.2 153 [[image:1675071670469-145.png]]
Xiaoling 6.2 154
155
Xiaoling 13.2 156 === 1.6.2 Immersion Type ===
Xiaoling 6.2 157
158
Xiaoling 42.17 159 (% style="color:blue" %)**Application:**
Xiaoling 6.2 160
161 Liquid & Water Pressure / Level detect.
162
Xiaoling 13.2 163 [[image:1675071725288-579.png]]
Xiaoling 6.2 164
165
166 The Immersion Type pressure sensor is shipped with the probe and device separately. When user got the device, below is the wiring to for connect the probe to the device.
167
168
Xiaoling 13.2 169 [[image:1675071736646-450.png]]
Xiaoling 6.2 170
171
Xiaoling 13.2 172 [[image:1675071776102-240.png]]
Xiaoling 6.2 173
174
Xiaoling 14.2 175 == 1.7 Sleep mode and working mode ==
Xiaoling 6.2 176
177
Xiaoling 42.17 178 (% 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.
Xiaoling 6.2 179
Xiaoling 42.17 180 (% 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.
Xiaoling 6.2 181
182
Xiaoling 14.2 183 == 1.8 Button & LEDs ==
Xiaoling 6.2 184
185
Xiaoling 14.2 186 [[image:1675071855856-879.png]]
Xiaoling 6.2 187
188
Xiaoling 27.2 189 (% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %)
Xiaoling 16.3 190 |(% style="width:138px" %)**Behavior on ACT**|(% style="width:100px" %)**Function**|**Action**
191 |(% style="width:138px" %)Pressing ACT between 1s < time < 3s|(% style="width:100px" %)Send an uplink|(((
Xiaoling 42.17 192 If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once.
Xiaoling 6.2 193
194 Meanwhile, BLE module will be active and user can connect via BLE to configure device.
195 )))
Xiaoling 16.3 196 |(% style="width:138px" %)Pressing ACT for more than 3s|(% style="width:100px" %)Active Device|(((
Xiaoling 42.17 197 (% 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.
Xiaoling 6.2 198
Xiaoling 42.17 199 (% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network.
Xiaoling 6.2 200
201 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.
202 )))
Xiaoling 16.3 203 |(% style="width:138px" %)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.
Xiaoling 6.2 204
Xiaoling 16.3 205
Xiaoling 15.2 206 == 1.9 Pin Mapping ==
Xiaoling 6.2 207
208
Xiaoling 15.2 209 [[image:1675072568006-274.png]]
Xiaoling 6.2 210
211
Xiaoling 16.3 212 == 1.10 BLE connection ==
Xiaoling 6.2 213
214
215 PS-LB support BLE remote configure.
216
217
218 BLE can be used to configure the parameter of sensor or see the console output from sensor. BLE will be only activate on below case:
219
220 * Press button to send an uplink
221 * Press button to active device.
222 * Device Power on or reset.
223
224 If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode.
225
226
Xiaoling 17.2 227 == 1.11 Mechanical ==
Xiaoling 6.2 228
229
230
231
Xiaoling 17.2 232 [[image:1675143884058-338.png]]
Xiaoling 6.2 233
234
Xiaoling 26.2 235 [[image:1675143899218-599.png]]
Xiaoling 6.2 236
237
Xiaoling 26.2 238 [[image:1675143909447-639.png]]
Xiaoling 6.2 239
Xiaoling 26.2 240
241 = 2. Configure PS-LB to connect to LoRaWAN network =
242
243 == 2.1 How it works ==
244
245
Xiaoling 42.17 246 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.
Xiaoling 6.2 247
248
249
Xiaoling 26.2 250 == 2.2 ​Quick guide to connect to LoRaWAN server (OTAA) ==
251
252
Xiaoling 6.2 253 Following is an example for how to join the [[TTN v3 LoRaWAN Network>>url:https://console.cloud.thethings.network/]]. Below is the network structure; we use the [[LPS8v2>>url:https://www.dragino.com/products/lora-lorawan-gateway/item/228-lps8v2.html]] as a LoRaWAN gateway in this example.
254
255
Xiaoling 26.2 256 [[image:1675144005218-297.png]]
Xiaoling 6.2 257
258
259 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.
260
261
Xiaoling 42.17 262 (% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from PS-LB.
Xiaoling 6.2 263
264 Each PS-LB is shipped with a sticker with the default device EUI as below:
265
Xiaoling 26.2 266 [[image:image-20230131134744-2.jpeg]]
Xiaoling 6.2 267
268
269
270 You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
271
272
Xiaoling 42.17 273 (% style="color:blue" %)**Register the device**
Xiaoling 6.2 274
Xiaoling 26.2 275 [[image:1675144099263-405.png]]
Xiaoling 6.2 276
277
Xiaoling 42.17 278 (% style="color:blue" %)**Add APP EUI and DEV EUI**
Xiaoling 6.2 279
Xiaoling 26.2 280 [[image:1675144117571-832.png]]
Xiaoling 6.2 281
282
Xiaoling 42.17 283 (% style="color:blue" %)**Add APP EUI in the application**
Xiaoling 6.2 284
285
Xiaoling 26.2 286 [[image:1675144143021-195.png]]
Xiaoling 6.2 287
288
Xiaoling 42.17 289 (% style="color:blue" %)**Add APP KEY**
Xiaoling 6.2 290
Xiaoling 26.2 291 [[image:1675144157838-392.png]]
Xiaoling 6.2 292
Xiaoling 42.17 293 (% style="color:blue" %)**Step 2:**(%%) Activate on PS-LB
Xiaoling 6.2 294
295
296 Press the button for 5 seconds to activate the PS-LB.
297
Xiaoling 42.17 298 (% 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.
Xiaoling 6.2 299
300 After join success, it will start to upload messages to TTN and you can see the messages in the panel.
301
302
303
Xiaoling 27.2 304 == 2.3 ​Uplink Payload ==
Xiaoling 6.2 305
306
307 Uplink payloads have two types:
308
309 * Distance Value: Use FPORT=2
310 * Other control commands: Use other FPORT fields.
311
312 The application server should parse the correct value based on FPORT settings.
313
314
Xiaoling 27.2 315 === 2.3.1 Device Status, FPORT~=5 ===
Xiaoling 6.2 316
317
318 Include device configure status. Once PS-LB Joined the network, it will uplink this message to the server.
319
320 Users can also use the downlink command(0x26 01) to ask PS-LB to resend this uplink.
321
322
Xiaoling 27.2 323 (% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %)
Xiaoling 6.2 324 |(% colspan="6" %)**Device Status (FPORT=5)**
Xiaoling 27.2 325 |(% style="width:103px" %)**Size (bytes)**|(% style="width:72px" %)**1**|**2**|**1**|**1**|**2**
326 |(% style="width:103px" %)**Value**|(% style="width:72px" %)Sensor Model|Firmware Version|Frequency Band|Sub-band|BAT
Xiaoling 6.2 327
328 Example parse in TTNv3
329
Xiaoling 27.2 330 [[image:1675144504430-490.png]]
Xiaoling 6.2 331
332
Xiaoling 42.17 333 (% style="color:#037691" %)**Sensor Model**(%%): For PS-LB, this value is 0x16
Xiaoling 6.2 334
Xiaoling 42.17 335 (% style="color:#037691" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version
Xiaoling 6.2 336
Xiaoling 42.17 337 (% style="color:#037691" %)**Frequency Band**:
Xiaoling 6.2 338
339 *0x01: EU868
340
341 *0x02: US915
342
343 *0x03: IN865
344
345 *0x04: AU915
346
347 *0x05: KZ865
348
349 *0x06: RU864
350
351 *0x07: AS923
352
353 *0x08: AS923-1
354
355 *0x09: AS923-2
356
357 *0x0a: AS923-3
358
359 *0x0b: CN470
360
361 *0x0c: EU433
362
363 *0x0d: KR920
364
365 *0x0e: MA869
366
367
Xiaoling 42.17 368 (% style="color:#037691" %)**Sub-Band**:
Xiaoling 6.2 369
370 AU915 and US915:value 0x00 ~~ 0x08
371
372 CN470: value 0x0B ~~ 0x0C
373
374 Other Bands: Always 0x00
375
376
Xiaoling 42.17 377 (% style="color:#037691" %)**Battery Info**:
Xiaoling 6.2 378
379 Check the battery voltage.
380
381 Ex1: 0x0B45 = 2885mV
382
383 Ex2: 0x0B49 = 2889mV
384
385
Xiaoling 42.11 386 === 2.3.2 Sensor value, FPORT~=2 ===
Xiaoling 6.2 387
388
389 Uplink payload includes in total 9 bytes.
390
391
Xiaoling 27.2 392 (% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %)
Xiaoling 37.2 393 |(% style="width:97px" %)(((
394 **Size(bytes)**
395 )))|(% style="width:48px" %)**2**|(% style="width:58px" %)**2**|**2**|**2**|**1**
Xiaoling 42.14 396 |(% style="width:97px" %)**Value**|(% style="width:48px" %)[[BAT>>||anchor="H2.3.3BatteryInfo"]]|(% style="width:58px" %)[[Probe Model>>||anchor="H2.3.4ProbeModel"]]|[[0 ~~~~ 20mA value>>||anchor="H2.3.507E20mAvalue28IDC_IN29"]]|[[0 ~~~~ 30v value>>||anchor="H2.3.607E30Vvalue28pinVDC_IN29"]]|[[IN1 &IN2 Interrupt  flag>>||anchor="H2.3.7IN126IN226INTpin"]]
Xiaoling 6.2 397
Xiaoling 37.2 398 [[image:1675144608950-310.png]]
Xiaoling 6.2 399
400
401
Xiaoling 37.2 402 === 2.3.3 Battery Info ===
Xiaoling 6.2 403
404
405 Check the battery voltage for PS-LB.
406
407 Ex1: 0x0B45 = 2885mV
408
409 Ex2: 0x0B49 = 2889mV
410
411
Xiaoling 37.2 412 === 2.3.4 Probe Model ===
Xiaoling 6.2 413
Xiaoling 37.2 414
Xiaoling 9.2 415 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. 
Xiaoling 6.2 416
417
418 For example.
419
Xiaoling 37.2 420 (% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %)
421 |(% style="width:111px" %)**Part Number**|(% style="width:158px" %)**Probe Used**|**0~~20mA scale**|**Example: 10mA meaning**
422 |(% style="width:111px" %)PS-LB-I3|(% style="width:158px" %)immersion type with 3 meters cable|0~~3 meters|1.5 meters pure water
423 |(% style="width:111px" %)PS-LB-I5|(% style="width:158px" %)immersion type with 5 meters cable|0~~5 meters|2.5 meters pure water
Xiaoling 6.2 424
425 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.
426
427
Xiaoling 37.2 428 === 2.3.5 0~~20mA value (IDC_IN) ===
Xiaoling 6.2 429
Xiaoling 37.2 430
Xiaoling 6.2 431 The output value from Pressure Probe, use together with Probe Model to get the pressure value or water level.
432
Xiaoling 42.17 433 (% style="color:#037691" %)**Example**:
Xiaoling 6.2 434
435 27AE(H) = 10158 (D)/1000 = 10.158mA.
436
437
Xiaoling 37.2 438 === 2.3.6 0~~30V value ( pin VDC_IN) ===
Xiaoling 6.2 439
Xiaoling 37.2 440
Xiaoling 6.2 441 Measure the voltage value. The range is 0 to 30V.
442
Xiaoling 42.17 443 (% style="color:#037691" %)**Example**:
Xiaoling 6.2 444
445 138E(H) = 5006(D)/1000= 5.006V
446
447
Xiaoling 37.2 448 === 2.3.7 IN1&IN2&INT pin ===
Xiaoling 6.2 449
Xiaoling 37.2 450
Xiaoling 6.2 451 IN1 and IN2 are used as digital input pins.
452
Xiaoling 42.17 453 (% style="color:#037691" %)**Example**:
Xiaoling 6.2 454
Xiaoling 42.17 455 09 (H): (0x09&0x08)>>3=1    IN1 pin is high level.
Xiaoling 6.2 456
Xiaoling 42.17 457 09 (H): (0x09&0x04)>>2=0    IN2 pin is low level.
Xiaoling 6.2 458
459
Xiaoling 42.17 460 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.
Xiaoling 6.2 461
Xiaoling 42.17 462 (% style="color:#037691" %)**Example:**
Xiaoling 6.2 463
Xiaoling 42.17 464 09 (H): (0x09&0x02)>>1=1    The level of the interrupt pin.
Xiaoling 6.2 465
Xiaoling 42.17 466 09 (H): 0x09&0x01=1              0x00: Normal uplink packet.
Xiaoling 6.2 467
468 0x01: Interrupt Uplink Packet.
469
470
Xiaoling 37.2 471 === 2.3.8 ​Decode payload in The Things Network ===
Xiaoling 6.2 472
473
Xiaoling 37.2 474 While using TTN network, you can add the payload format to decode the payload.
Xiaoling 6.2 475
476
Xiaoling 37.2 477 [[image:1675144839454-913.png]]
Xiaoling 6.2 478
479
Xiaoling 37.2 480 PS-LB TTN Payload Decoder: [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>url:https://github.com/dragino/dragino-end-node-decoder]]
Xiaoling 6.2 481
482
Xiaoling 37.2 483 == 2.4 Uplink Interval ==
Xiaoling 6.2 484
485
Xiaoling 37.3 486 The PS-LB by default uplink the sensor data every 20 minutes. User can change this interval by AT Command or LoRaWAN Downlink Command. See this link: [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/#H4.1ChangeUplinkInterval>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/#H4.1ChangeUplinkInterval||style="background-color: rgb(255, 255, 255);"]]
Xiaoling 6.2 487
488
Xiaoling 37.2 489 == 2.5 Show Data in DataCake IoT Server ==
Xiaoling 6.2 490
491
492 [[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:
493
494
Xiaoling 42.17 495 (% style="color:blue" %)**Step 1: **(%%)Be sure that your device is programmed and properly connected to the network at this time.
Xiaoling 6.2 496
Xiaoling 42.17 497 (% 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:
Xiaoling 6.2 498
499
Xiaoling 37.2 500 [[image:1675144951092-237.png]]
Xiaoling 6.2 501
502
Xiaoling 37.2 503 [[image:1675144960452-126.png]]
Xiaoling 6.2 504
505
Xiaoling 42.17 506 (% style="color:blue" %)**Step 3:**(%%) Create an account or log in Datacake.
Xiaoling 6.2 507
Xiaoling 42.18 508 (% style="color:blue" %)**Step 4:** (%%)Create PS-LB product.
Xiaoling 6.2 509
Xiaoling 37.2 510 [[image:1675145004465-869.png]]
Xiaoling 6.2 511
512
Xiaoling 37.2 513 [[image:1675145018212-853.png]]
Xiaoling 6.2 514
515
516
517
Xiaoling 37.2 518 [[image:1675145029119-717.png]]
Xiaoling 6.2 519
520
Xiaoling 42.17 521 (% style="color:blue" %)**Step 5: **(%%)add payload decode
Xiaoling 6.2 522
Xiaoling 37.2 523 [[image:1675145051360-659.png]]
Xiaoling 6.2 524
525
Xiaoling 37.2 526 [[image:1675145060812-420.png]]
Xiaoling 6.2 527
528
Xiaoling 37.2 529
Xiaoling 6.2 530 After added, the sensor data arrive TTN, it will also arrive and show in Datacake.
531
532
Xiaoling 37.2 533 [[image:1675145081239-376.png]]
Xiaoling 6.2 534
535
Xiaoling 37.2 536 == 2.6 Frequency Plans ==
Xiaoling 6.2 537
538
539 The PS-LB uses OTAA mode and below frequency plans by default. If user want to use it with different frequency plan, please refer the AT command sets.
540
Xiaoling 37.3 541 [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]]
Xiaoling 6.2 542
543
Xiaoling 37.4 544 == 2.7 ​Firmware Change Log ==
Xiaoling 6.2 545
546
547 **Firmware download link:**
548
549 [[https:~~/~~/www.dropbox.com/sh/gf1glloczbzz19h/AABbuYI4WY6VdAmpXo6o1V2Ka?dl=0>>url:https://www.dropbox.com/sh/gf1glloczbzz19h/AABbuYI4WY6VdAmpXo6o1V2Ka?dl=0]]
550
551
552
Xiaoling 37.4 553 = 3. Configure PS-LB via AT Command or LoRaWAN Downlink =
Xiaoling 6.2 554
Xiaoling 37.4 555
Xiaoling 6.2 556 Use can configure PS-LB via AT Command or LoRaWAN Downlink.
557
Xiaoling 42.18 558 * AT Command Connection: See [[FAQ>>||anchor="H7.FAQ"]].
Xiaoling 37.4 559 * LoRaWAN Downlink instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
Xiaoling 6.2 560
561 There are two kinds of commands to configure PS-LB, they are:
562
Xiaoling 42.18 563 * **(% style="color:#037691" %)General Commands**.
Xiaoling 6.2 564
565 These commands are to configure:
566
567 * General system settings like: uplink interval.
568 * LoRaWAN protocol & radio related command.
569
570 They are same for all Dragino Device which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki:
571
Xiaoling 37.5 572 [[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/]]
Xiaoling 6.2 573
574
Xiaoling 42.18 575 * **(% style="color:#037691" %)Commands special design for PS-LB**
Xiaoling 6.2 576
577 These commands only valid for PS-LB, as below:
578
579
Xiaoling 37.5 580 == 3.1 Set Transmit Interval Time ==
Xiaoling 6.2 581
Xiaoling 37.5 582
Xiaoling 6.2 583 Feature: Change LoRaWAN End Node Transmit Interval.
584
585 **AT Command: AT+TDC**
586
Xiaoling 37.5 587 (% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %)
Xiaoling 6.2 588 |**Command Example**|**Function**|**Response**
589 |AT+TDC=?|Show current transmit Interval|(((
590 30000
591
592 OK
593
594 the interval is 30000ms = 30s
595 )))
596 |AT+TDC=60000|Set Transmit Interval|(((
597 OK
598
599 Set transmit interval to 60000ms = 60 seconds
600 )))
601
602 **Downlink Command: 0x01**
603
604 Format: Command Code (0x01) followed by 3 bytes time value.
605
606 If the downlink payload=0100003C, it means set the END Node’s Transmit Interval to 0x00003C=60(S), while type code is 01.
607
608 * Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds
609 * Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
610
Xiaoling 37.5 611 == 3.2 Set Interrupt Mode ==
Xiaoling 6.2 612
Xiaoling 37.5 613
Xiaoling 6.2 614 Feature, Set Interrupt mode for GPIO_EXIT.
615
616 **AT Command: AT+INTMOD**
617
Xiaoling 37.5 618 (% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %)
Xiaoling 6.2 619 |**Command Example**|**Function**|**Response**
620 |AT+INTMOD=?|Show current interrupt mode|(((
621 0
622
623 OK
624
625 the mode is 0 = No interruption
626 )))
627 |AT+INTMOD=2|(((
628 Set Transmit Interval
629
Xiaoling 37.5 630 ~1. (Disable Interrupt),
631
632 2. (Trigger by rising and falling edge),
633
634 3. (Trigger by falling edge)
635
636 4. (Trigger by rising edge)
Xiaoling 6.2 637 )))|OK
638
639 **Downlink Command: 0x06**
640
641 Format: Command Code (0x06) followed by 3 bytes.
642
643 This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
644
645 * Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode
646 * Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger
647
648
Xiaoling 37.5 649 == 3.3 Set the output time ==
650
651
Xiaoling 6.2 652 Feature, Control the output 3V3 , 5V or 12V.
653
654 **AT Command: AT+3V3T**
655
Xiaoling 37.5 656 (% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %)
657 |(% style="width:156px" %)**Command Example**|(% style="width:236px" %)**Function**|(% style="width:117px" %)**Response**
658 |(% style="width:156px" %)AT+3V3T=?|(% style="width:236px" %)Show 3V3 open time.|(% style="width:117px" %)(((
Xiaoling 6.2 659 0
660
661 OK
662 )))
Xiaoling 37.5 663 |(% style="width:156px" %)AT+3V3T=0|(% style="width:236px" %)Normally open 3V3 power supply.|(% style="width:117px" %)(((
Xiaoling 6.2 664 OK
665
666 default setting
667 )))
Xiaoling 37.5 668 |(% style="width:156px" %)AT+3V3T=1000|(% style="width:236px" %)Close after a delay of 1000 milliseconds.|(% style="width:117px" %)(((
Xiaoling 6.2 669 OK
670
671
672 )))
Xiaoling 37.5 673 |(% style="width:156px" %)AT+3V3T=65535|(% style="width:236px" %)Normally closed 3V3 power supply.|(% style="width:117px" %)(((
Xiaoling 6.2 674 OK
675
676
677 )))
678
679 **AT Command: AT+5VT**
680
Xiaoling 37.5 681 (% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %)
682 |(% style="width:158px" %)**Command Example**|(% style="width:232px" %)**Function**|(% style="width:119px" %)**Response**
683 |(% style="width:158px" %)AT+5VT=?|(% style="width:232px" %)Show 5V open time.|(% style="width:119px" %)(((
Xiaoling 6.2 684 0
685
686 OK
687 )))
Xiaoling 37.5 688 |(% style="width:158px" %)AT+5VT=0|(% style="width:232px" %)Normally closed 5V power supply.|(% style="width:119px" %)(((
Xiaoling 6.2 689 OK
690
691 default setting
692 )))
Xiaoling 37.5 693 |(% style="width:158px" %)AT+5VT=1000|(% style="width:232px" %)Close after a delay of 1000 milliseconds.|(% style="width:119px" %)(((
Xiaoling 6.2 694 OK
695
696
697 )))
Xiaoling 37.5 698 |(% style="width:158px" %)AT+5VT=65535|(% style="width:232px" %)Normally open 5V power supply.|(% style="width:119px" %)(((
Xiaoling 6.2 699 OK
700
701
702 )))
703
704 **AT Command: AT+12VT**
705
Xiaoling 37.5 706 (% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %)
707 |(% style="width:156px" %)**Command Example**|(% style="width:268px" %)**Function**|**Response**
708 |(% style="width:156px" %)AT+12VT=?|(% style="width:268px" %)Show 12V open time.|(((
Xiaoling 6.2 709 0
710
711 OK
712 )))
Xiaoling 37.5 713 |(% style="width:156px" %)AT+12VT=0|(% style="width:268px" %)Normally closed 12V power supply.|OK
714 |(% style="width:156px" %)AT+12VT=500|(% style="width:268px" %)Close after a delay of 500 milliseconds.|(((
Xiaoling 6.2 715 OK
716
717
718 )))
719
720 **Downlink Command: 0x07**
721
722 Format: Command Code (0x07) followed by 3 bytes.
723
724 The first byte is which power, the second and third bytes are the time to turn on.
725
726 * Example 1: Downlink Payload: 070101F4  -> AT+3V3T=500
727 * Example 2: Downlink Payload: 0701FFFF   -> AT+3V3T=65535
728 * Example 3: Downlink Payload: 070203E8  -> AT+5VT=1000
729 * Example 4: Downlink Payload: 07020000  -> AT+5VT=0
730 * Example 5: Downlink Payload: 070301F4  -> AT+12VT=500
731 * Example 6: Downlink Payload: 07030000  -> AT+12VT=0
732
733
Xiaoling 37.5 734 == 3.4 Set the Probe Model ==
735
736
Xiaoling 6.2 737 **AT Command: AT** **+PROBE**
738
Xiaoling 37.5 739 (% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %)
740 |(% style="width:157px" %)**Command Example**|(% style="width:267px" %)**Function**|**Response**
741 |(% style="width:157px" %)AT +PROBE =?|(% style="width:267px" %)Get or Set the probe model.|(((
Xiaoling 6.2 742 0
743
744 OK
745 )))
Xiaoling 37.5 746 |(% style="width:157px" %)AT +PROBE =0003|(% style="width:267px" %)Set water depth sensor mode, 3m type.|OK
747 |(% style="width:157px" %)AT +PROBE =0101|(% style="width:267px" %)Set pressure transmitters mode, first type.|(((
Xiaoling 6.2 748 OK
749
750
751 )))
Xiaoling 37.5 752 |(% style="width:157px" %)AT +PROBE =0000|(% style="width:267px" %)Initial state, no settings.|(((
Xiaoling 6.2 753 OK
754
755
756 )))
757
758 **Downlink Command: 0x08**
759
760 Format: Command Code (0x08) followed by 2 bytes.
761
762 * Example 1: Downlink Payload: 080003  -> AT+PROBE=0003
763 * Example 2: Downlink Payload: 080101  -> AT+PROBE=0101
764
765
Xiaoling 37.6 766 = 4. Battery & how to replace =
Xiaoling 6.2 767
Xiaoling 37.6 768 == 4.1 Battery Type ==
769
770
Xiaoling 38.2 771 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.
Xiaoling 6.2 772
773
774 The discharge curve is not linear so can’t simply use percentage to show the battery level. Below is the battery performance.
775
Xiaoling 38.2 776 [[image:1675146710956-626.png]]
Xiaoling 6.2 777
778
779 Minimum Working Voltage for the PS-LB:
780
781 PS-LB:  2.45v ~~ 3.6v
782
783
Xiaoling 38.2 784 == 4.2 Replace Battery ==
Xiaoling 6.2 785
Xiaoling 38.2 786
Xiaoling 6.2 787 Any battery with range 2.45 ~~ 3.6v can be a replacement. We recommend to use Li-SOCl2 Battery.
788
789 And make sure the positive and negative pins match.
790
791
Xiaoling 40.2 792 == 4.3 Power Consumption Analyze ==
Xiaoling 6.2 793
794
795 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.
796
797
798 Instruction to use as below:
799
800
Xiaoling 40.2 801 **Step 1:** Downlink the up-to-date DRAGINO_Battery_Life_Prediction_Table.xlsx from:
Xiaoling 6.2 802
Xiaoling 40.2 803 [[https:~~/~~/www.dropbox.com/sh/zwex6i331j5oeq2/AACIMf9f_v2qsJ39CuMQ5Py_a?dl=0>>https://www.dropbox.com/sh/zwex6i331j5oeq2/AACIMf9f_v2qsJ39CuMQ5Py_a?dl=0]]
Xiaoling 6.2 804
805
Xiaoling 40.2 806 **Step 2:** Open it and choose
Xiaoling 6.2 807
808 * Product Model
809 * Uplink Interval
810 * Working Mode
811
812 And the Life expectation in difference case will be shown on the right.
813
Xiaoling 40.2 814 [[image:1675146895108-304.png]]
Xiaoling 6.2 815
816
817 The battery related documents as below:
818
Xiaoling 40.2 819 * [[Battery Dimension>>https://www.dropbox.com/s/ox5g9njwjle7aw3/LSN50-Battery-Dimension.pdf?dl=0]],
820 * [[Lithium-Thionyl Chloride Battery datasheet, Tech Spec>>https://www.dropbox.com/sh/d4oyfnp8o94180o/AABQewCNSh5GPeQH86UxRgQQa?dl=0]]
821 * [[Lithium-ion Battery-Capacitor datasheet>>https://www.dropbox.com/s/791gjes2lcbfi1p/SPC_1520_datasheet.jpg?dl=0]], [[Tech Spec>>https://www.dropbox.com/s/4pkepr9qqqvtzf2/SPC1520%20Technical%20Specification20171123.pdf?dl=0]]
Xiaoling 6.2 822
Xiaoling 40.2 823 [[image:image-20230131145708-3.png]]
Xiaoling 6.2 824
825
Xiaoling 40.4 826 === 4.3.1 ​Battery Note ===
Xiaoling 6.2 827
828
829 The Li-SICO battery is designed for small current / long period application. It is not good to use a high current, short period transmit method. The recommended minimum period for use of this battery is 5 minutes. If you use a shorter period time to transmit LoRa, then the battery life may be decreased.
830
831
Xiaoling 40.4 832 === 4.3.2 Replace the battery ===
Xiaoling 6.2 833
834
Xiaoling 40.4 835 You can change the battery in the PS-LB.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.
Xiaoling 6.2 836
Xiaoling 40.4 837 The default battery pack of PS-LB 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)
Xiaoling 6.2 838
839
Xiaoling 40.5 840 = 5. Remote Configure device =
Xiaoling 6.2 841
Xiaoling 42.3 842 == 5.1 Connect via BLE ==
Xiaoling 6.2 843
844
Xiaoling 42.2 845 Please see this instruction for how to configure via BLE: [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/>>url:http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]]
Xiaoling 42.3 846
847
Xiaoling 42.2 848 == 5.2 AT Command Set ==
Xiaoling 6.2 849
850
851
Xiaoling 42.2 852 = 6. OTA firmware update =
Xiaoling 6.2 853
854
Xiaoling 42.2 855 Please see this link for how to do OTA firmware update: [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/]]
Xiaoling 6.2 856
857
Xiaoling 42.2 858 = 7. FAQ =
Xiaoling 6.2 859
Xiaoling 42.3 860 == 7.1 How to use AT Command to access device? ==
Xiaoling 6.2 861
862
Xiaoling 42.2 863 See: [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H1.LoRaSTv4baseHardware>>url:http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H1.LoRaSTv4baseHardware]]
Xiaoling 6.2 864
865
Xiaoling 42.2 866 == 7.2 How to update firmware via UART port? ==
Xiaoling 6.2 867
868
Xiaoling 42.2 869 See: [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H1.LoRaSTv4baseHardware>>url:http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H1.LoRaSTv4baseHardware]]
Xiaoling 6.2 870
871
Xiaoling 42.2 872 == 7.3 How to change the LoRa Frequency Bands/Region? ==
Xiaoling 6.2 873
874
Xiaoling 42.3 875 You can follow the instructions for [[how to upgrade image>>doc:Main.Firmware Upgrade Instruction for STM32 base products.WebHome]].
Xiaoling 6.2 876 When downloading the images, choose the required image file for download. ​
877
878
Xiaoling 42.2 879 = 8. Order Info =
Xiaoling 6.2 880
881
Xiaoling 42.2 882 [[image:image-20230131153105-4.png]]
Xiaoling 6.2 883
884
Xiaoling 42.2 885 = 9. ​Packing Info =
Xiaoling 6.2 886
887
888 **Package Includes**:
889
890 * PS-LB LoRaWAN Pressure Sensor
891
892 **Dimension and weight**:
893
894 * Device Size: cm
895 * Device Weight: g
896 * Package Size / pcs : cm
897 * Weight / pcs : g
898
899
Xiaoling 42.2 900 = 10. Support =
Xiaoling 6.2 901
Xiaoling 42.2 902
Xiaoling 6.2 903 * 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.
Xiaoling 42.2 904 * 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]]
Xiaoling 6.2 905
Xiaoling 40.4 906
Copyright ©2010-2024 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0