Changes for page DS20L -- LoRaWAN Smart Distance Detector User Manual 01

Summary

• Page properties (2 modified, 0 added, 0 removed)
• Attachments (0 modified, 0 added, 8 removed)
  • image-20230530111051-3.png
  • image-20230530111412-4.png
  • image-20230530135919-1.png
  • image-20230530135929-2.png
  • image-20230530140053-1.jpeg
  • image-20230612170349-1.png
  • image-20230612170943-2.png
  • image-20230612171032-3.png

Details

Page properties

Title

...	...	@@ -1,1 +1,1 @@
1		-DDS75-LB -- LoRaWAN Distance Detection Sensor User Manual
	1	+CPL03-LB -- LoRaWAN Pulse/Contact Sensor User Manual

Content

...	...	@@ -1,9 +1,7 @@
1	1	(% style="text-align:center" %)
2		-[[image:image-20230612170349-1.png||height="656" width="656"]]
	2	+[[image:image-20230530084608-2.jpeg||height="707" width="707"]]
3	3
4	4
5		-
6		-
7	7	**Table of Contents：**
8	8
9	9	{{toc/}}
...	...	@@ -15,76 +15,64 @@
15	15
16	16	= 1. Introduction =
17	17
18		-== 1.1 What is LoRaWAN Distance Detection Sensor ==
	16	+== 1.1 What is CPL03-LB LoRaWAN Pulse/Contact Sensor ==
19	19
20	20
21		-The Dragino DDS75-LB is a (% style="color:blue" %)** LoRaWAN Distance Detection Sensor**(%%) for Internet of Things solution. It is used to measure the distance between the sensor and a flat object. The distance detection sensor is a module that uses (% style="color:blue" %)** ultrasonic sensing technology**(%%) for (% style="color:blue" %)**distance measurement**(%%), and (% style="color:blue" %)** temperature compensation**(%%) is performed internally to improve the reliability of data. The DDS75-LB can be applied to scenarios such as horizontal distance measurement, liquid level measurement, parking management system, object proximity and presence detection, intelligent trash can management system, robot obstacle avoidance, automatic control, sewer, bottom water level monitoring, etc.
	19	+The Dragino CPL03-LB is a (% style="color:blue" %)**LoRaWAN Contact Sensor**(%%) for Internet of Things solution. It detects dry contact status, open time, open counts, and then upload to IoT server via LoRaWAN wireless protocol.
22	22
23		-It detects the distance(% style="color:blue" %)**  between the measured object and the sensor**(%%), and uploads the value via wireless to LoRaWAN IoT Server.
	21	+The CPL03-LB will send periodically data every day as well as for each dry contact action. It also counts the contact open times and calculate last open duration. User can also disable the uplink for each open/close event, instead, device can count each open event and uplink periodically.
24	24
25		-The LoRa wireless technology used in SW3L-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.
	23	+The temperature & humidity sensor used in CPL03-LB is SHT31, which is fully calibrated, linearized, and temperature compensated digital output from Sensirion, it provides a strong reliability and long-term stability. The SHT31 is fixed in a (% style="color:blue" %)**waterproof anti-condensation casing**(%%) for long term use.
26	26
27		-SW3L-LB (% style="color:blue" %)**supports BLE configure**(%%) and (% style="color:blue" %)**wireless OTA update**(%%) which make user easy to use.
	25	+The LoRa wireless technology used in CPL03-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.
28	28
29		-SW3L-LB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long term use up to 5 years.
	27	+CPL03-LB (% style="color:blue" %)**supports open alarm feature**(%%), user can set open alarm for instant notice. CPL03-LB (% style="color:blue" %)**supports Datalog feature**, it can save the data when there is no LoRaWAN network and uplink when network recover.
30	30
31		-Each SW3L-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.
	29	+CPL03-LB (% style="color:blue" %)**supports BLE configure**(%%) and (% style="color:blue" %)**wireless OTA update**(%%) which make user easy to use.
32	32
33		-[[image:image-20230612170943-2.png||height="525" width="912"]]
	31	+CPL03-LB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long term use up to 5 years.
34	34
	33	+Each CPL03-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.
35	35
	35	+
36	36	== 1.2 ​Features ==
37	37
38	38
39	39	* LoRaWAN 1.0.3 Class A
40		-* Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865
41	41	* Ultra-low power consumption
42		-* Distance Detection by Ultrasonic technology
43		-* Flat object range 280mm - 7500mm
44		-* Accuracy: ±(1cm+S*0.3%) (S: Distance)
45		-* Cable Length : 25cm
	41	+* External 3 meters SHT31 probe (For S31-LB)
	42	+* Measure range -55°C ~~ 125°C
	43	+* Temperature & Humidity alarm
	44	+* Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865
46	46	* Support Bluetooth v5.1 and LoRaWAN remote configure
47	47	* Support wireless OTA update firmware
48		-* AT Commands to change parameters
	47	+* Uplink on periodically
49	49	* Downlink to change configure
50		-* IP66 Waterproof Enclosure
51	51	* 8500mAh Battery for long term use
52	52
	51	+
53	53	== 1.3 Specification ==
54	54
55	55
56		-(% style="color:#037691" %)**Rated environmental conditions:**
	55	+(% style="color:#037691" %)**Common DC Characteristics:**
