Changes for page PS-LB/LS -- LoRaWAN Air Water Pressure Sensor User Manual

Last modified by Xiaoling on 2025/07/10 16:21

From 130.5 to 131.1 From 146.2 to 146.3

From version 131.1

edited by Xiaoling
on 2025/04/27 10:31

Change comment: There is no comment for this version

To version 146.2

edited by Mengting Qiu
on 2025/07/08 10:57

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (2 modified, 0 added, 0 removed)
Attachments (0 modified, 7 added, 0 removed)

Details

Page properties

Author

@@ -1,1 +1,1 @@
--XWiki.Xiaoling
++XWiki.ting

Content

@@ -1,8 +1,7 @@
--(% style="text-align:center" %)
--[[image:image-20240109154731-4.png||height="546" width="769"]]
++[[image:image-20240109154731-4.png||data-xwiki-image-style-alignment="center" height="546" width="769"]]
@@ -142,7 +142,11 @@
  * Long-Term Stability: ±0.2% F.S / Year
  * Storage temperature: -30°C~~80°C
  * Operating temperature: 0°C~~50°C
--* Material: 316 stainless steels
++* Probe Material: 316 stainless steels
++* Cable model specifications：  CGYPU 5*0.2mm2
++* Usage characteristics of Cable
++1） Operating temperature：-40℃— +70℃
++2） -30℃ bending cable 15 times of outer diameter can work normally
  === 1.4.3 Wireless Differential Air Pressure Sensor ===
@@ -242,20 +242,16 @@
  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
  |=(% style="width: 167px;background-color:#4F81BD;color:white" %)Behavior on ACT|=(% style="width: 117px;background-color:#4F81BD;color:white" %)Function|=(% style="width: 226px;background-color:#4F81BD;color:white" %)Action
