Wiki source code of PS-LB -- LoRaWAN Air Water Pressure Sensor User Manual

Version 45.6 by Xiaoling on 2023/02/21 15:37

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

Wiki source code of PS-LB -- LoRaWAN Air Water Pressure Sensor User Manual

Applications

Navigation