57	57
58		-(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:500px" %)
59		-|(% style="background-color:#d9e2f3; color:#0070c0; width:163px" %)**Item**|(% style="background-color:#d9e2f3; color:#0070c0; width:90px" %)(((
60		-**Minimum value**
61		-)))|(% style="background-color:#d9e2f3; color:#0070c0; width:70px" %)(((
62		-**Typical value**
63		-)))|(% style="background-color:#d9e2f3; color:#0070c0; width:87px" %)(((
64		-**Maximum value**
65		-)))|(% style="background-color:#d9e2f3; color:#0070c0; width:40px" %)**Unit**|(% style="background-color:#d9e2f3; color:#0070c0; width:50px" %)**Remarks**
66		-|(% style="width:174px" %)Storage temperature|(% style="width:86px" %)-25|(% style="width:66px" %)25|(% style="width:90px" %)80|(% style="width:48px" %)℃|(% style="width:203px" %)
67		-|(% style="width:174px" %)Storage humidity|(% style="width:86px" %) |(% style="width:66px" %)65%|(% style="width:90px" %)90%|(% style="width:48px" %)RH|(% style="width:203px" %)(1)
68		-|(% style="width:174px" %)Operating temperature|(% style="width:86px" %)-15|(% style="width:66px" %)25|(% style="width:90px" %)60|(% style="width:48px" %)℃|(% style="width:203px" %)
69		-|(% style="width:174px" %)Working humidity|(% style="width:86px" %)(((
70		-
	57	+* Supply Voltage: built in 8500mAh Li-SOCI2 battery , 2.5v ~~ 3.6v
	58	+* Operating Temperature: -40 ~~ 85°C
71	71
72		-
73		-)))|(% style="width:66px" %)65%|(% style="width:90px" %)80%|(% style="width:48px" %)RH|(% style="width:203px" %)(1)
	60	+(% style="color:#037691" %)**Temperature Sensor:**
74	74
75		-(((
76		-**Remarks: (1) a. When the ambient temperature is 0-39 ℃, the maximum humidity is 90% (non-condensing);       **
	62	+* Range: -40 to + 80°C
	63	+* Accuracy: ±0.2 @ 0-90 °C
	64	+* Resolution: 0.1°C
	65	+* Long Term Shift: <0.03 °C/yr
77	77
78		-**~ b. When the ambient temperature is 40-50 ℃, the highest humidity is the highest humidity in the natural world at the current temperature (no condensation)**
	67	+(% style="color:#037691" %)**Humidity Sensor: **
79	79
80		-
81		-)))
	69	+* Range: 0 ~~ 99.9% RH
	70	+* Accuracy: ± 2%RH ( 0 ~~ 100%RH)
	71	+* Resolution: 0.01% RH
	72	+* Long Term Shift: <0.25 %RH/yr
82	82
83		-(% style="color:#037691" %)**Common DC Characteristics:**
84		-
85		-* Supply Voltage: built in 8500mAh Li-SOCI2 battery , 2.5v ~~ 3.6v
86		-* Operating Temperature: -40 ~~ 85°C
87		-
88	88	(% style="color:#037691" %)**LoRa Spec:**
89	89
90	90	* Frequency Range,  Band 1 (HF): 862 ~~ 1020 Mhz
...	...	@@ -105,41 +105,16 @@
105	105	* Sleep Mode: 5uA @ 3.3v
106	106	* LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm
107	107
108		-== 1.4 Effective measurement range Reference beam pattern ==
109	109
	95	+== 1.4 Sleep mode and working mode ==
110	110
111		-**~1. The tested object is a white cylindrical tube made of PVC, with a height of 100cm and a diameter of 7.5cm.**
112	112
113		-[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS75%20-%20LoRaWAN%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654852253176-749.png?rev=1.1||alt="1654852253176-749.png"]]
114		-
115		-
116		-**2. The object to be tested is a "corrugated cardboard box" perpendicular to the central axis of 0 °, and the length * width is 60cm * 50cm.**
117		-
118		-[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS75%20-%20LoRaWAN%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654852175653-550.png?rev=1.1||alt="1654852175653-550.png"]]
119		-
120		-
121		-== 1.5 Applications ==
122		-
123		-
124		-* Horizontal distance measurement
125		-* Liquid level measurement
126		-* Parking management system
127		-* Object proximity and presence detection
128		-* Intelligent trash can management system
129		-* Robot obstacle avoidance
130		-* Automatic control
131		-* Sewer
132		-* Bottom water level monitoring
133		-
134		-== 1.6 Sleep mode and working mode ==
135		-
136		-
137	137	(% 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.
138	138
139	139	(% 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.
140	140
141	141
142		-== 1.7 Button & LEDs ==
	103	+== 1.5 Button & LEDs ==
143	143
144	144
145	145	[[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675071855856-879.png]]
...	...	@@ -158,12 +158,13 @@
158	158	)))
159	159	|(% 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 device is in Deep Sleep Mode.
160	160
161		-== 1.8 BLE connection ==
162	162
	123	+== 1.6 BLE connection ==
163	163
164		-DDS75-LB support BLE remote configure.
165	165
	126	+S31x-LB support BLE remote configure.
166	166
	128	+
167	167	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:
168	168
169	169	* Press button to send an uplink
...	...	@@ -173,45 +173,56 @@
173	173	If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode.
174	174
175	175
176		-== 1.9 Pin Definitions ==
	138	+== 1.7 Pin Definitions ==
177	177
178	178	[[image:image-20230523174230-1.png]]
179	179
180	180
181		-== ==
	143	+== 1.8 Hardware Variant ==
182	182
183		-== 2.10 Mechanical ==
184	184
	146	+(% border="1" cellspacing="5" style="width:472px" %)
	147	+|=(% style="width: 102px;background-color:#D9E2F3;color:#0070C0" %)Model|=(% style="width: 190px;background-color:#D9E2F3;color:#0070C0" %)Photo|=(% style="width: 187px; background-color:#D9E2F3;color:#0070C0" %)Probe Info
	148	+|(% style="width:102px" %)(((
	149	+S31-LB
	150	+)))|(% style="width:190px" %)[[image:image-20230527093214-2.jpeg]]|(% style="width:187px" %)(((
	151	+1 x SHT31 Probe
185	185
186		-[[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675143884058-338.png]]
	153	+Cable Length : 2 meters
187	187
	155	+
	156	+)))
	157	+|(% style="width:102px" %)(((
	158	+S31B-LB
	159	+)))|(% style="width:190px" %)[[image:image-20230527093155-1.jpeg]]|(% style="width:187px" %)(((
	160	+1 x SHT31 Probe
188	188
189		-[[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675143899218-599.png]]
	162	+Installed in device.
	163	+)))
190	190
	165	+(% style="display:none" %)
191	191
192		-[[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675143909447-639.png]]
193	193
194	194
195		-**Probe Mechanical:**
	169	+== 1.9 Mechanical ==
196	196
197	197
198		-[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS75%20-%20LoRaWAN%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/image-20220610172003-1.png?rev=1.1||alt="image-20220610172003-1.png"]]
	172	+[[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675143884058-338.png]]
199	199
200	200
201		-[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS75%20-%20LoRaWAN%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/image-20220610172003-2.png?rev=1.1||alt="image-20220610172003-2.png"]]
	175	+[[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675143899218-599.png]]
202	202
203	203
204		-[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS75%20-%20LoRaWAN%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/image-20220610172003-2.png?rev=1.1||alt="image-20220610172003-2.png"]]
	178	+[[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675143909447-639.png]]
205	205
206	206
207		-= 2. Configure DDS75-LB to connect to LoRaWAN network =
	181	+= 2. Configure S31x-LB to connect to LoRaWAN network =
208	208
209	209	== 2.1 How it works ==
210	210
211	211
212		-The DDS75-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 press the button to activate the DDS75-LB. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 20 minutes.
	186	+The S31x-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 press the button to activate the S31x-LB. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 20 minutes.
213	213
214		-(% style="display:none" %) (%%)
215	215
216	216	== 2.2 ​Quick guide to connect to LoRaWAN server (OTAA) ==
217	217
...	...	@@ -218,15 +218,13 @@
218	218
219	219	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.
220	220
221		-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.
	194	+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.
222	222
223		-[[image:image-20230612171032-3.png||height="492" width="855"]](% style="display:none" %)
224	224
	197	+(% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from S31x-LB.
225	225
226		-(% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from DDS75-LB.
	199	+Each S31x-LB is shipped with a sticker with the default device EUI as below:
227	227
228		-Each DDS75-LB is shipped with a sticker with the default device EUI as below:
229		-
230	230	[[image:image-20230426084152-1.png||alt="图片-20230426084152-1.png" height="233" width="502"]]
231	231
232	232
...	...	@@ -254,10 +254,10 @@
254	254	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50v2-S31-S31B%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20User%20Manual/WebHome/image-20220611161308-6.png?width=744&height=485&rev=1.1||alt="图片-20220611161308-6.png"]]
255	255
256	256
257		-(% style="color:blue" %)**Step 2:**(%%) Activate on DDS75-LB
	228	+(% style="color:blue" %)**Step 2:**(%%) Activate on S31x-LB