--|(% 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" %)(((
--
--
++|[[image:1749540420016-961.png]] 1~~3s|(% style="background-color:#f2f2f2; width:117px" %)Send an uplink|(% style="background-color:#f2f2f2; width:225px" %)(((
  If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, blue led will blink once.
  Meanwhile, BLE module will be active and user can connect via BLE to configure device.
  )))
--|(% 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" %)(((
--
--
++|[[image:1749540423574-437.png]] >3s|(% style="background-color:#f2f2f2; width:117px" %)Active Device|(% style="background-color:#f2f2f2; width:225px" %)(((
  Green led will fast blink 5 times, device will enter OTA mode for 3 seconds. And then start to JOIN LoRaWAN network.
  Green led will solidly turn on for 5 seconds after joined in network.
  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.
  )))
--|(% 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" %)Red led will solid on for 5 seconds. Means PS-LB is in Deep Sleep Mode.
++|[[image:1749540397649-875.png]] x5|(% style="background-color:#f2f2f2; width:117px" %)Deactivate Device|(% style="background-color:#f2f2f2; width:225px" %)Red led will solid on for 5 seconds. Means PS-LB is in Deep Sleep Mode.
  == 1.8 Pin Mapping ==
@@ -468,7 +468,6 @@
  PS-LB/LS 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.
--
  For example.
  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
@@ -480,6 +480,23 @@
  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.
++When connecting to current sensors sold by our company, you can convert current readings to corresponding values by simply configuring the [[AT+PROBE>>||anchor="H3.3.4SettheProbeModel"]] command. If you prefer not to configure this command on the sensor, you can uniformly handle the conversion in the payload decoder instead.
++
++**Examples for decoder implementation:**
++
++~1. For AT+PROBE=0005, add the following processing in your decoder:
++
++[[image:image-20250512144042-1.png]]
++
++[[image:image-20250512144122-2.png]]
++
++2. For AT+PROBE=0102, add the following processing in your decoder(Corresponding to the position shown in the above screenshot).
++
++bytes[i]=0x01;bytes[1+i]=0x02;
++
++bytes[2]=0x01;bytes[3]=0x02;
++
++
  === 2.3.5 0~~20mA value (IDC_IN) ===
@@ -609,43 +609,52 @@
  == 2.6 Datalog Feature (Since V1.1) ==
--When a user wants to retrieve sensor value, he can send a poll command from the IoT platform to ask the sensor to send value in the required time slot.
++Datalog Feature is to ensure IoT Server can get all sampling data from Sensor even if the LoRaWAN network is down. For each sampling, S31x-LB/LS will store the reading for future retrieving purposes.
--=== 2.6.1 Unix TimeStamp ===
++=== 2.5.1 How datalog works ===
--PS-LB uses Unix TimeStamp format based on
++PS-LB/LS will wait for ACK for every uplink, when there is no LoRaWAN network,PS-LB/LS will mark these records with non-ack messages and store the sensor data, and it will send all messages (10s interval) after the network recovery.
--[[image:image-20250401163826-3.jpeg]]
++* (((
++a) PS-LB/LS will do an ACK check for data records sending to make sure every data arrive server.
++)))
++* (((
++b) PS-LB/LS will send data in **CONFIRMED Mode**, but PS-LB/LS won't re-transmit the packet if it doesn't get ACK, it will just mark it as a NONE-ACK message. In a future uplink if PS-LB/LS gets a ACK, PS-LB/LS will consider there is a network connection and resend all NONE-ACK messages.
--Users can get this time from the link:  [[https:~~/~~/www.epochconverter.com/>>url:https://www.epochconverter.com/]] :
++
++)))
--Below is the converter example:
++=== 2.5.2 Enable Datalog ===
--[[image:image-20250401163906-4.jpeg]]
++User need to make sure below two settings are enable to use datalog;
--=== 2.6.2 Set Device Time ===
++* (% style="color:blue" %)**SYNCMOD=1(Default)**(%%) to enable sync time via LoRaWAN MAC command, click here ([[AT+SYNCMOD>>https://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/#H4.6Settimesynchronizationmethod28ThenetworkservermustsupportLoRaWANv1.0.329]]) for detailed instructions.
++* (% style="color:blue" %)**PNACKMD=1**(%%)** **to enable datalog feature, click here ([[AT+PNACKMD>>https://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/#H7.26RequesttheservertosendanACK]]) for detailed instructions.
--There are two ways to set the device's time:
++Once PS-LB/LS Joined LoRaWAN network, it will send the MAC command (DeviceTimeReq) and the server will reply with (DeviceTimeAns) to send the current time to S31x-LB/LS. If S31x-LB/LS fails to get the time from the server, S31x-LB/LS will use the internal time and wait for next time request (AT+SYNCTDC to set the time request period, default is 10 days).
--~1. Through LoRaWAN MAC Command (Default settings)
++(% style="color:red" %)**Note: LoRaWAN Server need to support LoRaWAN v1.0.3(MAC v1.0.3) or higher to support this MAC command feature, Chirpstack,TTN V3 v3 and loriot support but TTN V3 v2 doesn't support. If server doesn't support this command, it will through away uplink packet with this command, so user will lose the packet with time request for TTN V3 v2 if SYNCMOD=1.**
--Users need to set SYNCMOD=1 to enable sync time via the MAC command.
--Once CPL01 Joined the LoRaWAN network, it will send the MAC command (DeviceTimeReq) and the server will reply with (DeviceTimeAns) to send the current time to CPL01. If CPL01 fails to get the time from the server, CPL01 will use the internal time and wait for the next time request ~[[[via Device Status (FPORT=5)>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/CPL01%20LoRaWAN%20Outdoor%20PulseContact%20%20Sensor%20Manual/#H2.3.1DeviceStatus2CFPORT3D5]]].
++=== 2.6.1 Unix TimeStamp ===
--Note: LoRaWAN Server needs to support LoRaWAN v1.0.3(MAC v1.0.3) or higher to support this MAC command feature.
++PS-LB uses Unix TimeStamp format based on
-- 2. Manually Set Time
++[[image:image-20250401163826-3.jpeg]]
--Users need to set SYNCMOD=0 to manual time, otherwise, the user set time will be overwritten by the time set by the server.
++Users can get this time from the link:  [[https:~~/~~/www.epochconverter.com/>>url:https://www.epochconverter.com/]] :
++Below is the converter example:
++[[image:image-20250401163906-4.jpeg]]
++
++
  === 2.6.3 Poll sensor value ===
  Users can poll sensor values based on timestamps. Below is the downlink command.
@@ -1215,7 +1215,7 @@
  AT Command: AT +STDC
--AT+STDC=aa,bb,bb
++AT+STDC=aa,bb,cc
  aa:
 : means disable this function and use TDC to send packets.
@@ -1249,6 +1249,113 @@
  * Example 1: Downlink Payload: AE 01 02 58 12 ~-~-->   AT+STDC=1,600,18
++== 3.4 Print data entries base on page(Since v1.1.0) ==
++
++
++Feature: Print the sector data from start page to stop page (max is 416 pages).
++
++(% style="color:#4f81bd" %)**AT Command: AT+PDTA**
++
++(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:510px" %)
++|(% style="background-color:#4f81bd; color:white; width:158px" %)**Command Example**|(% style="background-color:#4f81bd; color:white; width:352px" %)**Function**
++|(% style="width:156px" %)(((
++ AT+PDTA=1,1
++Print page 1 to 1
++)))|(% style="width:311px" %)(((
++Stop Tx events when read sensor data
++
++8031000 1970/1/1 00:00:00 0 in1:low in2:low exti:low status:false vdc:0.000 idc:0.000 proble:0000 water_deep:0.000
++
++8031010 1970/1/1 00:00:00 0 in1:low in2:low exti:low status:false vdc:0.000 idc:0.000 proble:0000 water_deep:0.000
++
++8031020 1970/1/1 00:00:00 0 in1:low in2:low exti:low status:false vdc:0.000 idc:0.000 proble:0000 water_deep:0.000
++
++8031030 1970/1/1 00:00:00 0 in1:low in2:low exti:low status:false vdc:0.000 idc:0.000 proble:0000 water_deep:0.000
++
++8031040 1970/1/1 00:00:00 0 in1:low in2:low exti:low status:false vdc:0.000 idc:0.000 proble:0000 water_deep:0.000
++
++8031050 1970/1/1 00:00:00 0 in1:low in2:low exti:low status:false vdc:0.000 idc:0.000 proble:0000 water_deep:0.000
++
++8031060 1970/1/1 00:00:00 0 in1:low in2:low exti:low status:false vdc:0.000 idc:0.000 proble:0000 water_deep:0.000
++
++8031070 1970/1/1 00:00:00 0 in1:low in2:low exti:low status:false vdc:0.000 idc:0.000 proble:0000 water_deep:0.000
++
++Start Tx events
++
++
++OK
++)))
++
++(% style="color:#4f81bd" %)**Downlink Command:**
++
++No downlink commands for feature
++
++
++== 3.5 Print last few data entries(Since v1.1.0) ==
++
++
++Feature: Print the last few data entries
++
++
++(% style="color:#4f81bd" %)**AT Command: AT+PLDTA**
++
++(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:510px" %)
++|(% style="background-color:#4f81bd; color:white; width:158px" %)**Command Example**|(% style="background-color:#4f81bd; color:white; width:352px" %)**Function**
++|(% style="width:156px" %)(((
++AT+PLDTA=10
++Print last 10 entries
++)))|(% style="width:311px" %)(((
++Stop Tx events when read sensor data
++
++0001 2025/5/19 06:16:50 3246 in1:low in2:low exti:low status:false vdc:3.352 idc:0.000 proble:0000 water_deep:0.000
++
++0002 2025/5/19 06:17:50 3246 in1:low in2:low exti:low status:false vdc:3.352 idc:0.000 proble:0000 water_deep:0.000
++
++0003 2025/5/19 06:18:50 3246 in1:low in2:low exti:low status:false vdc:3.352 idc:0.000 proble:0000 water_deep:0.000
++
++0004 2025/5/19 06:19:50 3246 in1:low in2:low exti:low status:false vdc:3.352 idc:0.000 proble:0000 water_deep:0.000
++
++0005 2025/5/19 06:20:50 3246 in1:low in2:low exti:low status:false vdc:3.352 idc:0.000 proble:0000 water_deep:0.000
++
++0006 2025/5/19 06:21:50 3246 in1:low in2:low exti:low status:false vdc:3.351 idc:0.000 proble:0000 water_deep:0.000
++
++0007 2025/5/19 06:22:50 3240 in1:low in2:low exti:low status:false vdc:3.351 idc:0.000 proble:0000 water_deep:0.000
++
++0008 2025/5/19 06:26:44 3276 in1:low in2:low exti:low status:false vdc:3.385 idc:0.000 proble:0000 water_deep:0.000
++
++0009 2025/5/19 06:27:36 3246 in1:low in2:low exti:low status:false vdc:3.351 idc:0.000 proble:0000 water_deep:0.000
++
++0010 2025/5/19 06:28:36 3240 in1:low in2:low exti:low status:false vdc:3.351 idc:0.000 proble:0000 water_deep:0.000
++
++Start Tx events
++
++OK
++)))
++
++(% style="color:#4f81bd" %)**Downlink Command:**
++
++No downlink commands for feature
++
++
++== 3.6 Clear Flash Record(Since v1.1.0) ==
++
++
++Feature: Clear flash storage for data log feature.
++
++(% style="color:#4f81bd" %)**AT Command: AT+CLRDTA**
++
++(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:503px" %)
++|(% style="background-color:#4f81bd; color:white; width:157px" %)**Command Example**|(% style="background-color:#4f81bd; color:white; width:137px" %)**Function**|(% style="background-color:#4f81bd; color:white; width:209px" %)**Response**
++|(% style="width:155px" %)AT+CLRDTA |(% style="width:134px" %)Clear date record|(% style="width:209px" %)(((
++Clear all stored sensor data…
++
++OK
++)))
++
++(% style="color:#4f81bd" %)**Downlink Command: 0xA3**
++
++* Example: 0xA301        ~/~/  Same as AT+CLRDTA
++
  = 4. Battery & Power Consumption =
@@ -1313,6 +1313,30 @@
  [[image:image-20240329175044-1.png]]
++== 6.5 Cable & Probe Material Compatibility(Immersion type) ==
++
++
++Since the installation method of immersion sensors requires immersion in a liquid environment, the discussion of liquids that can be safely installed is very important.
++
++(% style="color:blue" %)**The material of the immersed part of the immersion sensor:**
++
++* **Cable Jacket**: Black polyurethane (PU) – Resistant to water, oils, and mild chemicals.
++* **Probe Material**: 316 stainless steel – Corrosion-resistant in most industrial/marine environments.
++
++(% style="color:blue" %)**Chemical Compatibility:**
++
++* **Polyurethane (PU) Cable:** Resists water, oils, fuels, and mild chemicals but may degrade with prolonged exposure to strong acids, bases, or solvents (e.g., acetone, chlorinated hydrocarbons).
++* 3**16 Stainless Steel Probe:** Suitable for water, seawater, mild acids/alkalis, and industrial fluids. Avoid highly concentrated acids (e.g., hydrochloric acid) or chlorides at high temperatures.
++
++**Chemical Resistance Chart for Polyurethane (PU) Cable**
++
++[[image:image-20250603171424-1.png||height="429" width="625"]]
++
++**Chemical Resistance Chart for 316 Stainless Steel Probe**
++
++[[image:image-20250603171503-2.png||height="350" width="616"]]
++
++
  = 7. Troubleshooting =
  == 7.1 Water Depth Always shows 0 in payload ==

1749540397649-875.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.Xiaoling

Size

...	...	@@ -1,0 +1,1 @@
	1	+1.4 KB

Content

1749540420016-961.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.Xiaoling

Size

...	...	@@ -1,0 +1,1 @@
	1	+1.9 KB

Content

1749540423574-437.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.Xiaoling

Size

...	...	@@ -1,0 +1,1 @@
	1	+1.9 KB

Content

image-20250512144042-1.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.ting

Size

...	...	@@ -1,0 +1,1 @@
	1	+471.4 KB

Content

image-20250512144122-2.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.ting

Size

...	...	@@ -1,0 +1,1 @@
	1	+572.9 KB

Content

image-20250603171424-1.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.ting

Size

...	...	@@ -1,0 +1,1 @@
	1	+38.7 KB

Content

image-20250603171503-2.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.ting

Size

...	...	@@ -1,0 +1,1 @@
	1	+33.7 KB

Content

Changes for page PS-LB/LS -- LoRaWAN Air Water Pressure Sensor User Manual

Summary

Details

Applications

Navigation