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

Applications

Navigation

Copyright ©2010-2024 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0