258	258
259	259
260		-Press the button for 5 seconds to activate the DDS75-LB.
	231	+Press the button for 5 seconds to activate the S31x-LB.
261	261
262	262	(% 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.
263	263
...	...	@@ -264,178 +264,174 @@
264	264	After join success, it will start to upload messages to TTN and you can see the messages in the panel.
265	265
266	266
267		-== 2.3  ​Uplink Payload ==
	238	+== 2.3 ​Uplink Payload ==
268	268
	240	+=== 2.3.1 Device Status, FPORT~=5 ===
269	269
270		-(((
271		-(((
272		-DDS75-LB will uplink payload via LoRaWAN with below payload format:
273		-)))
274	274
275		-(((
276		-Uplink payload includes in total 4 bytes.
277		-Payload for firmware version v1.1.4. . Before v1.1.3, there is on two fields: BAT and Distance
278		-)))
279		-)))
	243	+Users can use the downlink command(**0x26 01**) to ask S31x-LB to send device configure detail, include device configure status. S31x-LB will uplink a payload via FPort=5 to server.
280	280
281		-(((
282		-
283		-)))
	245	+The Payload format is as below.
284	284
285		-(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %)
286		-|=(% style="width: 62.5px;background-color:#D9E2F3;color:#0070C0" %)(((
287		-**Size(bytes)**
288		-)))|=(% style="width: 62.5px;background-color:#D9E2F3;color:#0070C0" %)**2**|=(% style="background-color:#D9E2F3;color:#0070C0" %)**2**|=(% style="background-color:#D9E2F3;color:#0070C0" %)1|=(% style="background-color:#D9E2F3;color:#0070C0" %)2|=(% style="background-color:#D9E2F3;color:#0070C0" %)**1**
289		-|(% style="width:62.5px" %)**Value**|(% style="width:62.5px" %)[[BAT>>||anchor="H2.3.1A0BatteryInfo"]]|(((
290		-[[Distance>>||anchor="H2.3.2A0Distance"]]
291		-(unit: mm)
292		-)))|[[Digital Interrupt (Optional)>>||anchor="H2.3.3A0InterruptPin"]]|(((
293		-[[Temperature (Optional )>>||anchor="H2.3.4A0DS18B20Temperaturesensor"]]
294		-)))|[[Sensor Flag>>||anchor="H2.3.5A0SensorFlag"]]
295	295
296		-[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS75%20-%20LoRaWAN%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654850511545-399.png?rev=1.1||alt="1654850511545-399.png"]]
	248	+(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
	249	+|(% colspan="6" style="background-color:#d9e2f3; color:#0070c0" %)**Device Status (FPORT=5)**
	250	+|(% style="width:103px" %)**Size (bytes)**|(% style="width:72px" %)**1**|**2**|(% style="width:91px" %)**1**|(% style="width:86px" %)**1**|(% style="width:44px" %)**2**
	251	+|(% 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
297	297
	253	+Example parse in TTNv3
298	298
299		-=== 2.3.1  Battery Info ===
	255	+[[image:image-20230524144422-1.png||height="174" width="1080"]]
300	300
301	301
302		-Check the battery voltage for DDS75-LB.
	258	+(% style="color:#037691" %)**Sensor Model**(%%): For S31x-LB, this value is 0x0A
303	303
304		-Ex1: 0x0B45 = 2885mV
	260	+(% style="color:#037691" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version
305	305
306		-Ex2: 0x0B49 = 2889mV
	262	+(% style="color:#037691" %)**Frequency Band**:
307	307
	264	+*0x01: EU868
308	308
309		-=== 2.3.2  Distance ===
	266	+*0x02: US915
310	310
	268	+*0x03: IN865
311	311
312		-(((
313		-Get the distance. Flat object range 280mm - 7500mm.
314		-)))
	270	+*0x04: AU915
315	315
316		-(((
317		-For example, if the data you get from the register is 0x0B 0x05, the distance between the sensor and the measured object is(% style="color:#4472c4" %)** **
	272	+*0x05: KZ865
318	318
319		-(% style="color:#4472c4" %)**0B05(H) = 2821 (D) = 2821 mm.**
320		-)))
	274	+*0x06: RU864
321	321
	276	+*0x07: AS923
322	322
323		-* If the sensor value is 0x0000, it means system doesn't detect ultrasonic sensor.
324		-* If the sensor value lower than 0x0118 (280mm), the sensor value will be invalid. Since v1.1.4, all value lower than 280mm will be set to 0x0014(20mm) which means the value is invalid.
	278	+*0x08: AS923-1
325	325
326		-=== 2.3.3  Interrupt Pin ===
	280	+*0x09: AS923-2
327	327
	282	+*0x0a: AS923-3
328	328
329		-This data field shows if this packet is generated by interrupt or not. [[Click here>>||anchor="H3.3A0SetInterruptMode"]] for the hardware and software set up.
	284	+*0x0b: CN470
330	330
331		-**Example:**
	286	+*0x0c: EU433
332	332
333		-0x00: Normal uplink packet.
	288	+*0x0d: KR920
334	334
335		-0x01: Interrupt Uplink Packet.
	290	+*0x0e: MA869
336	336
337	337
338		-=== 2.3.4  DS18B20 Temperature sensor ===
	293	+(% style="color:#037691" %)**Sub-Band**:
339	339
	295	+AU915 and US915:value 0x00 ~~ 0x08
340	340
341		-This is optional, user can connect external DS18B20 sensor to the +3.3v, 1-wire and GND pin . and this field will report temperature.
	297	+CN470: value 0x0B ~~ 0x0C
342	342
343		-**Example**:
	299	+Other Bands: Always 0x00
344	344
345		-If payload is: 0105H:  (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree
346	346
347		-If payload is: FF3FH :  (FF3F & FC00 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
	302	+(% style="color:#037691" %)**Battery Info**:
348	348
349		-(% style="color:red" %)**Note: DS18B20 feature is supported in the hardware version > v1.3 which made since early of 2021.**
	304	+Check the battery voltage.
350	350
	306	+Ex1: 0x0B45 = 2885mV
351	351
352		-=== 2.3.5  Sensor Flag ===
	308	+Ex2: 0x0B49 = 2889mV
353	353
354	354
355		-(((
356		-0x01: Detect Ultrasonic Sensor
357		-)))
	311	+=== 2.3.2  Sensor Data. FPORT~=2 ===
358	358
359		-(((
360		-0x00: No Ultrasonic Sensor
	313	+
	314	+Sensor Data is uplink via FPORT=2
	315	+
	316	+(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:500px" %)
	317	+|=(% style="width: 60px;background-color:#D9E2F3;color:#0070C0" %)(((
	318	+**Size(bytes)**
	319	+)))|=(% style="width: 40px;background-color:#D9E2F3;color:#0070C0" %)2|=(% style="width: 90px;background-color:#D9E2F3;color:#0070C0" %)4|=(% style="width: 150px; background-color: #D9E2F3;color:#0070C0" %)1|=(% style="width: 80px; background-color: #D9E2F3;color:#0070C0" %)**2**|=(% style="width: 80px; background-color: #D9E2F3;color:#0070C0" %)2
	320	+|(% style="width:99px" %)Value|(% style="width:69px" %)(((
	321	+Battery
	322	+)))|(% style="width:130px" %)(((
	323	+Unix TimeStamp
	324	+)))|(% style="width:194px" %)(((
	325	+Alarm Flag & MOD& Level of PA8
	326	+)))|(% style="width:106px" %)(((
	327	+Temperature
	328	+)))|(% style="width:97px" %)(((
	329	+Humidity
361	361	)))
362	362
	332	+[[image:image-20230524144456-2.png||height="180" width="1142"]]
363	363
364		-=== 2.3.6  Decode payload in The Things Network ===
365	365
	335	+==== (% style="color:#4472c4" %)**Battery**(%%) ====
366	366
367		-While using TTN network, you can add the payload format to decode the payload.
	337	+Sensor Battery Level.
368	368
369		-[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS75%20-%20LoRaWAN%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654850829385-439.png?rev=1.1||alt="1654850829385-439.png"]]
	339	+Ex1: 0x0B45 = 2885mV
370	370
371		-The payload decoder function for TTN V3 is here:
	341	+Ex2: 0x0B49 = 2889mV
372	372
373		-(((
374		-DDS75-LB TTN V3 Payload Decoder:  [[ttps:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]]
375		-)))
376	376
377	377
378		-== 2.4  Uplink Interval ==
	345	+==== (% style="color:#4472c4" %)**Temperature**(%%) ====
379	379
	347	+**Example**:
380	380
381		-The DDS75-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: [[Change Uplink Interval>>doc:Main.End Device AT Commands and Downlink Command.WebHome||anchor="H4.1ChangeUplinkInterval"]]
	349	+If payload is: 0105H:  (0105 & 8000 == 0), temp = 0105H /10 = 26.1 degree
382	382
	351	+If payload is: FF3FH :  (FF3F & 8000 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
383	383
384		-== 2.5  ​Show Data in DataCake IoT Server ==
	353	+（FF3F & 8000：Judge whether the highest bit is 1, when the highest bit is 1, it is negative）
385	385
386	386
387		-(((
388		-[[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:
389		-)))
	356	+==== (% style="color:#4472c4" %)**Humidity**(%%) ====
390	390
391		-(((
392		-
393		-)))
394	394
395		-(((
396		-(% style="color:blue" %)**Step 1**(%%)**: Be sure that your device is programmed and properly connected to the network at this time.**
397		-)))
	359	+Read:0x(0197)=412    Value:  412 / 10=41.2, So 41.2%
398	398
399		-(((
400		-(% 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:**
401		-)))
402	402
	362	+==== (% style="color:#4472c4" %)**Alarm Flag & MOD & Level of PA8**(%%) ====
403	403
404		-[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS75%20-%20LoRaWAN%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654592790040-760.png?rev=1.1||alt="1654592790040-760.png"]]
405	405
	365	+**Example:**
406	406
407		-[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS75%20-%20LoRaWAN%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654592800389-571.png?rev=1.1||alt="1654592800389-571.png"]]
	367	+If payload & 0x01 = 0x01  **~-~->** This is an Alarm Message.It means that the temperature and humidity exceed the alarm value or trigger an interrupt.
408	408
	369	+If payload & 0x01 = 0x00  **~-~->** This is a normal uplink message, no alarm.
409	409
410		-(% style="color:blue" %)**Step 3**(%%)**: Create an account or log in Datacake.**
	371	+If payload & 0x80>>7 = 0x01  **~-~->** The PA8 is low level.
411	411
412		-(% style="color:blue" %)**Step 4**(%%)**: Search the DDS75-LB and add DevEUI.**
	373	+If payload & 0x80>>7 =0x00  **~-~->** The PA8 is high level.
413	413
414		-[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS75%20-%20LoRaWAN%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654851029373-510.png?rev=1.1||alt="1654851029373-510.png"]]
	375	+If payload >> 2 = 0x00  **~-~->**  means MOD=1, This is a sampling uplink message.
415	415
	377	+If payload >> 2 = 0x31  **~-~->**  means MOD=31, this message is a reply message for polling, this message contains the alarm settings. see [[this link>>path:#HPolltheAlarmsettings:]] for detail.
416	416
417		-After added, the sensor data arrive TTN V3, it will also arrive and show in Datacake.
418	418
419		-[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS75%20-%20LoRaWAN%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/image-20220610165129-11.png?width=1088&height=595&rev=1.1||alt="image-20220610165129-11.png"]]
	380	+== 2.4 Payload Decoder file ==
420	420
421	421
	383	+In TTN, use can add a custom payload so it shows friendly reading
422	422
423		-== 2.6 Datalog Feature ==
	385	+In the page (% style="color:#037691" %)**Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder**(%%) to add the decoder from:
424	424
	387	+[[https:~~/~~/github.com/dragino/dragino-end-node-decoder/tree/main/S31-LB%26S31B-LB>>https://github.com/dragino/dragino-end-node-decoder/tree/main/S31-LB%26S31B-LB]]
425	425
426		-Datalog Feature is to ensure IoT Server can get all sampling data from Sensor even if the LoRaWAN network is down. For each sampling, SW3L-LB will store the reading for future retrieving purposes.
427	427
	390	+== 2.5 Datalog Feature ==
428	428
429		-=== 2.6.1 Ways to get datalog via LoRaWAN ===
430	430
	393	+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 will store the reading for future retrieving purposes.
431	431
432		-Set PNACKMD=1, SW3L-LB will wait for ACK for every uplink, when there is no LoRaWAN network,SW3L-LB 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.
433	433
	396	+=== 2.5.1 Ways to get datalog via LoRaWAN ===
	397	+
	398	+
	399	+Set [[PNACKMD=1>>||anchor="H2.5.4DatalogUplinkpayload28FPORT3D329"]], S31x-LB will wait for ACK for every uplink, when there is no LoRaWAN network,S31x-LB 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.
	400	+
434	434	* (((
435		-a) SW3L-LB will do an ACK check for data records sending to make sure every data arrive server.
	402	+a) S31x-LB will do an ACK check for data records sending to make sure every data arrive server.
436	436	)))
437	437	* (((
438		-b) SW3L-LB will send data in **CONFIRMED Mode** when PNACKMD=1, but SW3L-LB 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 SW3L-LB gets a ACK, SW3L-LB will consider there is a network connection and resend all NONE-ACK messages.
	405	+b) S31x-LB will send data in **CONFIRMED Mode** when PNACKMD=1, but S31x-LB 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 S31x-LB gets a ACK, S31x-LB will consider there is a network connection and resend all NONE-ACK messages.
439	439	)))
440	440
441	441	Below is the typical case for the auto-update datalog feature (Set PNACKMD=1)
...	...	@@ -443,10 +443,10 @@
443	443	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/WebHome/image-20220703111700-2.png?width=1119&height=381&rev=1.1||alt="图片-20220703111700-2.png" height="381" width="1119"]]
444	444
445	445
446		-=== 2.6.2 Unix TimeStamp ===
	413	+=== 2.5.2 Unix TimeStamp ===
447	447
448	448
449		-SW3L-LB uses Unix TimeStamp format based on
	416	+S31x-LB uses Unix TimeStamp format based on
450	450
451	451	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/WebHome/image-20220523001219-11.png?width=627&height=97&rev=1.1||alt="图片-20220523001219-11.png" height="97" width="627"]]
452	452
...	...	@@ -460,64 +460,147 @@
460	460	So, we can use AT+TIMESTAMP=1611889405 or downlink 3060137afd00 to set the current time 2021 – Jan ~-~- 29 Friday 03:03:25
461	461
462	462
463		-=== 2.6.3 Set Device Time ===
	430	+=== 2.5.3 Set Device Time ===
464	464
465	465
466	466	User need to set (% style="color:blue" %)**SYNCMOD=1**(%%) to enable sync time via MAC command.
467	467
468		-Once SW3L-LB Joined LoRaWAN network, it will send the MAC command (DeviceTimeReq) and the server will reply with (DeviceTimeAns) to send the current time to SW3L-LB. If SW3L-LB fails to get the time from the server, SW3L-LB will use the internal time and wait for next time request (AT+SYNCTDC to set the time request period, default is 10 days).
	435	+Once S31x-LB 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. If S31x-LB fails to get the time from the server, S31x-LB will use the internal time and wait for next time request (AT+SYNCTDC to set the time request period, default is 10 days).
469	469
470	470	(% 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.**
471	471
472	472
473		-=== 2.6.4 Poll sensor value ===
	440	+=== 2.5.4 Datalog Uplink payload (FPORT~=3) ===
474	474
475	475
476		-Users can poll sensor values based on timestamps. Below is the downlink command.
	443	+The Datalog uplinks will use below payload format.
477	477
478		-(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:425.818px" %)
479		-|(% colspan="4" style="background-color:#d9e2f3; color:#0070c0; width:423px" %)**Downlink Command to poll Open/Close status (0x31)**
480		-|(% style="width:58px" %)**1byte**|(% style="width:127px" %)**4bytes**|(% style="width:124px" %)**4bytes**|(% style="width:114px" %)**1byte**
481		-|(% style="width:58px" %)31|(% style="width:127px" %)Timestamp start|(% style="width:124px" %)Timestamp end|(% style="width:114px" %)Uplink Interval
	445	+**Retrieval data payload:**
482	482
	447	+(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:500px" %)
	448	+|=(% style="width: 60px;background-color:#D9E2F3;color:#0070C0" %)(((
	449	+**Size(bytes)**
	450	+)))|=(% style="width: 40px; background-color:#D9E2F3;color:#0070C0" %)**2**|=(% style="width: 55px; background-color:#D9E2F3;color:#0070C0" %)**2**|=(% style="width: 65px; background-color:#D9E2F3;color:#0070C0" %)**2**|=(% style="width: 180px; background-color:#D9E2F3;color:#0070C0" %)**1**|=(% style="width: 100px; background-color:#D9E2F3;color:#0070C0" %)**4**
	451	+|(% style="width:103px" %)Value|(% style="width:68px" %)(((
	452	+ignore
	453	+)))|(% style="width:104px" %)(((
483	483	(((
484		-Timestamp start and Timestamp end-use Unix TimeStamp format as mentioned above. Devices will reply with all data logs during this period, using the uplink interval.
	455	+Humidity
485	485	)))
486	486
487	487	(((
488		-For example, downlink command [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/CPL01%20LoRaWAN%20Outdoor%20PulseContact%20%20Sensor%20Manual/WebHome/image-20220518162852-1.png?rev=1.1||alt="image-20220518162852-1.png"]]
	459	+
489	489	)))
	461	+)))|(% style="width:87px" %)(((
	462	+Temperature
	463	+)))|(% style="width:178px" %)(((
	464	+Poll message flag & Alarm Flag& Level of PA8
	465	+)))|(% style="width:137px" %)Unix Time Stamp
490	490
	467	+**Poll message flag & Alarm Flag & Level of PA8:**
	468	+
	469	+[[image:image-20230524114302-1.png||height="115" width="736"]]
	470	+
	471	+
	472	+**No ACK Message**:  1: This message means this payload is fromn Uplink Message which doesn't get ACK from the server before ( for **PNACKMD=1** feature)
	473	+
	474	+**Poll Message Flag**: 1: This message is a poll message reply.
	475	+
	476	+* Poll Message Flag is set to 1.
	477	+
	478	+* Each data entry is 11 bytes, to save airtime and battery, devices will send max bytes according to the current DR and Frequency bands.
	479	+
	480	+For example, in US915 band, the max payload for different DR is:
	481	+
	482	+**a) DR0:** max is 11 bytes so one entry of data
	483	+
	484	+**b) DR1:** max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
	485	+
	486	+**c) DR2:** total payload includes 11 entries of data
	487	+
	488	+**d) DR3: **total payload includes 22 entries of data.
	489	+
	490	+If devise doesn't have any data in the polling time. Device will uplink 11 bytes of 0
	491	+
	492	+**Example:**
	493	+
	494	+If S31x-LB has below data inside Flash:
	495	+
	496	+[[image:image-20230524114654-2.png]]
	497	+
	498	+
	499	+If user sends below downlink command: 31646D84E1646D856C05
	500	+
	501	+Where : Start time: 646D84E1 = time 23/5/24 03:30:41
	502	+
	503	+ Stop time: 646D856C= time 23/5/24 03:33:00
	504	+
	505	+
	506	+**S31x-LB will uplink this payload.**
	507	+
	508	+[[image:image-20230524114826-3.png||height="448" width="1244"]]
	509	+
491	491	(((
492		-Is to check 2021/11/12 12:00:00 to 2021/11/12 15:00:00's data
	511	+00 00 02 36 01 10 40 64 6D 84 E1 00 00 02 37 01 10 40 64 6D 84 F8 00 00 02 37 01 0F 40 64 6D 85 04 00 00 02 3A 01 0F 40 64 6D 85 18 00 00 02 3C 01 0F 40 64 6D 85 36 00 00 02 3D 01 0E 40 64 6D 85 3F 00 00 02 3F 01 0E 40 64 6D 85 60 00 00 02 40 01 0E 40 64 6D 85 6A
493	493	)))
494	494
495	495	(((
496		-Uplink Internal =5s，means SW3L-LB will send one packet every 5s. range 5~~255s.
	515	+Where the first 11 bytes is for the first entry:
497	497	)))
498	498
	518	+(((
	519	+00 00 02 36 01 10 40 64 6D 84 E1
	520	+)))
499	499
	522	+(((
	523	+**Hum**=0x0236/10=56.6
	524	+)))
	525	+
	526	+(((
	527	+**Temp**=0x0110/10=27.2
	528	+)))
	529	+
	530	+(((
	531	+**poll message flag & Alarm Flag & Level of PA8**=0x40,means reply data,sampling uplink message,the PA8 is low level.
	532	+)))
	533	+
	534	+(((
	535	+**Unix time** is 0x646D84E1=1684899041s=23/5/24 03:30:41
	536	+)))
	537	+
	538	+
	539	+(% aria-label="数据 URI 图像图像小部件" contenteditable="false" role="region" style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" tabindex="-1" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||alt="数据 URI 图片" data-widget="image" draggable="true" height="15" role="presentation" title="单击并拖动以移动" width="15"]](% aria-label="数据 URI 图像图像小部件" contenteditable="false" role="region" style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220, 220, 220, 0.5); display:none" tabindex="-1" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||alt="数据 URI 图片" draggable="true" height="15" role="presentation" title="单击并拖动以移动" width="15"]](% aria-label="数据 URI 图像图像小部件" contenteditable="false" role="region" style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" tabindex="-1" title="单击并拖动以调整大小" %)的(% aria-label="数据 URI 图像图像小部件" contenteditable="false" role="region" style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" tabindex="-1" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||alt="数据 URI 图片" data-widget="image" draggable="true" height="15" role="presentation" title="单击并拖动以移动" width="15"]](% aria-label="数据 URI 图像图像小部件" contenteditable="false" role="region" style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220, 220, 220, 0.5); display:none" tabindex="-1" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||alt="数据 URI 图片" draggable="true" height="15" role="presentation" title="单击并拖动以移动" width="15"]](% aria-label="数据 URI 图像图像小部件" contenteditable="false" role="region" style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" tabindex="-1" title="单击并拖动以调整大小" %)的
	540	+
	541	+== 2.6 Temperature Alarm Feature ==
	542	+
	543	+
	544	+S31x-LB work flow with Alarm feature.
	545	+
	546	+
	547	+[[image:image-20230524110125-3.png||height="768" width="1115"]]
	548	+
	549	+
	550	+
