LSN50 & LSN50-V2 - LoRaWAN Sensor Node User Manual

(% 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

= 1. Introduction =

== 1.1 What is LSN50 LoRa Sensor Node ==

(((

(((

LSN50 is a Long Range LoRaWAN Sensor Node. It is designed for (% style="color:#4472c4" %)**outdoor data logging **(%%)and powered by (% style="color:#4472c4" %)**Li/SOCl2 battery**(%%) for long term use and secure data transmission. It is designed to facilitate developers to quickly deploy industrial level LoRa and IoT solutions. It helps users to turn the idea into a practical application and make the Internet of Things a reality. It is easy to program, create and connect your things everywhere.

)))

(((

It is based on SX1276/SX1278 allows the user 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. It targets professional wireless sensor network applications such as irrigation systems, smart metering, smart cities, smartphone detection, building automation, and so on.

)))

(((

(% style="color:#4472c4" %)**LSN50**(%%) uses STM32l0x chip from ST, STML0x is the (% style="color:#4472c4" %)**ultra-low-power**(%%) STM32L072xx microcontrollers incorporate the connectivity power of the universal serial bus (USB 2.0 crystal-less) with the high-performance ARM® Cortex®-M0+ 32-bit RISC core operating at a 32 MHz frequency, a memory protection unit (MPU), high-speed embedded memories (192 Kbytes of Flash program memory, 6 Kbytes of data EEPROM and 20 Kbytes of RAM) plus an extensive range of enhanced I/Os and peripherals.

)))

(((

LSN50 is an (% style="color:#4472c4" %)**open source product**(%%), it is based on the STM32Cube HAL drivers and lots of libraries can be found in ST site for rapid development.

)))

)))

[[image:1656294562709-486.png]]

== 1.2 Specifications ==

62

63

64

(% style="color:#037691" %)**Micro Controller:**

* STM32L072CZT6 MCU

* MCU: STM32L072CZT6

* Flash: 192KB

* RAM: 20KB

* EEPROM: 6KB

* Clock Speed: 32Mhz

(% style="color:#037691" %)**Common DC Characteristics:**

74

75

* Supply Voltage: 2.1v ~~ 3.6v

76

* Operating Temperature: -40 ~~ 85°C

77

* I/O pins: Refer to STM32L072 datasheet

78

79

(% style="color:#037691" %)**LoRa Spec:**

* Frequency Range,

** Band 1 (HF): 862 ~~ 1020 Mhz

or

*

** Band 2 (LF): 410 ~~ 528 Mhz

89

* 168 dB maximum link budget.

90

* +20 dBm - 100 mW constant RF output vs.

91

* +14 dBm high efficiency PA.

92

* Programmable bit rate up to 300 kbps.

93

* High sensitivity: down to -148 dBm.

94

* Bullet-proof front end: IIP3 = -12.5 dBm.

95

* Excellent blocking immunity.

96

* Low RX current of 10.3 mA, 200 nA register retention.

97

* Fully integrated synthesizer with a resolution of 61 Hz .

98

* FSK, GFSK, MSK, GMSK, LoRaTM and OOK modulation.

99

* Built-in bit synchronizer for clock recovery.

100

* Preamble detection.

101

* 127 dB Dynamic Range RSSI.

102

* Automatic RF Sense and CAD with ultra-fast AFC.

103

* Packet engine up to 256 bytes with CRC.

104

* LoRaWAN 1.0.2 Specification

105

106

(% style="color:#037691" %)**Battery:**

107

108

* Li/SOCI2 un-chargeable battery

109

* Capacity: 4000mAh

110

* Self Discharge: <1% / Year @ 25°C

111

* Max continuously current: 130mA

112

* Max boost current: 2A, 1 second

113

114

(% style="color:#037691" %)**Power Consumption**

115

116

* STOP Mode: 2.7uA @ 3.3v

117

* LoRa Transmit Mode: 125mA @ 20dBm 44mA @ 14dBm

== 1.3 Features ==

* LoRaWAN 1.0.3 Class A, Class C

122

* STM32L072CZT6 MCU

123

* SX1276/78 Wireless Chip

124

* Pre-load bootloader on USART1/USART2

125

* MDK-ARM Version 5.24a IDE

126

* I2C, LPUSART1, USB, SPI2

127

* 3x12bit ADC, 1x12bit DAC

* 20xDigital I/Os

* LoRa™ Modem

* Preamble detection

* Baud rate configurable

132

* CN470/EU433/KR920/US915/IN865

133

* EU868/AS923/AU915

134

* Open-source hardware / software

135

* Available Band:433/868/915/920 Mhz

136

* IP66 Waterproof Enclosure

137

* Ultra-Low Power consumption

138

* AT Commands to change parameters

139

* 4000mAh or 8500mAh Battery for long term use。

140

141

== 1.4 Applications ==

142

143

144

* Smart Buildings & Home Automation

145

* Logistics and Supply Chain Management

* Smart Metering

* Smart Agriculture

* Smart Cities

* Smart Factory

(% 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" %)(%%)

== 1.5 Pin Definitions and Switch ==

156

157

(% class="wikigeneratedid" %)

158

[[image:1656295519542-152.png||height="413" width="728"]]

159

160

161

(% class="wikigeneratedid" %)

162

[[image:1656295532863-613.png||height="371" width="721"]]

163

164

165

(% class="wikigeneratedid" %)

166

[[image:image-20220627101527-1.png]]

167

168

(% class="wikigeneratedid" style="display:none" %)

=== 1.5.1 Jumper JP2 ===

173

174

Power on Device when put this jumper.

175

176

177

=== 1.5.2 BOOT MODE / SW1 ===

178

179

(((

180

~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.

)))

(((

2. Flash: work mode, device starts to work and send out console output for further debug

)))

=== 1.5.3 Reset Button ===

189

190

Press to reboot the device.

=== 1.5.4 LED ===

It will flash:

1. When boot the device in flash mode

198

1. Send an uplink packet

199

200

=== 1.6 Hardware Change log ===

201

202

Note: Hardware version is marked in the PCB.

**LSN50 v2.1:**

1. Change R14 to 1M ohm

207

1. Change R3, R4 to 4.7Kohm. So no need to modify them for 3 DS18B20 connection.

208

1. Add ESD to each I/O

**LSN50 v2.0:**

* Change to a new enclosure. Improve with external antenna, IP68, ear hook.

**LSN50 v1.3**:

* Add P-MOS to control 5V output

**LSN50 v1.2**:

* Add LED. Turn on for every LoRa transmit

221

* Add pin PA4, PB13, NRST

222

* Add 5V Output, on/off control by PB5(Low to Enable, High to Disable)

223

224

== (% id="cke_bm_478801S" style="display:none" %) (%%)1.7 Hole Option ==

225

226

The LSN50 provides different hole size options for different size sensor cable. The options provided are M12, M16 and M20. The definition is as below:

227

228

[[image:image-20220627104757-1.png]]

229

230

231

[[image:1656298089706-973.png]]

= 2. Use LSN50 with LoRaWAN firmware =

236

237

== 2.1 How it works ==

(((

(((

The LSN50 is pre-loaded with a firmware and is configured as LoRaWAN OTAA Class A mode by default. It has OTAA keys to join LoRaWAN network. To connect a local LoRaWAN network, you just need to input the OTAA keys in the LoRaWAN IoT server and power on the LSN50. It will automatically join the network via OTAA.

)))

(((

)))

(((

The diagram below shows the working flow in default firmware (ver 1.7.0):

)))

[[image:image-20220627104855-2.png]]

254

255

256

In case you can't set the OTAA keys in the LoRaWAN OTAA server, and you have to use the keys from the server, you can [[use AT Commands>>doc:Main.End Device AT Commands and Downlink Command.WebHome]] to set the keys in the LSN50.

)))

== 2.2 Quick guide to connect to LoRaWAN server (OTAA) ==

261

262

(((

263

Following is an example for how to join the [[TTN V3 LoRaWAN Network>>url:http://www.thethingsnetwork.org/]]. Below is the network structure; we use the [[LG308>>url:http://www.dragino.com/products/lora/item/140-lg308.html]] as a LoRaWAN gateway in this example.

264

265

(% 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:1656298385089-555.png]]

)))

(% title="Click and drag to resize" %)(%%)The LG308 is already set to connected to [[TTN V3 network >>url:https://www.thethingsnetwork.org/]], so what we need to now is configure the TTN V3 server.(% 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" %)(%%)

(((

(% style="color:blue" %)**Step 1**(%%): Create a device in TTN with the OTAA keys from LSN50.

276

277

Each LSN50is shipped with a sticker with the default device EUI as below:

)))

(((

)))

(% aria-label="image-20220607170145-1.jpeg image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220607170145-1.jpeg||data-widget="image"]](% 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"]](% 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" %)(% 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" %)(%%)

(((

You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:

289

290

**Register the device：**

291

)))

292

293

(% 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" %)(% title="Click and drag to resize" %)(% aria-label="1654935135620-998.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:1654935135620-998.png||data-widget="image"]](% 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"]](%%)(% 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" %)(% title="Click and drag to resize" %)

294

295

(% 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" %)(% title="Click and drag to resize" %)

296

297

298

**Add APP EUI and DEV EUI：**

299

300

301

(% aria-label="image-20220611161308-4.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220611161308-4.png||data-widget="image" height="551" width="753"]](% 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"]](% title="Click and drag to resize" %)

**Add APP EUI in the application：**

306

307

308

(% aria-label="image-20220611161308-5.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220611161308-5.png||data-widget="image" height="601" width="742"]](% 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"]](% title="Click and drag to resize" %)

**Add APP KEY**

(% aria-label="image-20220611161308-6.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220611161308-6.png||data-widget="image" height="485" width="744"]](% 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"]](% title="Click and drag to resize" %)

314

315

(% 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" %)

316

317

(% 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" %)(%%)

318

319

(% style="color:blue" %)**Step 2**(%%): Power on LSN50

320

321

Put a Jumper on JP2 to power on the device.(% style="display:none" %)

322

323

[[image:image-20220627145643-5.png]](% style="display:none" %)

324

325

(% style="display:none" %)

326

327

328

(% style="display:none" %) (%%)

**For LSn50v2:**

[[image:1656313034748-905.png]](% style="display:none" %)

333

334

335

(% 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" %)(% 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" %)(%%)

(((

(((

(% style="color:blue" %)**Step 3**(%%)**:** The LSN50 will auto join to the TTN V3 network. After join success, it will start to upload messages to TTN V3 and you can see the messages in the panel.

)))

)))

(% 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" %)(% title="Click and drag to resize" %)[[image:1656312908855-552.png]](% 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"]]

344

345

(% 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" %)(% title="Click and drag to resize" %)

346

347

348

== 2.3 Working Mode & Uplink Payload ==

349

350

LSN50 has different working mode for the connections of different type of sensors. This section describes these modes. Use can use the AT Command AT+MOD to set LSN50 to different working modes.

For example:

(% style="color:red" %)**AT+MOD=2**(%%) ~/~/ will set the LSN50 to work in MOD=2 distance mode which target to measure distance via Ultrasonic Sensor.

355

356

357

(% style="color:red" %)**NOTE:**

358

359

(% style="color:red" %)1. Some working modes has payload more than 12 bytes, The US915/AU915/AS923 frequency bands’ definition has maximum 11 bytes in **DR0**. Server sides will see NULL payload while LSn50 transmit in DR0 with 12 bytes payload.

360

2. All modes share the same Payload Explanation from HERE.

361

3. By default, the device will send an uplink message every 5 minutes.

362

363

(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:400px" %)

364

|=(% style="width: 62.5px;" %)(((

365

**Size (bytes)**

366

367

|(% style="width:65px" %)**Value**|(((

368

[[Battery>>||anchor="HBattery:"]]

369

)))|(% style="width:61px" %)(((

370

ignore

371

)))|(% style="width:91px" %)(((

372

[[Alarm Flag>>||anchor="HAlarmFlag26MOD:"]]

373

)))|(% style="width:99px" %)(((

374

[[Temperature>>||anchor="HTemperature:"]]

375

)))|(% style="width:97px" %)(((

376

[[Humidity>>||anchor="HHumidity:"]]

377

)))

378

379

=== 2.3.1 MOD~=1 (Default Mode) ===

380

381

(((

382

In this mode, uplink payload includes in total 11 bytes. Uplink packets use FPORT=2.

383

384

385

|**Size(bytes)**|**2**|**2**|**2**|**1**|**2**|**2**

|**Value**|BAT|(((

Temperature

(DS18B20)

)))|ADC|Digital in & Digital Interrupt|(((

391

Temperature

392

393

(SHT20 or SHT31 or Ultrasonic Sensor)

)))|(((

Humidity

(SHT20)

)))

[[image:image-20220627150949-6.png]]

)))

==== ====

== 2.5 Configure LSN50v2-S31 ==

412

413

LSN50V2-S31 supports configuration via LoRaWAN downlink command or AT Commands.

414

415

* Downlink command instructions for different platform: [[Use Note for Server>>doc:Main.WebHome]](IoT LoRaWAN Server)

416

* AT Command Access Instructions: [[LINK>>||anchor="H4.A0UseATCommand"]]

417

418

(((

419

There are two parts of commands: General one and Special for this model.

)))

=== 2.5.1 General Configure Commands ===

425

426

These commands are to configure:

427

428

* General system settings like: uplink interval.

429

* LoRaWAN protocol & radio related command.

430

431

(((

432

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]]

)))

=== 2.5.2 Sensor related commands ===

438

439

440

==== (% style="color:red" %)**Set Temperature Alarm Threshold:**(%%) ====

441

442

* (% style="color:#037691" %)**AT Command:**

443

444

**AT+SHTEMP=min,max**

445

446

* When min=0, and max≠0, Alarm higher than max

447

* When min≠0, and max=0, Alarm lower than min

448

* When min≠0 and max≠0, Alarm higher than max or lower than min

Example:

AT+SHTEMP=0,30 ~/~/ Alarm when temperature higher than 30.

453

454

455

* (% style="color:#037691" %)**Downlink Payload:**

456

457

**0x(0C 01 00 1E)** ~/~/Set AT+SHTEMP=0,30

458

459

(% style="color:red" %)(note: 3^^rd^^ byte= 0x00 for low limit(not set), 4^^th^^ byte = 0x1E for high limit: 30)

==== (% style="color:red" %)**Set Humidity Alarm Threshold:**(%%) ====

464

465

* (% style="color:#037691" %)**AT Command:**

**AT+SHHUM=min,max**

* When min=0, and max≠0, Alarm higher than max

470

* When min≠0, and max=0, Alarm lower than min

471

* When min≠0 and max≠0, Alarm higher than max or lower than min

Example:

AT+SHHUM=70,0 ~/~/ Alarm when humidity lower than 70%.

476

477

478

* (% style="color:#037691" %)**Downlink Payload:**

479

480

**0x(0C 02 46 00)** ~/~/Set AT+SHTHUM=70,0

481

482

(% style="color:red" %)(note: 3^^rd^^ byte= 0x46 for low limit (70%), 4^^th^^ byte = 0x00 for high limit (not set))

==== (% style="color:red" %)**Set Alarm Interval:**(%%) ====

487

488

The shortest time of two Alarm packet. (unit: min)

489

490

* (% style="color:#037691" %)**AT Command:**

491

492

**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.

493

494

495

* (% style="color:#037691" %)**Downlink Payload:**

496

497

**0x(0D 00 1E)** **~-~-->** Set AT+ATDC=0x 00 1E = 30 minutes

==== (% style="color:red" %)**Poll the Alarm settings:**(%%) ====

502

503

Send a LoRaWAN downlink to ask device send Alarm settings.

504

505

* (% style="color:#037691" %)**Downlink Payload:**

0x0E 01

**Example:**

[[image:1655972693463-687.png]]

**Explain:**

* Alarm & MOD bit is 0x7C, 0x7C >> 2 = 0x31: Means this message is the Alarm settings message.

== 2.6 LED Status ==

LSN50-v2-S31 has an internal LED, it will active in below situation:

521

522

* LED will fast blink 5 times when boot, this means the temperature sensor is detected.

523

* After the fast blinks on boot, the LED will flash once which means device is trying to send Join Packet to the network.

524

* If device successful join LoRaWAN network, the LED will be solid on for 5 seconds.

525

526

== 2.7 Button Function ==

527

528

(((

529

**Internal RESET button:**

)))

(((

Press this button will reboot the device. Device will process OTAA Join to network again.

)))

== (% style="color:inherit; font-family:inherit; font-size:26px" %)2.8 Firmware Change Log(%%) ==

538

539

Firmware version and change log please see: [[**See this link**>>url:http://www.dragino.com/downloads/index.php?dir=LSN50-LoRaST/Firmware/LSN50.hex/]]**.**

= 3. Battery Info =

(((

The LSN50v2-S31 battery is a combination of a 8500mAh ER26500 Li/SOCI2 Battery and a Super Capacitor. The battery is non-rechargeable battery type with a low discharge rate (<2% per year). This type of battery is commonly used in IoT devices such as water meter.

)))

(((

The battery is designed to last for more than 5 years for the LSN50v2-S31.

)))

(((

The battery related documents can be found as below:

)))

(((

[[http:~~/~~/www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]

)))

(((

The connector is as below incase user want to use their own battery

564

)))

565

566

(% aria-label="image-20220607172042-11.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220607172042-11.png||data-widget="image"]](% 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"]](% 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; left:0px; top:-15px" 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:url(~"http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png~") rgba(220, 220, 220, 0.5); left:0px; top:-15px" tabindex="-1" %)(%%)

567

568

(((

569

There are several parameters affect the battery power. Please see consumption report from here for the detail explain:

)))

(((

[[http:~~/~~/www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LSN50v2-S31/Test_Report/>>url:http://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LSN50v2-D20/Test_Report/]]

)))

(((

)))

= 4. Use AT Command =

582

583

== 4.1 Access AT Commands ==

584

585

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:

586

587

588

[[image:image-20220623095817-4.png||height="665" width="1032"]]

589

590

(% style="display:none" %) (%%)

591

592

[[image:image-20220623100044-7.png]]

593

594

595

= 4. Upload Firmware =

596

597

(% style="color:red" %)**Notes**:

598

599

* Since image v1.3, the firmware will show version info during boot. If your device doesn't show version info, you may have a very old image version.

600

* Always run AT+FDR to reset parameters to factory default after an update image.

601

If the update is from image >= v1.3 to another image version >=v1.3, then the keys will be kept after running AT+FDR.

602

Otherwise (e.g. from v1.2 to v1.3), AT+FDR may erase the keys.

== 4.1 Upload Firmware via Serial Port ==

608

609

The LSN50's AT Command port can be used for firmware upgrade. The hardware connection for upgrade firmware is as below:

610

611

612

[[image:image-20220627163506-18.png||height="426" width="418"]]

613

614

615

(% style="color:blue" %)**Step1**(%%)**:** Download [[flash loader>>url:https://www.st.com/content/st_com/en/products/development-tools/software-development-tools/stm32-software-development-tools/stm32-programmers/flasher-stm32.html]].

616

617

618

(% style="color:blue" %)**Step2**(%%)**:** Download the [[LSN50 Image files>>url:https://github.com/dragino/LoRa_STM32/tree/master/LSN50.hex]].

619

620

621

(% style="color:blue" %)**Step3**(%%)**: **Open flashloader; choose the correct COM port to update

622

623

[[image:image-20220627163821-19.png]]

624

625

626

[[image:image-20220627163930-20.png||height="450" width="751"]]

627

628

629

[[image:image-20220627164030-21.png||height="459" width="750"]]

630

631

(% style="color:blue" %)**Step4**(%%)**: **Switch SW1 back to flash state and push the RESET button.

632

633

The LSN50 will then run the new firmware.

634

635

636

== 4.2 Upload Firmware via ST-Link V2 ==

637

638

You can use ST-LINK to upgrade firmware into LSN50. The hardware connection for upgrade firmware is as below:

639

640

[[image:1656319349131-664.png]]

Connection:

* ST-LINK v2 GND <~-~-> LSN50 GND

645

* ST-LINK v2 SWCLK <~-~-> LSN50 PA14

646

* ST-LINK v2 SWDIO <~-~-> LSN50 PA13

647

* ST-LINK v2 RST <~-~->LSN50 NRST.

648

649

(% style="color:blue" %)**Step1:**(%%) Install [[ST-LINK driver>>url:https://www.stmicroelectronics.com.cn/content/st_com/en/products/development-tools/software-development-tools/stm32-software-development-tools/stm32-utilities/stsw-link009.html]] first and then install [[ST-LINK Utility>>url:https://www.st.com/content/st_com/en/products/development-tools/software-development-tools/stm32-software-development-tools/stm32-programmers/stsw-link004.html]]

650

651

652

(% style="color:blue" %)**Step2**(%%): Download the [[LSN50 Image files>>url:https://github.com/dragino/LoRa_STM32/tree/master/LSN50.hex]].

653

654

655

(% style="color:blue" %)**Step3:**(%%)** **Open ST-LINK utility, (% style="color:blue" %)**file ~-~-> open file**(%%) to select the image to be upgraded.

656

657

658

(% style="color:blue" %)**Step4:**(%%)** **Click the “(% style="color:blue" %)**Program Verify**”(%%) button on ST-LINK.

659

660

661

[[image:image-20220627164303-22.png]]

662

663

664

(% style="color:blue" %)**Step5:**(%%)** **The led on the ST-LINK adapter will now blinking, and the ST-Link utility will pop up a download window. Click the start button to download the image to LSN50.

665

666

667

(% style="color:red" %)NOTE: If this step fails, ST-LINK can't establish connection to LSN50, please try to swap SWDIO & SWCLK pin. Some ST-LINK v2 devices are incorrectly marked.

668

669

670

[[image:image-20220627164303-23.png]]

= 5. Developer Guide =

675

676

(% style="display:none" %)

677

678

* Software Source Code Download : [[https:~~/~~/github.com/dragino/LoRa_STM32/tree/master/STM32CubeExpansion_LRWAN>>https://github.com/dragino/LoRa_STM32/tree/master/STM32CubeExpansion_LRWAN]]

679

* Hardware Source Code Download: [[https:~~/~~/github.com/dragino/Lora/tree/master/LSN50>>https://github.com/dragino/Lora/tree/master/LSN50]]

680

681

LSN50 is an open source project, developer can use compile their firmware for customized applications. User can get the source code from:

682

683

* Software Source Code: [[https:~~/~~/github.com/dragino/LoRa_STM32/tree/master/STM32CubeExpansion_LRWAN>>url:https://github.com/dragino/LoRa_STM32/tree/master/STM32CubeExpansion_LRWAN]]

684

* Hardware Design files: [[https:~~/~~/github.com/dragino/Lora/tree/master/LSN50>>url:https://github.com/dragino/Lora/tree/master/LSN50]]

685

* Compile instruction: [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Compile%20Instruction%20~~-~~-%20STM32/>>http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Compile%20Instruction%20--%20STM32/]]

686

687

Use Keil to open project file:

688

689

STM32CubeExpansion_LRWAN/Projects/Multi/Applications/LoRa/DRAGINO-LRWAN(AT)/MDK-ARM/STM32L072CZ-Nucleo/Lora.uvprojx

690

691

692

In Keil, you can see what frequency band the code support.

693

694

[[image:image-20220627162417-15.png]]

695

696

697

~1. If you want to change frequency, modify the Preprocessor Symbols.

698

For example, change EU868 to US915

699

700

[[image:1656318662202-530.png]]

701

702

[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image002.emz]]

2. Compile and build

[[image:image-20220627163212-17.png]]

= 6. FAQ =

== 6.1 Why there is 433/868/915 version? ==

713

714

(((

715

Different countries have different rules for the ISM band for LoRa. Although the LoRa chip can support a wide range of Frequencies, we provide different versions of the hardware for best tune of the LoRa hardware part.

)))

== 6.2 What is the frequency range of LT LoRa part? ? ==

720

721

Different LT version supports different frequency range, below is the table for the working frequency and recommend bands for each model:

722

723

[[image:image-20220627155456-9.png]]

== 6.3 How to change the LoRa Frequency Bands/Region? ==

728

729

You can follow the instructions for [[how to upgrade image>>path:#3ygebqi]].

730

When downloading the images, choose the required image file for download.

731

732

733

== 6.4 Can I use Private LoRa protocol? ==

(((

(((

The stock firmware is based on LoRaWAN protocol. You can use a private LoRa protocol in LSN50. This section describes an example for base LoRa transfer. It is a reference/demo and we do not provide further software development support on this topic.

)))

(((

In this demo, we will show the communication between LoRa Shield and LSN50, both of them using the basic LoRa library. LSN50 will send a message to a LoRa Shield and the LoRa Shield will print it to the console.

)))

)))

(% style="color:#4472c4" %)**LoRa Shield + UNO**:

748

749

Use the [[LoRa Library>>url:http://www.dragino.com/downloads/index.php?dir=LSN50-LoRaST/LoRa_Raw_Example/Arduino/&file=LoRa.zip]] and upload the [[LoRa Receive>>http://www.dragino.com/downloads/downloads/LSN50-LoRaST/LoRa_Raw_Example/Arduino/LoRaReceiver.ino]] Sketch to Arduino.

Refs:

[[http:~~/~~/www.dragino.com/downloads/index.php?dir=LSN50-LoRaST/LoRa_Raw_Example/Arduino/&file=LoRa.zip>>url:http://www.dragino.com/downloads/index.php?dir=LSN50-LoRaST/LoRa_Raw_Example/Arduino/&file=LoRa.zip]]

755

756

[[http:~~/~~/www.dragino.com/downloads/downloads/LSN50-LoRaST/LoRa_Raw_Example/Arduino/LoRaReceiver.ino>>url:http://www.dragino.com/downloads/downloads/LSN50-LoRaST/LoRa_Raw_Example/Arduino/LoRaReceiver.ino]]

757

758

759

Open the serial monitor to Arduino. The device acts as a LoRa Receiver and listen on the frequency 868.3Mhz by default.

760

761

762

(% style="color:#4472c4" %)**LSN50**:

763

764

Use the <[[LoRa RAW code>>url:http://www.dragino.com/downloads/index.php?dir=LSN50-LoRaST/LoRa_Raw_Example/LSN50/&file=lora_send.zip]]> . The project file is in: MDK-ARM\STM32L072CZ-Nucleo\ Lora.uvprojx

765

766

[[Compile>>path:#19c6y18]] it and [[Upload>>path:#3ygebqi]] it to LSN50, the LSN50 will transfer on the frequency 868.3Mhz.

767

768

In the Arduino Console, it will see the received packets as below.

769

770

771

[[image:image-20220627160116-10.png]]

772

773

774

== 6.5 How to set up LSN50 to work in 8 channel mode ==

775

776

By default, the frequency bands US915, AU915, CN470 work in 72 frequencies. Many gateways are 8 channel gateways, and in this case, the OTAA join time and uplink schedule is long and unpredictable while the end node is hopping in 72 frequencies.

777

778

You can configure the end node to work in 8 channel mode by using the AT+CHE command. The 500kHz channels are always included for OTAA.

779

780

781

For example, in (% style="color:blue" %)**US915**(%%) band, the frequency table is as below. By default, the end node will use all channels (0~~71) for OTAA Join process. After the OTAA Join, the end node will use these all channels (0~~71) to send uplink packets.

782

783

[[image:image-20220627160940-13.png]]

784

785

786

When you use the TTN V3 network, the US915 frequency bands use are:

787

788

* 903.9 - SF7BW125 to SF10BW125

789

* 904.1 - SF7BW125 to SF10BW125

790

* 904.3 - SF7BW125 to SF10BW125

791

* 904.5 - SF7BW125 to SF10BW125

792

* 904.7 - SF7BW125 to SF10BW125

793

* 904.9 - SF7BW125 to SF10BW125

794

* 905.1 - SF7BW125 to SF10BW125

795

* 905.3 - SF7BW125 to SF10BW125

796

* 904.6 - SF8BW500

797

798

Because the end node is now hopping in 72 frequency, it makes it difficult for the devices to Join the TTN V3 network and uplink data. To solve this issue, you can access the device via the AT commands and run:

799

800

(% style="color:blue" %)**AT+CHE=2**

801

802

(% style="color:blue" %)**ATZ**

803

804

805

to set the end node to work in 8 channel mode. The device will work in Channel 8-15 & 64-71 for OTAA, and channel 8-15 for Uplink.

806

807

The (% style="color:blue" %)**AU915**(%%) band is similar. Below are the AU915 Uplink Channels.

808

809

[[image:image-20220627161124-14.png]]

810

811

812

== 6.6 How to set up LSN50 to work with Single Channel Gateway such as LG01/LG02? ==

813

814

In this case, users need to set LSN50 to work in ABP mode and transmit in only one frequency.

815

816

Assume we have a LG02 working in the frequency 868400000 now, below is the steps.

817

818

819

(% style="color:blue" %)**Step1: **(%%)Log in TTN V3, Create an ABP device in the application and input the network session key (NETSKEY), app session key (APPSKEY) from the device.

820

821

822

[[image:image-20220627160542-11.png]]

823

824

825

(% style="color:red" %)Note: You need to make sure the above three keys match in the device and in TTN V3. You can change them either in TTN V3 or in the Device to make them match. In TTN V3, NETSKEY and APPSKEY can be configured in the setting page, but the Device Addr is generated by TTN V3.

826

You can also change the Device ADDR in TTN V3 by using the [[The Things Network CLI>>url:https://www.thethingsnetwork.org/docs/network/cli/quick-start.html]].

827

828

829

(% style="color:blue" %)**Step2: **(%%)Run AT commands to make the LSN50 work in Single frequency and ABP mode. Below are the AT commands:

830

831

832

(% style="background-color:#dcdcdc" %)AT+FDR(%%) Reset Parameters to Factory Default, Keys Reserve

833

834

(% style="background-color:#dcdcdc" %)AT+NJM=0(%%) Set to ABP mode

835

836

(% style="background-color:#dcdcdc" %)AT+ADR=0(%%) Set the Adaptive Data Rate Off

837

838

(% style="background-color:#dcdcdc" %)AT+DR=5(%%) Set Data Rate (Set AT+DR=3 for 915 band)

839

840

(% style="background-color:#dcdcdc" %)AT+TDC=300000(%%) Set transmit interval to 5 minutes

841

842

(% style="background-color:#dcdcdc" %)AT+CHS=868400000(%%) Set transmit frequency to 868.4Mhz

843

844

(% style="background-color:#dcdcdc" %)AT+DADDR=26 01 1A F1(%%) Set Device Address to 26 01 1A F1

845

846

(% style="background-color:#dcdcdc" %)ATZ(%%) Reset MCU

As shown below:

[[image:image-20220627160542-12.png]]

852

853

854

== 6.7 How to configure the EUI keys in LSN50? ==

855

856

The early version of LSN50 firmware doesn't have pre-configured keys.

857

It is recommended that you update the image to the latest version before configure the keys. Refer [[upgrade_image>>path:#3ygebqi]] to update the firmware to the latest version.

858

859

Run AT commands to set the keys to desired keys; refer [[AT Command manual>>path:#23ckvvd]].

860

861

862

= 7. Trouble Shooting =

863

864

== 7.1 Connection problem when uploading firmware. ==

865

866

(% style="color:red" %)**Issue**(%%): While using USB to TTL to upload firmware via UART interface. It works for several times but most of times it fails.

867

868

869

(% style="color:green" %)**Checklist**:

870

871

~1. Double check if follow up exactly the steps as manual.

872

873

2. Check if hardware works fine: a) check if AT command works, b) check if ISP / flash switch works: PA12 will have different output level while set the ISP/Flash Switch in different position. c) check if reset button works.

874

875

3. If you use Windows10 system. Please change the flash loader to run in Windows7 compatibility mode.

876

877

878

[[image:image-20220627153421-8.png]]

879

880

4. We have seen cases where the FT232 USB TTL adapter has a reliability issue with the PC USB chipset (Intel). In this case, even though points 1 and 2 above work, it still has a reliability issue for uploading. If this happens, change to a different PC or change the USB to TTL adapter to solve the issue.

881

882

883

== 7.2 Why I can't join TTN V3 in US915 / AU915 bands? ==

884

885

It is due to channel mapping. Please see the [[Eight Channel Mode>>path:#206ipza]] section above for details.

886

887

888

7.3 AT Command input doesn't work

889

890

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:red" %)**ENTER**(%%) while sending out the command. Some serial tool doesn't send (% style="color:red" %)**ENTER**(%%) while press the send key, user need to add ENTER in their string.

= 8. Order Info =

Part Number: (% style="color:blue" %)**LSN50-XX-YY **(%%)**or (% style="color:blue" %)LSN50-XX-YY-ZZ(%%)**

897

898

899

(% style="color:blue" %)**XX**(%%): The default frequency band

900

901

* (% style="color:red" %)**AS923 **(%%)**:** LoRaWAN AS923 band

902

* (% style="color:red" %)**AU915 **(%%)**:** LoRaWAN AU915 band

903

* (% style="color:red" %)**EU433 **(%%)**:** LoRaWAN EU433 band

904

* (% style="color:red" %)**EU868 **(%%)**:** LoRaWAN EU868 band

905

* (% style="color:red" %)**KR920 **(%%)**:** LoRaWAN KR920 band

906

* (% style="color:red" %)**US915 **(%%)**:** LoRaWAN US915 band

907

* (% style="color:red" %)**IN865 **(%%)**:** LoRaWAN IN865 band

908

* (% style="color:red" %)**CN470 **(%%)**:** LoRaWAN CN470 band

909

910

(% style="color:blue" %)**YY**(%%)**: **Hole Option

911

912

* (% style="color:red" %)**12**(%%): With M12 waterproof cable hole

913

* (% style="color:red" %)**16**(%%): With M16 waterproof cable hole

914

* (% style="color:red" %)**20**(%%): With M20 waterproof cable hole (LSN50 v2 doesn’t have this version)

915

* (% style="color:red" %)**NH**(%%): No Hole

916

917

(% style="color:blue" %)**ZZ**(%%)**: **Battery Option ( Only valid for v2 model)

918

919

* (% style="color:red" %)**4**(%%): with 4000mAh battery

920

* (% style="color:red" %)**8**(%%): with 8500mAg battery

= 9. Packing Info =

(% style="color:blue" %)**For LSN50**(%%)**:**

926

927

**Package Includes**:

928

929

* LSN50 LoRa Sensor Node x 1

930

931

**Dimension and weight**:

932

933

* Device Size: 8 x 6.5 x 5 cm

934

* Device Weight: 137g

935

* Package Size / pcs : 9 x 7 x 6cm

936

* Weight / pcs : 160g

937

938

(% style="color:blue" %)**For LSN50 v2**(%%)**:**

939

940

**Package Includes**:

941

942

* LSN50 v2 LoRa Sensor Node x 1

943

* External antenna x 1

944

* Spring Antenna (evaluate purpose)

945

946

**Dimension and weight**:

947

948

* Device Size: 9.7 x 6.5 x 4.7 cm

949

* Device Weight: 150g

950

* Package Size / pcs : 14.0 x 8x 5 cm

951

* Weight / pcs : 180g

(((

)))

= 10. Support =

* 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.

964

* 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]].

= 11. References =

* [[Product Page>>url:http://www.dragino.com/products/lora/item/128-lsn50.html]]

969

* [[Data Sheet>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/EN/&file=Datasheet_LoRaSensorNode.pdf]]

970

* [[Image Download>>url:https://github.com/dragino/LoRa_STM32/tree/master/LSN50.hex]]

971

* [[Mechanical Drawing>>http://www.dragino.com/downloads/index.php?dir=LSN50-LoRaST/Mechanical_Drawing/]]

972

973

Wiki source code of LSN50 & LSN50-V2 - LoRaWAN Sensor Node User Manual

Applications

Navigation