Version 70.2 by Xiaoling on 2024/01/09 15:49

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