500	500	== 2.7 Frequency Plans ==
501	501
502	502
503		-The SW3L-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	+The S31x-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.
504	504
505	505	[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]]
506	506
507	507
508		-= 3. Configure SW3L-LB =
	559	+= 3. Configure S31x-LB =
509	509
510	510	== 3.1 Configure Methods ==
511	511
512	512
513		-SW3L-LB supports below configure method:
	564	+S31x-LB supports below configure method:
514	514
515	515	* AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
516		-
517	517	* AT Command via UART Connection : See [[UART Connection>>http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H2.3UARTConnectionforSN50v3basemotherboard]].
518		-
519	519	* LoRaWAN Downlink.  Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
520	520
	570	+
521	521	== 3.2 General Commands ==
522	522
523	523
...	...	@@ -524,7 +524,6 @@
524	524	These commands are to configure:
525	525
526	526	* General system settings like: uplink interval.
527		-
528	528	* LoRaWAN protocol & radio related command.
529	529
530	530	They are same for all Dragino Devices which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki:
...	...	@@ -532,25 +532,21 @@
532	532	[[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/]]
533	533
534	534
535		-== 3.3 Commands special design for SW3L-LB ==
	584	+== 3.3 Commands special design for S31x-LB ==
536	536
537	537
538		-These commands only valid for SW3L-LB, as below:
	587	+These commands only valid for S31x-LB, as below:
