Show last authors
1 (% style="display:none" %) (%%) ​​​​​​(% style="display:none" %)
2
3 (% style="text-align:center" %)
4 [[image:image-20220623150858-9.png]]
5
6
7 (% style="display:none" %) (%%)
8
9
10
11
12
13
14
15 **Table of Contents:**
16
17 (% aria-label="macro:toc widget" contenteditable="false" role="region" tabindex="-1" %)
18 (((
19 (% 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" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||height="15" role="presentation" title="Click and drag to move" width="15"]]
20 )))
21
22 {{toc/}}
23
24
25
26
27
28
29
30
31
32
33
34
35 = 1.  Introduction =
36
37 == 1.1 ​ What is LSN50V2-S31 LoRaWAN Temperature & Humidity Sensor ==
38
39
40 (((
41 The Dragino LSN50v2-S31 is a (% style="color:#4472c4" %)**LoRaWAN Temperature and Humidity Sensor**(%%) for Internet of Things solution. It is used to measure the (% style="color:#4472c4" %)**surrounding environment temperature and relative air humidity precisely**(%%), and then upload to IoT server via LoRaWAN wireless protocol.
42 )))
43
44 (((
45 The temperature & humidity sensor used in LSN50v2-S31 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:#4472c4" %)**waterproof anti-condensation casing **(%%)for long term use.
46 )))
47
48 (((
49 LSN50v2-S31 supports (% style="color:#4472c4" %)**temperature and humidity alarm feature**(%%), user can get alarm for instant notice.
50 )))
51
52 (((
53 LSN50v2-S31 is powered by(% style="color:#4472c4" %)**8500mAh Li-SOCI2 battery**(%%), It is designed for long term use up to 10 years. (Real-world battery life depends on the use environment, update period. Please check related Power Analyze report).
54 )))
55
56 (((
57 Each LSN50v2-S31 is pre-load with a set of unique keys for LoRaWAN registration, register these keys to local LoRaWAN server and it will auto connect after power on.
58 )))
59
60
61 [[image:1655968636488-753.png]]
62
63
64 == 1.2  Specifications ==
65
66
67 (% style="color:#037691" %)**Micro Controller:**
68
69 * MCU: STM32L072xxxx
70 * Flash:128KB
71 * RAM:20KB
72 * EEPROM: 6KB
73 * Clock Speed: 32Mhz
74
75 (% style="color:#037691" %)**Common DC Characteristics:**
76
77 * Supply Voltage: built in 8500mAh Li-SOCI2 battery
78 * Operating Temperature: -40 ~~ 85°C
79
80 (% style="color:#037691" %)**Temperature Sensor:**
81
82 * Range: -40 to + 80°C
83 * Accuracy: ±0.2 @ 0-90 °C
84 * Resolution: 0.1°C
85 * Long Term Shift: <0.03 °C/yr
86
87 (% style="color:#037691" %)**Humidity Sensor: **
88
89 * Range: 0 ~~ 99.9% RH
90 * Accuracy: ± 2%RH ( 0 ~~ 100%RH)
91 * Resolution: 0.01% RH
92 * Long Term Shift: <0.25 %RH/yr
93
94 (% style="color:#037691" %)**LoRa Spec:**
95
96 * Frequency Range,
97 ** Band 1 (HF): 862 ~~ 1020 Mhz
98 * 168 dB maximum link budget.
99 * High sensitivity: down to -148 dBm.
100 * Bullet-proof front end: IIP3 = -12.5 dBm.
101 * Excellent blocking immunity.
102 * Built-in bit synchronizer for clock recovery.
103 * Preamble detection.
104 * 127 dB Dynamic Range RSSI.
105 * Automatic RF Sense and CAD with ultra-fast AFC.
106 * LoRaWAN 1.0.3 Specification
107
108 (% style="color:#037691" %)**Power Consumption**
109
110 * Sleeping Mode: 20uA
111 * LoRaWAN Transmit Mode: 125mA @ 20dBm 44mA @ 14dBm
112
113 == ​1.3  Features ==
114
115
116 * LoRaWAN v1.0.3 Class A
117 * Ultra-low power consumption
118 * External 3 meters SHT31 probe
119 * Measure range -40°C ~~ 80°C
120 * Temperature & Humidity alarm
121 * Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865
122 * AT Commands to change parameters
123 * Uplink on periodically or Interrupt
124 * Downlink to change configure
125 * 8500mAh Battery for long term use
126
127 == 1.4 ​ Applications ==
128
129
130 * Wireless Alarm and Security Systems
131 * Home and Building Automation
132 * Industrial Monitoring and Control
133 * Long range Irrigation Systems.
134
135 == 1.5  Pin Definitions and Switch ==
136
137
138 (% class="wikigeneratedid" %)
139 [[image:1655890786311-614.png||height="377" width="733"]]
140
141
142 The latest mother board for LSN50v2-S31 is :
143
144 [[image:image-20230406112239-3.png||height="410" width="731"]]
145
146
147 === 1.5.1 Pin Definition ===
148
149
150 The device is pre-configured to connect to SHT31 sensor. The other pins are not used. If user want to know more about other pins, please refer the user manual of LSn50v2 at: [[https:~~/~~/www.dropbox.com/sh/djkxs7mr17y94mi/AABVlWbM9uzK9OA3mXyAT10Za?dl=0>>https://www.dropbox.com/sh/djkxs7mr17y94mi/AABVlWbM9uzK9OA3mXyAT10Za?dl=0]]
151
152
153 === 1.5.2 Jumper JP2 ===
154
155
156 Power on Device when put this jumper.
157
158
159 === 1.5.3 BOOT MODE / SW1 ===
160
161
162 (((
163 ~1. ISP:  upgrade mode, device won't have any signal in this mode. but ready for upgrade firmware. LED won't work. Firmware won't run.
164 )))
165
166 (((
167 2. Flash:  work mode, device starts to work and send out console output for further debug
168 )))
169
170
171 === 1.5.4 Reset Button ===
172
173
174 Press to reboot the device.
175
176
177 === 1.5.5 LED ===
178
179
180 It will flash:
181
182 1.  When boot the device in flash mode
183
184 2.  Send an uplink packet
185
186
187 === 1.5.6  Probe Dimension ===
188
189
190 [[image:1655970095830-106.png]]
191
192
193 == 1.6  Hardware Variant ==
194
195
196 (% border="1" cellspacing="5" style="width:450px" %)
197 |=(% style="width: 108px;background-color:#4F81BD;color:white" %)Model|=(% style="width: 139px;background-color:#4F81BD;color:white" %)Photo|=(% style="width: 203px;background-color:#4F81BD;color:white" %)**Description**
198 |(% style="width:108px" %)LSN50v2-S31|(% style="width:138px" %)[[image:1655969394811-263.png]]|(% style="width:203px" %)(((
199 External 3 meters SHT31 probe
200 )))
201 |(% style="width:108px" %)LSN50v2 -S31B|(% style="width:138px" %)[[image:1655969407614-262.png]]|(% style="width:203px" %)(((
202 On device SHT31 Probe
203 )))
204
205 = 2.  How to use LSN50v2-S31? =
206
207 == 2.1  How it works ==
208
209
210 (((
211 The LSN50v2-S31 is working as LoRaWAN OTAA Class A end node. Each LSN50v2-S31 is shipped with a worldwide unique set of OTAA and ABP keys. User needs to input the OTAA or ABP keys in the LoRaWAN network server to register. Open the enclosure and power on the LSN50v2-S31, it will join the LoRaWAN network and start to transmit data. The default period for each uplink is 20 minutes.
212 )))
213
214
215 == 2.2  ​Quick guide to connect to LoRaWAN server (OTAA) ==
216
217
218 (((
219 Here is an example for how to join the [[TTN LoRaWAN >>url:http://www.thethingsnetwork.org/]]Server. Below is the network structure, in this demo we use [[DLOS8>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/160-dlos8.html]] as LoRaWAN gateway.
220
221
222 (% 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" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]][[image:1655891470063-521.png]](% title="Click and drag to resize" %)​[[image:1655970238866-880.png]]
223 )))
224
225
226 (((
227 The DLOS8 is already set to connect to [[TTN >>url:https://www.thethingsnetwork.org/]]. What the rest we need to is register the LSN50V2-S31 to TTN:
228
229
230 (% style="color:blue" %)**Step 1**(%%): Create a device in TTN with the OTAA keys from LSN50V2-S31.
231
232 Each LSN50V2-S31 is shipped with a sticker with the default device EUI as below:
233 )))
234
235 (% 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" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]][[image:image-20230426084122-2.png]](% title="Click and drag to resize" %)​[[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS25-LBLDS25-LS--LoRaWAN_LiDAR_Distance_Auto-Clean_Sensor_User_Manual/WebHome/image-20230426084152-1.png?width=502&height=233&rev=1.1||alt="图片-20230426084152-1.png"]](% aria-label="Data URI image image widget" 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==||data-widget="image" draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]][[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​​(% aria-label="Data URI image image widget" 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==||data-widget="image" draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% aria-label="Data URI image image widget" 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==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% aria-label="Data URI image image widget" 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="Click and drag to resize" %)​(% aria-label="Data URI image image widget" 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==||data-widget="image" draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]][[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​(% aria-label="Data URI image image widget" 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" %)​(%%)​
236
237
238 (((
239 You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
240
241 **Create the application.**
242
243 [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SAC01L_LoRaWAN_Temperature%26Humidity_Sensor_User_Manual/WebHome/image-20250423093843-1.png?width=756&height=264&rev=1.1||alt="image-20250423093843-1.png"]]
244
245 [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LTC2-LB--LoRaWAN_Temperature_Transmitter_User_Manual/WebHome/image-20240907111305-2.png?width=1000&height=572&rev=1.1||alt="image-20240907111305-2.png"]]
246
247
248 **Add devices to the created Application.**
249
250 [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LTC2-LB--LoRaWAN_Temperature_Transmitter_User_Manual/WebHome/image-20240907111659-3.png?width=977&height=185&rev=1.1||alt="image-20240907111659-3.png"]]
251
252 [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LTC2-LB--LoRaWAN_Temperature_Transmitter_User_Manual/WebHome/image-20240907111820-5.png?width=975&height=377&rev=1.1||alt="image-20240907111820-5.png"]]
253
254
255 **Enter end device specifics manually.**
256
257 [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LTC2-LB--LoRaWAN_Temperature_Transmitter_User_Manual/WebHome/image-20240907112136-6.png?width=697&height=687&rev=1.1||alt="image-20240907112136-6.png"]]
258
259
260 **Add DevEUI and AppKey.**
261
262 **Customize a platform ID for the device.**
263
264 [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LTC2-LB--LoRaWAN_Temperature_Transmitter_User_Manual/WebHome/image-20240907112427-7.png?rev=1.1||alt="image-20240907112427-7.png"]]
265
266
267 (% style="color:blue" %)**Step 2**(%%):** Add decoder.**
268
269 In TTN, user can add a custom payload so it shows friendly reading.
270
271 Click this link to get the decoder: [[https:~~/~~/github.com/dragino/dragino-end-node-decoder/tree/main/>>url:https://github.com/dragino/dragino-end-node-decoder/tree/main/]]
272
273 Below is TTN screen shot:
274
275 [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS25-LBLDS25-LS--LoRaWAN_LiDAR_Distance_Auto-Clean_Sensor_User_Manual/WebHome/image-20241009140556-1.png?width=1184&height=488&rev=1.1||alt="image-20241009140556-1.png" height="488" width="1184"]]
276
277 [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS25-LBLDS25-LS--LoRaWAN_LiDAR_Distance_Auto-Clean_Sensor_User_Manual/WebHome/image-20241009140603-2.png?width=1168&height=562&rev=1.1||alt="image-20241009140603-2.png"]]
278
279 (% aria-label="Data URI image image widget" 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" %)​(%%)​
280 )))
281
282 (% style="color:blue" %)**Step 3**(%%): Power on LSN50v2-S31
283
284 LSN50V2-S31 will auto join to TTN network via the LoRaWAN coverage by DLOS8. After join success, LSN50V2-S31 will start to uplink temperature value to server.
285
286 [[image:1655891678689-137.png]]
287
288
289 == 2.3  ​Uplink Payload ==
290
291 === 2.3.1  Payload Analyze ===
292
293
294 (((
295 Normal Upload Payload:
296 )))
297
298 (((
299 LSN50v2-S31 use the same payload as LSn50v2 mod1, as below. (Since firmware version 1.8.0, the third to sixth bytes are timestamps)
300 )))
301
302 (% border="1" cellspacing="3" style="background-color:#f2f2f2; width:400px" %)
303 |=(% style="width: 95px;background-color:#4F81BD;color:white" %)(((
304 **Size(bytes)**
305 )))|=(% style="width: 36px;background-color:#4F81BD;color:white" %)2|=(% style="width: 77px;background-color:#4F81BD;color:white" %)4|=(% style="width: 65px;background-color:#4F81BD;color:white" %)1|=(% style="width: 65px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 65px;background-color:#4F81BD;color:white" %)2
306 |(% style="width:95px" %)Value|(% style="width:36px" %)(((
307 [[Battery>>||anchor="HBattery:"]]
308 )))|(% style="width:61px" %)(((
309 [[Unix TimeStamp>>||anchor="H2.4.1UnixTimeStamp"]]
310 )))|(% style="width:91px" %)(((
311 [[Alarm Flag>>||anchor="HAlarmFlag26MOD:"]]
312 )))|(% style="width:99px" %)(((
313 [[Temperature>>||anchor="HTemperature:"]]
314 )))|(% style="width:97px" %)(((
315 [[Humidity>>||anchor="HHumidity:"]]
316 )))
317
318 [[image:image-20230330135457-3.png]]
319
320
321 ==== (% style="color:#4472c4" %)**Battery:**(%%) ====
322
323
324 Check the battery voltage.
325
326 Ex1: 0x0B45 = 2885mV
327
328 Ex2: 0x0B49 = 2889mV
329
330
331
332 ==== (% style="color:#4472c4" %)**Temperature:**(%%) ====
333
334
335 **Example**:
336
337 If payload is: 0105H:  (0105 & 8000 == 0), temp = 0105H /10 = 26.1 degree
338
339 If payload is: FF3FH :  (FF3F & 8000 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
340
341 (FF3F & 8000:Judge whether the highest bit is 1, when the highest bit is 1, it is negative)
342
343
344
345 ==== (% style="color:#4472c4" %)**Humidity:**(%%) ====
346
347
348 Read:0x(0197)=412    Value:  412 / 10=41.2, So 41.2%
349
350
351
352 ==== (% style="color:#4472c4" %)**Alarm Flag& MOD:**(%%) ====
353
354
355 **Example:**
356
357 If payload & 0x01 = 0x01  **~-~->** This is an Alarm Message
358
359 If payload & 0x01 = 0x00  **~-~->** This is a normal uplink message, no alarm
360
361 If payload >> 2 = 0x00  **~-~->**  means MOD=1, This is a sampling uplink message
362
363 If payload >> 2 = 0x31  **~-~->**  means MOD=31, this message is a reply message for polling, this message contains the alarm settings. see [[this link>>||anchor="HPolltheAlarmsettings:"]] for detail. [[~>url:http:~~/~~/www.dragino.com/downloads/index.php?dir" data-cke-saved-href="#HPolltheAlarmsettings:" href="#HPolltheAlarmsettings:"~>this link>>||anchor="HPolltheAlarmsettings:" aria-label="Data URI image image widget" contenteditable="false" role="presentation" 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"]]
364
365
366 === 2.3.2  Payload Decoder file ===
367
368
369 (((
370 In **TTN**, use can add a custom payload so it shows friendly. 
371 )))
372
373 (((
374 In the page (% style="color:#037691" %)**Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder**(%%) to add the decoder from:
375 )))
376
377 (((
378 [[http:~~/~~/www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LSN50v2-S31/Decoder/>>url:http://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LSN50v2-D20/Decoder/]]
379 )))
380
381
382 (% aria-label="Data URI image image widget" 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==||data-widget="image" draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% aria-label="Data URI image image widget" 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==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% aria-label="Data URI image image widget" 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="Click and drag to resize" %)​(% aria-label="Data URI image image widget" 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==||data-widget="image" draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% aria-label="Data URI image image widget" 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==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% aria-label="Data URI image image widget" 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="Click and drag to resize" %)​
383
384 === 2.3.3  Historical Temperature and humidity of S31, FPORT~=3(Since firmware 1.8.0) ===
385
386
387 S31 stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.4A0DatalogFeature"]].
388
389 The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time water flow status.
390
391 * Each data entry is 11 bytes and has the same structure as real time water flow status, to save airtime and battery, S31 will send max bytes according to the current DR and Frequency bands.
392
393 For example, in the US915 band, the max payload for different DR is:
394
395 **a) DR0:** max is 11 bytes so one entry of data
396
397 **b) DR1:** max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
398
399 **c) DR2:** total payload includes 11 entries of data
400
401 **d) DR3:** total payload includes 22 entries of data.
402
403 If S31 doesn't have any data in the polling time. It will uplink 11 bytes of 0
404
405 (% class="wikigeneratedid" id="H" %)
406 [[image:image-20230330140955-1.png]]
407
408 **Downlink:**
409
410 0x 31 64 22 5B 00 64 22 5D 58 05
411
412
413 **Uplink:**
414
415 00 00 00 00 E1 02 95 64 22 5B 37 00 00 00 00 E1 02 97 64 22 5B 74 00 00 00 00 E0 02 98 64 22 5B B0 00 00 00 00 E0 02 9C 64 22 5B EC 00 00 00 00 E0 02 9C 64 22 5C 28 00 00 00 00 DF 02 9D 64 22 5C 64 00 00 00 00 DF 02 9F 64 22 5C A0 00 00 00 00 DE 02 A0 64 22 5C DC 00 00 00 00 DE 02 A9 64 22 5D 18 00 00 00 00 DE 02 A4 64 22 5D 54
416
417
418 **Parsed Value:**
419
420 <Temperature, Humidity, Unix TimeStamp>
421
422 [22.5,66.1,2023-03-28 03:12:55],
423
424 [22.5,66.3,2023-03-28 03:13:56],
425
426 [22.4,66.4,2023-03-28 03:14:56],
427
428 [22.4,66.8,2023-03-28 03:15:56],
429
430 [22.4,66.8,2023-03-28 03:16:56],
431
432 [22.3,66.9,2023-03-28 03:17:56],
433
434 [22.3,67.1,2023-03-28 03:18:56]
435
436 [22.2,67.2,2023-03-28 03:19:56],
437
438 [22.2,68.1,2023-03-28 03:20:56],
439
440 [22.2,67.6,2023-03-28 03:21:56],
441
442
443 **Serial port**:
444
445 [[image:image-20230330141016-2.png]]
446
447
448 == 2.4 Datalog Feature ==
449
450 === 2.4.1 Unix TimeStamp ===
451
452
453 S31 uses Unix TimeStamp format based on
454
455 [[image:image-20230330141111-3.png]]
456
457 Users can get this time from the link:  [[https:~~/~~/www.epochconverter.com/>>url:https://www.epochconverter.com/]] :
458
459 Below is the converter example
460
461 [[image:image-20230330141111-4.png]]
462
463
464 === 2.4.2 Set Device Time ===
465
466
467 (% style="color:blue" %)**Through LoRaWAN MAC Command**
468
469 Once S31 Joined the LoRaWAN network, it will send the MAC command (DeviceTimeReq) and the server will reply with (DeviceTimeAns) to send the current time to S31. If S31 fails to get the time from the server, S31 will use the internal time and wait for the next time request.
470
471
472 (% style="color:red" %)**Note: LoRaWAN Server needs to support LoRaWAN v1.0.3(MAC v1.0.3) or higher to support this MAC command feature.**
473
474
475 === 2.4.3 Poll sensor value ===
476
477
478 Users can poll sensor values based on timestamps. Below is the downlink command.
479
480 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:431px" %)
481 |=(% colspan="4" style="width: 428px;background-color:#4F81BD;color:white" %)**Downlink Command to poll Open/Close status (0x31)**
482 |(% style="width:60px" %)**1byte**|(% style="width:127px" %)**4bytes**|(% style="width:122px" %)**4bytes**|(% style="width:116px" %)**1byte**
483 |(% style="width:60px" %)31|(% style="width:127px" %)Timestamp start|(% style="width:122px" %)Timestamp end|(% style="width:116px" %)Uplink Interval
484
485 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.
486
487 For example, downlink command[[image:image-20230330141111-5.png]]
488
489 Is to check 2021/11/12 12:00:00 to 2021/11/12 15:00:00's data
490
491 Uplink Internal =5s,means CPL01 will send one packet every 5s. range 5~~255s.
492
493
494 === 2.4.4 Clear Flash Record ===
495
496
497 Feature: Clear flash storage for data log feature.
498
499 **AT Command: (% style="color:#037691" %)AT+CLRDTA(%%)**
500
501 (% border="1" cellspacing="3" style="background-color:#f2f2f2; width:511px" %)
502 |=(% style="width: 159px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 138px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 214px;background-color:#4F81BD;color:white" %)**Response**
503 |(% style="width:157px" %)AT+CLRDTA|(% style="width:136px" %)Clear date record|(% style="width:213px" %)(((
504 Clear all stored sensor data…
505 OK
506 )))
507
508 === 2.4.5  Set system time ===
509
510
511 Feature: Set system time, Unix format. [[See here for format detail.>>path:#H2.4.1A0UnixTimeStamp]]
512
513 **AT Command:**
514
515 (% border="1" cellspacing="3" style="background-color:#f2f2f2; width:470px" %)
516 |=(% style="width: 157px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 225px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 88px;background-color:#4F81BD;color:white" %)**Response**
517 |(% style="width:157px" %)AT+TIMESTAMP=1611104352|(% style="width:225px" %)Set System time to 2021-01-20 00:59:12|(% style="width:85px" %)(((
518 OK
519 )))
520
521 **Downlink Command:**
522
523 0x306007806000  ~/~/  Set timestamp to 0x(6007806000),Same as AT+TIMESTAMP=1611104352
524
525
526 === 2.4.6  Set Time Sync Mode ===
527
528
529 Feature: Enable/Disable Sync system time via LoRaWAN MAC Command (DeviceTimeReq), LoRaWAN server must support v1.0.3 protocol to reply to this command.
530
531 (% style="color:blue" %)**SYNCMOD**(%%) is set to 1 by default. If user wants to set a different time from the LoRaWAN server, the user needs to set this to 0.
532
533 **AT Command:**
534
535 (% border="1" cellspacing="3" style="background-color:#f2f2f2; width:510px" %)
536 |=(% style="width: 159px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 270px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 80px;background-color:#4F81BD;color:white" %)**Response**
537 |(% style="width:154px" %)AT+SYNCMOD=1|(% style="width:279px" %)Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) The default is zero time zone.|(% style="width:78px" %)(((
538 OK
539 )))
540 |(% style="width:154px" %)AT+SYNCMOD=1,8|(% style="width:279px" %)Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) Set to East eight-time zone.|(% style="width:78px" %)OK
541 |(% style="width:154px" %)AT+SYNCMOD=1,-12|(% style="width:279px" %)Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) Set to West Twelve Time Zone.|(% style="width:78px" %)OK
542
543 **Downlink Command:**
544
545 0x28 01  ~/~/ Same As AT+SYNCMOD=1
546
547 0x28 01 08  ~/~/ Same As AT+SYNCMOD=1,8
548
549 0x28 01 F4  ~/~/ Same As AT+SYNCMOD=1,-12
550
551 0x28 00  ~/~/ Same As AT+SYNCMOD=0
552
553
554 == 2.5  Temperature & Humidity Alarm Feature ==
555
556
557 LSN50V2-S31 work flow with Alarm feature.
558
559
560 [[image:1655972194041-948.png]]
561
562
563 (((
564 User can use (% style="color:#037691" %)** AT+SHTEMP **(%%)and (% style="color:#037691" %)** AT+SHHUM **(%%)command to set the alarm low limit or high limit. Device will check the temperature & Humidity every minute, if the temperature lower than low limit or greater than high limit. LSN50v2-S31 will send an (% style="color:#037691" %)** Alarm packet base on Confirmed Uplink Mode** (%%)to server.
565
566
567 Below is an example of the Alarm Packet.
568
569 [[image:image-20220623161735-10.png||height="514" width="1027"]]
570
571
572 )))
573
574 == 2.6  ​Configure LSN50v2-S31 ==
575
576
577 LSN50V2-S31 supports configuration via LoRaWAN downlink command or AT Commands.
578
579 * Downlink command instructions for different platform: [[Use Note for Server>>doc:Main.WebHome]](IoT LoRaWAN Server)
580 * AT Command Access Instructions:  [[LINK>>||anchor="H4.A0UseATCommand"]]
581
582 (((
583 There are two parts of commands: General one and Special for this model.
584 )))
585
586
587 === 2.6.1 General Configure Commands ===
588
589
590 These commands are to configure:
591
592 * General system settings like: uplink interval.
593 * LoRaWAN protocol & radio related command.
594
595 (((
596 These commands can be found on the wiki:  [[End Device AT Commands and Downlink Commands>>doc:Main.End Device AT Commands and Downlink Command.WebHome]]
597 )))
598
599
600 === 2.6.2 Sensor related commands ===
601
602
603
604 ==== (% style="color:red" %)**Set Temperature Alarm Threshold:**(%%) ====
605
606
607 * (% style="color:#037691" %)**AT Command:**
608
609 **AT+SHTEMP=min,max**
610
611 * When min=0, and max≠0, Alarm higher than max
612 * When min≠0, and max=0, Alarm lower than min
613 * When min≠0 and max≠0, Alarm higher than max or lower than min
614
615 Example:
616
617 AT+SHTEMP=0,30   ~/~/ Alarm when temperature higher than 30.
618
619
620 * (% style="color:#037691" %)**Downlink Payload:**
621
622 **0x(0C 01 00 1E)**  ~/~/Set AT+SHTEMP=0,30
623
624 (% style="color:red" %)**(note: 3^^rd^^ byte= 0x00 for low limit(not set), 4^^th^^ byte = 0x1E for high limit: 30)**
625
626
627
628 ==== (% style="color:red" %)**Set Humidity Alarm Threshold:**(%%) ====
629
630
631 * (% style="color:#037691" %)**AT Command:**
632
633 **AT+SHHUM=min,max**
634
635 * When min=0, and max≠0, Alarm higher than max
636 * When min≠0, and max=0, Alarm lower than min
637 * When min≠0 and max≠0, Alarm higher than max or lower than min
638
639 Example:
640
641 AT+SHHUM=70,0   ~/~/ Alarm when humidity lower than 70%.
642
643
644 * (% style="color:#037691" %)**Downlink Payload:**
645
646 **0x(0C 02 46 00)**  ~/~/Set AT+SHTHUM=70,0
647
648 (% style="color:red" %)**(note: 3^^rd^^ byte= 0x46 for low limit (70%), 4^^th^^ byte = 0x00 for high limit (not set))**
649
650
651
652 ==== (% style="color:red" %)**Set Alarm Interval:**(%%) ====
653
654
655 The shortest time of two Alarm packet. (unit: min)
656
657 * (% style="color:#037691" %)**AT Command:**
658
659 **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.
660
661
662 * (% style="color:#037691" %)**Downlink Payload:**
663
664 **0x(0D 00 1E)**     **~-~--> ** Set AT+ATDC=0x 00 1E = 30 minutes
665
666
667
668 ==== (% style="color:red" %)**Poll the Alarm settings:**(%%) ====
669
670
671 Send a LoRaWAN downlink to ask device send Alarm settings.
672
673 * (% style="color:#037691" %)**Downlink Payload:**
674
675 0x0E 01
676
677
678 **Example:**
679
680 [[image:1655972693463-687.png]]
681
682 **Explain:**
683
684 * Alarm & MOD bit is 0x7C, 0x7C >> 2 = 0x31: Means this message is the Alarm settings message.
685
686 == 2.7  LED Status ==
687
688
689 LSN50-v2-S31 has an internal LED, it will active in below situation:
690
691 * LED will fast blink 5 times when boot, this means the temperature sensor is detected.
692 * After the fast blinks on boot, the LED will flash once which means device is trying to send Join Packet to the network.
693 * If device successful join LoRaWAN network, the LED will be solid on for 5 seconds.
694
695 == 2.8  Button Function ==
696
697
698 (((
699 **Internal RESET button:**
700 )))
701
702 (((
703 Press this button will reboot the device. Device will process OTAA Join to network again.
704 )))
705
706
707 == (% style="color:inherit; font-family:inherit; font-size:26px" %)2.9  ​Firmware Change Log(%%) ==
708
709
710 Firmware version and change log please see: [[**See this link**>>https://www.dropbox.com/sh/ywkhwu95amzsyvi/AAAwj6H6TIuNyaHrL6ec3aPga?dl=0]]**.**
711
712
713 = 3. Battery & Power Consumption =
714
715
716 LSN50v2-S31 uses ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
717
718 [[**Battery Info & Power Consumption Analyze**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
719
720
721 = 4.  Use AT Command =
722
723 == 4.1  Access AT Commands ==
724
725
726 User can use a USB to TTL adapter to connect to LSN50V2-S31 to use AT command to configure the device. Example is as below:
727
728
729 [[image:image-20220623095817-4.png||height="665" width="1032"]]
730
731 (% style="display:none" %) (%%)
732
733 [[image:image-20220623100044-7.png]]
734
735
736 = 5.  FAQ =
737
738 == 5.1 What is the frequency range of LSN50v2-S31? ==
739
740
741 Different LSN50V2-S31 version supports different frequency range, below is the table for the working frequency and recommend bands for each model:
742
743 (% border="1" cellspacing="3" style="width:510px" %)
744 |(% style="background-color:#4f81bd; color:white; width:70px" %)**Version**|(% style="background-color:#4f81bd; color:white; width:70px" %)**LoRa IC**|(% style="background-color:#4f81bd; color:white; width:124px" %)**Working Frequency**|(% style="background-color:#4f81bd; color:white; width:123px" %)**Best Tune Frequency**|(% style="background-color:#4f81bd; color:white; width:123px" %)**Recommend Bands**
745 |(% style="width:70px" %)433|(% style="width:72px" %)SX1278|(% style="width:153px" %)Band2(LF): 410 ~~525 Mhz|(% style="width:163px" %)433Mhz|(% style="width:152px" %)CN470/EU433
746 |(% style="width:70px" %)868|(% style="width:72px" %)SX1276|(% style="width:153px" %)Band1(HF):862~~1020 Mhz|(% style="width:163px" %)868Mhz|(% style="width:152px" %)EU868/IN865/RU864
747 |(% style="width:70px" %)915|(% style="width:72px" %)SX1276|(% style="width:153px" %)Band1(HF):862 ~~1020 Mhz|(% style="width:163px" %)915Mhz|(% style="width:152px" %)(((
748 AS923/AU915/
749 KR920/US915
750 )))
751
752 == 5.2 What is the Frequency Plan? ==
753
754
755 Please refer Dragino End Node Frequency Plan:  [[End Device Frequency Band>>doc:Main.End Device Frequency Band.WebHome]]
756
757
758 == 5.3 How to update the firmware? ==
759
760
761 (((
762 User can upgrade the firmware for:
763 )))
764
765 * (((
766 (((
767 Support new features
768 )))
769 )))
770 * (((
771 (((
772 For bug fix
773 )))
774 )))
775 * (((
776 (((
777 Change LoRaWAN bands.
778 )))
779 )))
780
781 (((
782 Please see this link for how to upgrade: ** **[[Firmware Upgrade Instruction>>doc:Main.Firmware Upgrade Instruction for STM32 base products.WebHome]]
783 )))
784
785 firmware location:[[Firmware - Dropbox>>url:https://www.dropbox.com/scl/fo/ztlw35a9xbkomu71u31im/ABkxBmsLQecvQawVIJBH-kw/LoRaWAN%20End%20Node/LSN50v2-S31-S31B/Firmware?dl=0&rlkey=ojjcsw927eaow01dgooldq3nu&subfolder_nav_tracking=1]]
786
787 = 6.  Trouble Shooting =
788
789 == 6.1  AT Command input doesn't work ==
790
791
792 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.
793
794
795 == 6.2 Abnormal temperature ==
796
797
798 When the temperature is displayed as - 0.1, it means that the sensor is not connected.
799
800 Please check whether the wiring is loose/Blocked by the insulation layer of the wire/pin damaged
801
802
803 = 7.  Order Info =
804
805
806 **Part Number:  ** (% style="color:blue" %)**LSN50V2-S31-XXX**(%%)**  Or  (% style="color:blue" %)LSN50V2-S31B-XXX (%%)**
807
808 (% style="color:blue" %)**XXX**(%%)**: **The default frequency band
809
810 * (% style="color:red" %)**AS923 **(%%)**:** LoRaWAN AS923 band
811 * (% style="color:red" %)**AU915 **(%%)**:** LoRaWAN AU915 band
812 * (% style="color:red" %)**EU433 **(%%)**:** LoRaWAN EU433 band
813 * (% style="color:red" %)**EU868 **(%%)**:** LoRaWAN EU868 band
814 * (% style="color:red" %)**KR920 **(%%)**:** LoRaWAN KR920 band
815 * (% style="color:red" %)**US915 **(%%)**:** LoRaWAN US915 band
816 * (% style="color:red" %)**IN865 **(%%)**:** LoRaWAN IN865 band
817 * (% style="color:red" %)**CN470 **(%%)**:** LoRaWAN CN470 band
818
819 = 8. ​ Packing Info =
820
821
822 (((
823 **Package Includes**:
824 )))
825
826 * (((
827 (% style="color:blue" %)**LSN50V2-S31**(%%) **or** (% style="color:blue" %)**LSN50V2-S31B**(%%) LoRaWAN Temperature Sensor x 1
828
829
830 )))
831
832 (((
833 **Dimension and weight**:
834 )))
835
836 * Device Size: cm
837 * Device Weight: g
838 * Package Size / pcs : cm
839 * Weight / pcs : g
840
841 = 9.  ​Support =
842
843
844 * 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.
845 * 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]].
Copyright ©2010-2024 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0