539	539
540	540
541	541	=== 3.3.1 Set Transmit Interval Time ===
542	542
543	543
544		-(((
545	545	Feature: Change LoRaWAN End Node Transmit Interval.
546		-)))
547	547
548		-(((
549	549	(% style="color:blue" %)**AT Command: AT+TDC**
550		-)))
551	551
552	552	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
553		-|=(% style="width: 156px;background-color:#D9E2F3; color:#0070c0" %)**Command Example**|=(% style="width: 137px;background-color:#D9E2F3; color:#0070c0" %)**Function**|=(% style="background-color:#D9E2F3; color:#0070c0" %)**Response**
	598	+|=(% style="width: 156px;background-color:#D9E2F3" %)**Command Example**|=(% style="width: 137px;background-color:#D9E2F3" %)**Function**|=(% style="background-color:#D9E2F3" %)**Response**
554	554	|(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|(((
555	555	30000
556	556	OK
...	...	@@ -561,44 +561,19 @@
561	561	Set transmit interval to 60000ms = 60 seconds
562	562	)))
563	563
564		-(((
565	565	(% style="color:blue" %)**Downlink Command: 0x01**
566		-)))
567	567
568		-(((
569	569	Format: Command Code (0x01) followed by 3 bytes time value.
570		-)))
571	571
572		-(((
573	573	If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01.
574		-)))
575	575
576		-* (((
577		-Example 1: Downlink Payload: 0100001E  ~/~/ Set Transmit Interval (TDC) = 30 seconds
578		-)))
579		-* (((
580		-Example 2: Downlink Payload: 0100003C  ~/~/ Set Transmit Interval (TDC) = 60 seconds
581		-)))
	615	+* Example 1: Downlink Payload: 0100001E  ~/~/  Set Transmit Interval (TDC) = 30 seconds
	616	+* Example 2: Downlink Payload: 0100003C  ~/~/  Set Transmit Interval (TDC) = 60 seconds
582	582
583		-=== 3.3.2 Quit AT Command ===
584	584
	619	+=== 3.3.2 Get Device Status ===
585	585
586		-Feature: Quit AT Command mode, so user needs to input the password again before using AT Commands.
587	587
588		-(% style="color:blue" %)**AT Command: AT+DISAT**
589		-
590		-(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:452px" %)
591		-|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 198px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 99px;background-color:#D9E2F3;color:#0070C0" %)**Response**
592		-|(% style="width:155px" %)AT+DISAT|(% style="width:198px" %)Quit AT Commands mode|(% style="width:96px" %)OK
593		-
594		-(% style="color:blue" %)**Downlink Command:**
595		-
596		-No downlink command for this feature.
597		-
598		-
599		-=== 3.3.3 Get Device Status ===
600		-
601		-
602	602	Send a LoRaWAN downlink to ask device send Alarm settings.
603	603
604	604	(% style="color:blue" %)**Downlink Payload:  **(%%)0x26 01
...	...	@@ -606,140 +606,83 @@
606	606	Sensor will upload Device Status via FPORT=5. See payload section for detail.
607	607
608	608
609		-=== 3.3.4 Alarm for continuously water flow ===
	629	+=== 3.3.3 Set Temperature Alarm Threshold ===
610	610
611	611
612		-(((
613		-This feature is to monitor and send Alarm for continuously water flow.
614		-)))
	632	+* (% style="color:blue" %)**AT Command:**
615	615
616		-(((
617		-Example case is for Toilet water monitoring, if some one push toilet button, the toilet will have water flow. If the toilet button has broken and can't returned to original state, the water flow will keep for hours or days which cause huge waste for water.
618		-)))
	634	+(% style="color:#037691" %)**AT+SHTEMP=min,max**
619	619
620		-(((
621		-To monitor this faulty and send alarm, there are two settings:
622		-)))
	636	+* When min=0, and max≠0, Alarm higher than max
	637	+* When min≠0, and max=0, Alarm lower than min
	638	+* When min≠0 and max≠0, Alarm higher than max or lower than min
623	623
624		-* (((
625		-(% style="color:#4f81bd" %)**Stop Duration: Unit: Second**
626		-)))
	640	+Example:
627	627
628		-(((
629		-Default: 15s, If SW3L-LB didn't see any water flow in 15s, SW3L-LB will consider stop of water flow event.
630		-)))
	642	+ AT+SHTEMP=0,30   ~/~/ Alarm when temperature higher than 30.
631	631
632		-* (((
633		-(% style="color:#4f81bd" %)**Alarm Timer: Units: Minute; Default 0 minutes (means Alarm disable)**
634		-)))
	644	+* (% style="color:blue" %)**Downlink Payload:**
635	635
636		-(((
637		-**Example:** 3 minutes, if SW3L-LB detect a start of water flow event and didn't detect a stop event within Alarm timer, SW3L-LB will send an Alarm to indicate a water flow abnormal alarm.
638		-)))
	646	+(% style="color:#037691" %)**0x(0C 01 00 1E)**  (%%) ~/~/ Set AT+SHTEMP=0,30
639	639
640		-(((
641		-So for example, If we set stop duration=15s and Alarm Timer=3minutes. If the toilet water flow continuously for more than 3 minutes, Sensor will send an alarm (in Confirmed MODE) to platform.
642		-)))
	648	+(% style="color:red" %)**(note: 3^^rd^^ byte= 0x00 for low limit(not set), 4^^th^^ byte = 0x1E for high limit: 30)**
643	643
644		-(((
645		-(% style="color:red" %)**Note:** **After this alarm is send, sensor will consider a stop of water flow and count for another new event. So if water flow waste last for 1 hour, Sensor will keep sending alarm every 3 minutes.**
646		-)))
647	647
648		-(((
649		-(% style="color:#4f81bd" %)**AT Command**(%%) to configure:
650		-)))
	651	+=== 3.3.4 Set Humidity Alarm Threshold ===
651	651
652		-* (((
653		-AT+PTRIG=15,3  ~-~-> Set Stop duration: 15s, Alarm Timer: 3 minutes.
654		-)))
655	655
656		-* (((
657		-AT+ PTRIG=15,0  ~-~-> Default Value, disable water waste Alarm.
658		-)))
	654	+* (% style="color:blue" %)**AT Command:**
659	659
660		-(((
661		-(% style="color:#4f81bd" %)**Downlink Command**(%%) to configure:
662		-)))
	656	+(% style="color:#037691" %)**AT+SHHUM=min,max**
663	663
664		-(((
665		-Command: **0xAA aa bb cc**
666		-)))
	658	+* When min=0, and max≠0, Alarm higher than max
	659	+* When min≠0, and max=0, Alarm lower than min
	660	+* When min≠0 and max≠0, Alarm higher than max or lower than min
667	667
668		-(((
669		-AA: Command Type Code
670		-)))
	662	+Example:
671	671
672		-(((
673		-aa: Stop duration
674		-)))
	664	+ AT+SHHUM=70,0  ~/~/ Alarm when humidity lower than 70%.
675	675
676		-(((
677		-bb cc: Alarm Timer
678		-)))
	666	+* (% style="color:blue" %)**Downlink Payload:**
679	679
680		-(((
681		-If user send 0xAA 0F 00 03: equal to AT+PTRIG=15,3
682		-)))
	668	+(% style="color:#037691" %)**0x(0C 02 46 00)**(%%)  ~/~/ Set AT+SHTHUM=70,0
683	683
	670	+(% style="color:red" %)**(note: 3^^rd^^ byte= 0x46 for low limit (70%), 4^^th^^ byte = 0x00 for high limit (not set))**
684	684
685		-=== 3.3.5 Clear Flash Record ===
686	686
	673	+=== 3.3.5 Set Alarm Interval ===
687	687
688		-Feature: Clear flash storage for data log feature.
689	689
690		-(% style="color:blue" %)**AT Command: AT+CLRDTA**
	676	+The shortest time of two Alarm packet. (unit: min)
691	691
692		-(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:500px" %)
693		-|=(% style="width: 157px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 169px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 174px;background-color:#D9E2F3;color:#0070C0" %)**Response**
694		-|(% style="width:157px" %)AT+CLRDTA|(% style="width:169px" %)Clear flash storage for data log feature.|Clear all stored sensor data… OK
	678	+* (% style="color:blue" %)**AT Command:**
695	695
696		-(((
697		-(% style="color:blue" %)**Downlink Command:**
698		-)))
	680	+(% style="color:#037691" %)**AT+ATDC=30** (%%) ~/~/ The shortest interval of two Alarm packets is 30 minutes, Means is there is an alarm packet uplink, there won't be another one in the next 30 minutes.
699	699
700		-(((
701		-* **Example**: 0xA301  ~/~/  Same as AT+CLRDTA
702		-)))
	682	+* (% style="color:blue" %)**Downlink Payload:**
703	703
	684	+(% style="color:#037691" %)**0x(0D 00 1E)**(%%)     **~-~--> ** Set AT+ATDC=0x 00 1E = 30 minutes
704	704
705	705
706		-=== 3.3.6 Set the calculate flag ===
	687	+=== 3.3.6 Get Alarm settings ===
707	707
708	708
709		-Feature: Set the calculate flag
	690	+Send a LoRaWAN downlink to ask device send Alarm settings.
710	710
711		-(% style="color:blue" %)**AT Command: AT+CALCFLAG**
	692	+* (% style="color:#037691" %)**Downlink Payload:  **(%%)0x0E 01
712	712
713		-(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:461px" %)
714		-|=(% style="width: 158px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 193px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 110px;background-color:#D9E2F3;color:#0070C0" %)**Response**
715		-|(% style="width:158px" %)AT+CALCFLAG =1|(% style="width:192px" %)Set the calculate flag to 1.|(% style="width:109px" %)OK
716		-|(% style="width:158px" %)AT+CALCFLAG =2|(% style="width:192px" %)Set the calculate flag to 2.|(% style="width:109px" %)OK
	694	+**Example:**
717	717
718		-(% style="color:blue" %)**Downlink Command:**
	696	+[[image:image-20230524110211-4.png]]
719	719
720		-* **Example**: 0XA501  ~/~/  Same as AT+CALCFLAG =1
	698	+**Explain:**
721	721
722		-=== 3.3.7 Set count number ===
	700	+* Alarm & MOD bit is 0x7C, 0x7C >> 2 = 0x31: Means this message is the Alarm settings message.
723	723
724	724
725		-Feature: Manually set the count number
	703	+=== 3.3.7 Set Interrupt Mode ===
726	726
727		-(% style="color:blue" %)**AT Command: AT+SETCNT**
728	728
729		-(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:479px" %)
730		-|=(% style="width: 160px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 223px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 96px;background-color:#D9E2F3;color:#0070C0" %)**Response**
731		-|(% style="width:160px" %)AT+ SETCNT =0|(% style="width:221px" %)Set the count number to 0.|(% style="width:95px" %)OK
732		-|(% style="width:160px" %)AT+ SETCNT =100|(% style="width:221px" %)Set the count number to 100.|(% style="width:95px" %)OK
733		-
734		-(% style="color:blue" %)**Downlink Command:**
735		-
736		-* **Example**: 0xA6000001  ~/~/  Same as AT+ SETCNT =1
737		-
738		-* **Example**: 0xA6000064  ~/~/  Same as AT+ SETCNT =100
739		-
740		-=== 3.3.8 Set Interrupt Mode ===
741		-
742		-
743	743	Feature, Set Interrupt mode for PA8 of pin.
744	744
745	745	When AT+INTMOD=0 is set, PA8 is used as a digital input port.
...	...	@@ -747,7 +747,7 @@
747	747	(% style="color:blue" %)**AT Command: AT+INTMOD**
748	748
749	749	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
750		-|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 197px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 158px;background-color:#D9E2F3;color:#0070C0" %)**Response**
	713	+|=(% style="width: 155px;background-color:#D9E2F3" %)**Command Example**|=(% style="width: 197px;background-color:#D9E2F3" %)**Function**|=(% style="width: 158px;background-color:#D9E2F3" %)**Response**
751	751	|(% style="width:154px" %)AT+INTMOD=?|(% style="width:196px" %)Show current interrupt mode|(% style="width:157px" %)(((
752	752	0
753	753	OK
...	...	@@ -768,32 +768,42 @@
768	768	This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
769	769
770	770	* Example 1: Downlink Payload: 06000000  ~/~/  Turn off interrupt mode
771		-
772	772	* Example 2: Downlink Payload: 06000003  ~/~/  Set the interrupt mode to rising edge trigger
773	773
774		-=== 3.3.9 Set work mode ===
775	775
	737	+=== 3.3.8 Set Power Output Duration ===
776	776
777		-Feature: Manually set the work mode
778	778
	740	+Control the output duration 5V . Before each sampling, device will
779	779
780		-(% style="color:blue" %)**AT Command: AT+MOD**
	742	+~1. first enable the power output to external sensor,
781	781
782		-(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:463px" %)
783		-|=(% style="width: 162px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 193px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 108px;background-color:#D9E2F3;color:#0070C0" %)**Response**
784		-|(% style="width:162px" %)AT+MOD=0|(% style="width:191px" %)Set the work mode to 0.|(% style="width:106px" %)OK
785		-|(% style="width:162px" %)AT+MOD=1|(% style="width:191px" %)Set the work mode to 1|(% style="width:106px" %)OK
	744	+2. keep it on as per duration, read sensor value and construct uplink payload
786	786
787		-(% style="color:blue" %)**Downlink Command:**
	746	+3. final, close the power output.
788	788
789		-* **Example: **0x0A00  ~/~/  Same as AT+MOD=0
	748	+(% style="color:blue" %)**AT Command: AT+5VT**
790	790
791		-* **Example:** 0x0A01  ~/~/  Same as AT+MOD=1
	750	+(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
	751	+|=(% style="width: 155px;background-color:#D9E2F3" %)**Command Example**|=(% style="width: 197px;background-color:#D9E2F3" %)**Function**|=(% style="width: 158px;background-color:#D9E2F3" %)**Response**
	752	+|(% style="width:154px" %)AT+5VT=?|(% style="width:196px" %)Show 5V open time.|(% style="width:157px" %)0 (default)
	753	+OK
	754	+|(% style="width:154px" %)AT+5VT=500|(% style="width:196px" %)Close after a delay of 1000 milliseconds.|(% style="width:157px" %)OK
792	792
	756	+(% style="color:blue" %)**Downlink Command: 0x07**
	757	+
	758	+Format: Command Code (0x07) followed by 2 bytes.
	759	+
	760	+The first and second bytes are the time to turn on.
	761	+
	762	+* Example 1: Downlink Payload: 070000  **~-~-->**  AT+5VT=0
	763	+* Example 2: Downlink Payload: 0701F4  **~-~-->**  AT+5VT=500
	764	+
	765	+
793	793	= 4. Battery & Power Consumption =
794	794
795	795
796		-SW3L-LB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
	769	+S31x-LB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
797	797
798	798	[[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
799	799
...	...	@@ -802,36 +802,31 @@
802	802
803	803
804	804	(% class="wikigeneratedid" %)
805		-User can change firmware SW3L-LB to:
	778	+User can change firmware S31x-LB to:
806	806
807	807	* Change Frequency band/ region.
808		-
809	809	* Update with new features.
810		-
811	811	* Fix bugs.
812	812
813	813	Firmware and changelog can be downloaded from : **[[Firmware download link>>url:https://www.dropbox.com/sh/kwqv57tp6pejias/AAAopYMATh1GM6fZ-VRCLrpDa?dl=0]]**
814	814
	786	+
815	815	Methods to Update Firmware:
816	816
817	817	* (Recommanded way) OTA firmware update via wireless:   [[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/]]
818		-
819	819	* Update through UART TTL interface. **[[Instruction>>url:http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H1.LoRaSTv4baseHardware]]**.
820	820
	792	+
821	821	= 6. FAQ =
822	822
823		-== 6.1  AT Commands input doesn't work ==
824	824
825	825
826		-In the case if user can see the console output but can't type input to the device. Please check if you already include the (% style="color:green" %)**ENTER**(%%) while sending out the command. Some serial tool doesn't send (% style="color:green" %)**ENTER**(%%) while press the send key, user need to add ENTER in their string.
827		-
828		-
829	829	= 7. Order Info =
830	830
831	831
832		-Part Number: (% style="color:blue" %)**SW3L-LB-XXX-YYY**
	800	+Part Number: (% style="color:blue" %)**S31-LB-XX  / S31B-LB-XX**
833	833
834		-(% style="color:red" %)**XXX**(%%): The default frequency band
	802	+(% style="color:red" %)**XX**(%%): The default frequency band
835	835
836	836	* (% style="color:red" %)**AS923**(%%): LoRaWAN AS923 band
837	837
...	...	@@ -849,43 +849,13 @@
849	849
850	850	* (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
851	851
852		-(((
853		-(% style="color:blue" %)**YYY**(%%): Flow Sensor Model:
854		-)))
855	855
856		-(((
857		- **004:** DW-004 Flow Sensor: diameter: G1/2” / DN15.  450 pulse = 1 L
858		-)))
859		-
860		-(((
861		- **006:** DW-006 Flow Sensor: diameter: G3/4” / DN20. 390 pulse = 1 L
862		-)))
863		-
864		-(((
865		- **010:** DW-010 Flow Sensor: diameter: G 1” / DN25. 64 pulse = 1 L
866		-)))
867		-
868		-* (((
869		-calculate flag=0: for SW3L-004 Flow Sensor: 450 pulse = 1 L
870		-)))
871		-
872		-* (((
873		-calculate flag=1: for SW3L-006 Flow Sensor: 390 pulse = 1 L
874		-)))
875		-
876		-* (((
877		-calculate flag=2: for SW3L-010 Flow Sensor: 64  pulse = 1 L
878		-
879		-
880		-
881		-)))
882		-
883	883	= 8. ​Packing Info =
884	884
885	885
886	886	(% style="color:#037691" %)**Package Includes**:
887	887
888		-* SW3L-LB LoRaWAN Flow Sensor
	826	+* S31x-LB LoRaWAN Temperature & Humidity Sensor
889	889
890	890	(% style="color:#037691" %)**Dimension and weight**:
891	891
...	...	@@ -897,6 +897,7 @@
897	897
898	898	* Weight / pcs : g
899	899
	838	+
900	900	= 9. Support =
901	901
902	902

image-20230530111051-3.png

Author

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

Size

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

Content

image-20230530111412-4.png

Author

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

Size

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

Content

image-20230530135919-1.png

Author

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

Size

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

Content

image-20230530135929-2.png

Author

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

Size

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

Content

image-20230530140053-1.jpeg

Author

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

Size

...	...	@@ -1,1 +1,0 @@
1		-1.3 MB

Content

image-20230612170349-1.png

Author

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

Size

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

Content

image-20230612170943-2.png

Author

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

Size

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

Content

image-20230612171032-3.png

Author

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

Size

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

Content