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, building automation, and so on.

)))

(((

(% style="color:#4472c4" %)**LSN50**(%%) uses STM32l0x chip from ST, STML0x is the (% style="color:#4472c4" %)**ultra-low-power**(%%) STM32L072xxxx 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]]

58

59

60

== 1.2 Specifications ==

61

62

63

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

* MCU: STM32L072xxxx

* Flash: 128KB

* RAM: 20KB

* EEPROM: 6KB

* Clock Speed: 32Mhz

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

73

74

* Supply Voltage: 2.1v ~~ 3.6v

75

* Operating Temperature: -40 ~~ 85°C

76

* I/O pins: Refer to [[STM32L072 datasheet>>https://www.st.com/resource/en/datasheet/stm32l072cz.pdf]]

77

78

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

79

80

* Frequency Range,

81

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

82

* or

83

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

84

* 168 dB maximum link budget.

85

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

86

* +14 dBm high efficiency PA.

87

* Programmable bit rate up to 300 kbps.

88

* High sensitivity: down to -148 dBm.

89

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

90

* Excellent blocking immunity.

91

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

92

* Fully integrated synthesizer with a resolution of 61 Hz .

93

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

94

* Built-in bit synchronizer for clock recovery.

95

* Preamble detection.

96

* 127 dB Dynamic Range RSSI.

97

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

98

* Packet engine up to 256 bytes with CRC.

99

* LoRaWAN 1.0.2 Specification

100

101

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

102

103

* Li/SOCI2 un-chargeable battery

104

* Capacity: 4000mAh

105

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

106

* Max continuously current: 130mA

107

* Max boost current: 2A, 1 second

108

109

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

110

111

* STOP Mode: 2.7uA @ 3.3v

112

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

== 1.3 Features ==

* LoRaWAN 1.0.3 Class A, Class C

119

* STM32L072xxxx MCU

120

* SX1276/78 Wireless Chip

121

* Pre-load bootloader on USART1/USART2

122

* MDK-ARM Version 5.24a IDE

123

* I2C, LPUSART1, USB, SPI2

124

* 3x12bit ADC, 1x12bit DAC

* 20xDigital I/Os

* LoRa™ Modem

* Preamble detection

* Baud rate configurable

129

* CN470/EU433/KR920/US915/IN865

130

* EU868/AS923/AU915/MA869

131

* Open-source hardware / software

132

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

133

* IP66 Waterproof Enclosure

134

* Ultra-Low Power consumption

135

* AT Commands to change parameters

136

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

137

138

139

== 1.4 Applications ==

* Smart Cities

* Smart Factory

* Smart Metering

* Smart Agriculture

* Smart Buildings & Home Automation

147

* Logistics and Supply Chain Management

148

149

150

== 1.5 Pin Definitions and Switch ==

151

152

153

(% class="wikigeneratedid" %)

154

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

155

156

157

(% class="wikigeneratedid" %)

158

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

159

160

161

(% border="1" cellspacing="0" style="width:520px" %)

162

|=(% style="width: 30px;background-color:#D9E2F3;color:#0070C0" %)**No.**|=(% style="width: 70px;background-color:#D9E2F3;color:#0070C0" %)**Signal**|=(% style="width: 60px;background-color:#D9E2F3;color:#0070C0" %)**Direction**|=(% style="width: 180px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 180px;background-color:#D9E2F3;color:#0070C0" %)Remark

163

|(% style="background-color:#f2f2f2; width:44px" %)1|(% style="background-color:#f2f2f2; width:86px" %)VCC(2.9V)|(% style="background-color:#f2f2f2; width:84px" %)OUTPUT|(% style="background-color:#f2f2f2; width:322px" %)VCC|(% style="background-color:#f2f2f2; width:296px" %)Directly connect to main power for board

164

|(% style="background-color:#f2f2f2; width:44px" %)2|(% style="background-color:#f2f2f2; width:86px" %)PA0|(% style="background-color:#f2f2f2; width:84px" %)In/Out|(% style="background-color:#f2f2f2; width:322px" %)Directly from STM32 chip|(% style="background-color:#f2f2f2; width:296px" %)Used as ADC in LSN50 image

165

|(% style="background-color:#f2f2f2; width:44px" %)3|(% style="background-color:#f2f2f2; width:86px" %)PA1|(% style="background-color:#f2f2f2; width:84px" %)In/Out|(% style="background-color:#f2f2f2; width:322px" %)Directly from STM32 chip|(% style="background-color:#f2f2f2; width:296px" %)

166

|(% style="background-color:#f2f2f2; width:44px" %)4|(% style="background-color:#f2f2f2; width:86px" %)PA2|(% style="background-color:#f2f2f2; width:84px" %)In/Out|(% style="background-color:#f2f2f2; width:322px" %)Directly from STM32 chip, 10k pull up to VCC|(% style="background-color:#f2f2f2; width:296px" %)Used as UART_TXD in LSN50 image

167

|(% style="background-color:#f2f2f2; width:44px" %)5|(% style="background-color:#f2f2f2; width:86px" %)PA3|(% style="background-color:#f2f2f2; width:84px" %)In/Out|(% style="background-color:#f2f2f2; width:322px" %)Directly from STM32 chip, 10k pull up to VCC|(% style="background-color:#f2f2f2; width:296px" %)Used as UART_RXD in LSN50 image

168

|(% style="background-color:#f2f2f2; width:44px" %)6|(% style="background-color:#f2f2f2; width:86px" %)PB6|(% style="background-color:#f2f2f2; width:84px" %)In/Out|(% style="background-color:#f2f2f2; width:322px" %)Directly from STM32 chip, 10k pull up to VCC|(% style="background-color:#f2f2f2; width:296px" %)

169

|(% style="background-color:#f2f2f2; width:44px" %)7|(% style="background-color:#f2f2f2; width:86px" %)PB7|(% style="background-color:#f2f2f2; width:84px" %)In/Out|(% style="background-color:#f2f2f2; width:322px" %)Directly from STM32 chip, 10k pull up to VCC|(% style="background-color:#f2f2f2; width:296px" %)

170

|(% style="background-color:#f2f2f2; width:44px" %)8|(% style="background-color:#f2f2f2; width:86px" %)PB3|(% style="background-color:#f2f2f2; width:84px" %)In/Out|(% style="background-color:#f2f2f2; width:322px" %)Directly from STM32 chip, 10k pull up to VCC|(% style="background-color:#f2f2f2; width:296px" %)

171

|(% style="background-color:#f2f2f2; width:44px" %)9|(% style="background-color:#f2f2f2; width:86px" %)PB4|(% style="background-color:#f2f2f2; width:84px" %)In/Out|(% style="background-color:#f2f2f2; width:322px" %)Directly from STM32 chip|(% style="background-color:#f2f2f2; width:296px" %)

172

|(% style="background-color:#f2f2f2; width:44px" %)10|(% style="background-color:#f2f2f2; width:86px" %)PA9|(% style="background-color:#f2f2f2; width:84px" %)In/Out|(% style="background-color:#f2f2f2; width:322px" %)Directly from STM32 chip, 10k pull up to VCC|(% style="background-color:#f2f2f2; width:296px" %)

173

|(% style="background-color:#f2f2f2; width:44px" %)11|(% style="background-color:#f2f2f2; width:86px" %)PA10|(% style="background-color:#f2f2f2; width:84px" %)In/Out|(% style="background-color:#f2f2f2; width:322px" %)Directly from STM32 chip, 10k pull up to VCC|(% style="background-color:#f2f2f2; width:296px" %)

174

|(% style="background-color:#f2f2f2; width:44px" %)12|(% style="background-color:#f2f2f2; width:86px" %)GND|(% style="background-color:#f2f2f2; width:84px" %) |(% style="background-color:#f2f2f2; width:322px" %)Ground|(% style="background-color:#f2f2f2; width:296px" %)

175

|(% style="background-color:#f2f2f2; width:44px" %)13|(% style="background-color:#f2f2f2; width:86px" %)VCC(2.9V)|(% style="background-color:#f2f2f2; width:84px" %)OUTPUT|(% style="background-color:#f2f2f2; width:322px" %)VCC|(% style="background-color:#f2f2f2; width:296px" %)Directly connect to main power for board

176

|(% style="background-color:#f2f2f2; width:44px" %)14|(% style="background-color:#f2f2f2; width:86px" %)Jumper|(% style="background-color:#f2f2f2; width:84px" %) |(% style="background-color:#f2f2f2; width:322px" %)Power on/off jumper|(% style="background-color:#f2f2f2; width:296px" %)

177

|(% style="background-color:#f2f2f2; width:44px" %)15|(% style="background-color:#f2f2f2; width:86px" %)PA4|(% style="background-color:#f2f2f2; width:84px" %)In/Out|(% style="background-color:#f2f2f2; width:322px" %)Directly from STM32 chip|(% style="background-color:#f2f2f2; width:296px" %)

178

|(% style="background-color:#f2f2f2; width:44px" %)16|(% style="background-color:#f2f2f2; width:86px" %)NRST|(% style="background-color:#f2f2f2; width:84px" %)In|(% style="background-color:#f2f2f2; width:322px" %)Reset MCU|(% style="background-color:#f2f2f2; width:296px" %)

179

|(% style="background-color:#f2f2f2; width:44px" %)17|(% style="background-color:#f2f2f2; width:86px" %)PA12|(% style="background-color:#f2f2f2; width:84px" %)In/Out|(% style="background-color:#f2f2f2; width:322px" %)Directly from STM32 chip|(% style="background-color:#f2f2f2; width:296px" %)

180

|(% style="background-color:#f2f2f2; width:44px" %)18|(% style="background-color:#f2f2f2; width:86px" %)PA11|(% style="background-color:#f2f2f2; width:84px" %)In/Out|(% style="background-color:#f2f2f2; width:322px" %)Directly from STM32 chip|(% style="background-color:#f2f2f2; width:296px" %)

181

|(% style="background-color:#f2f2f2; width:44px" %)19|(% style="background-color:#f2f2f2; width:86px" %)PA14|(% style="background-color:#f2f2f2; width:84px" %)In/Out|(% style="background-color:#f2f2f2; width:322px" %)Directly from STM32 chip|(% style="background-color:#f2f2f2; width:296px" %)

182

|(% style="background-color:#f2f2f2; width:44px" %)20|(% style="background-color:#f2f2f2; width:86px" %)PB13|(% style="background-color:#f2f2f2; width:84px" %)In/Out|(% style="background-color:#f2f2f2; width:322px" %)Directly from STM32 chip|(% style="background-color:#f2f2f2; width:296px" %)

183

|(% style="background-color:#f2f2f2; width:44px" %)21|(% style="background-color:#f2f2f2; width:86px" %)PB12|(% style="background-color:#f2f2f2; width:84px" %)In/Out|(% style="background-color:#f2f2f2; width:322px" %)Directly from STM32 chip|(% style="background-color:#f2f2f2; width:296px" %)

184

|(% style="background-color:#f2f2f2; width:44px" %)22|(% style="background-color:#f2f2f2; width:86px" %)PB15|(% style="background-color:#f2f2f2; width:84px" %)In/Out|(% style="background-color:#f2f2f2; width:322px" %)Directly from STM32 chip|(% style="background-color:#f2f2f2; width:296px" %)

185

|(% style="background-color:#f2f2f2; width:44px" %)23|(% style="background-color:#f2f2f2; width:86px" %)PB14|(% style="background-color:#f2f2f2; width:84px" %)In/Out|(% style="background-color:#f2f2f2; width:322px" %)Directly from STM32 chip|(% style="background-color:#f2f2f2; width:296px" %)

186

|(% style="background-color:#f2f2f2; width:44px" %)24|(% style="background-color:#f2f2f2; width:86px" %)PA13|(% style="background-color:#f2f2f2; width:84px" %)In/Out|(% style="background-color:#f2f2f2; width:322px" %)Directly from STM32 chip|(% style="background-color:#f2f2f2; width:296px" %)

187

|(% style="background-color:#f2f2f2; width:44px" %)25|(% style="background-color:#f2f2f2; width:86px" %)PA8|(% style="background-color:#f2f2f2; width:84px" %)In/Out|(% style="background-color:#f2f2f2; width:322px" %)Directly from STM32 chip|(% style="background-color:#f2f2f2; width:296px" %)Default use to turn on/off LED1 in LSN50 image

188

|(% style="background-color:#f2f2f2; width:44px" %)26|(% style="background-color:#f2f2f2; width:86px" %)GND|(% style="background-color:#f2f2f2; width:84px" %) |(% style="background-color:#f2f2f2; width:322px" %)Ground|(% style="background-color:#f2f2f2; width:296px" %)

189

|(% style="background-color:#f2f2f2; width:44px" %)27|(% style="background-color:#f2f2f2; width:86px" %)+5V|(% style="background-color:#f2f2f2; width:84px" %)Out|(% style="background-color:#f2f2f2; width:322px" %)5v output power|(% style="background-color:#f2f2f2; width:296px" %)(((

190

Controlled by PB5(Low to Enable, High to Disable)

191

192

Continuous output : max 600mA

193

194

Pulse output : max 1A

195

)))

196

|(% style="background-color:#f2f2f2; width:44px" %)28|(% style="background-color:#f2f2f2; width:86px" %)LED1|(% style="background-color:#f2f2f2; width:84px" %) |(% style="background-color:#f2f2f2; width:322px" %)Controlled by PA8|(% style="background-color:#f2f2f2; width:296px" %)Blink on transmit

197

|(% style="background-color:#f2f2f2; width:44px" %)29|(% style="background-color:#f2f2f2; width:86px" %)BOOT MODE|(% style="background-color:#f2f2f2; width:84px" %) |(% style="background-color:#f2f2f2; width:322px" %)Configure device in working mode or ISP program mode|(% style="background-color:#f2f2f2; width:296px" %)(((

198

(((

199

Flash: Normal Working mode and send AT Commands

)))

(((

ISP: UART Program Mode

204

)))

205

)))

206

|(% style="background-color:#f2f2f2; width:44px" %)30|(% style="background-color:#f2f2f2; width:86px" %)NRST|(% style="background-color:#f2f2f2; width:84px" %)In|(% style="background-color:#f2f2f2; width:322px" %)Reset MCU|(% style="background-color:#f2f2f2; width:296px" %)

207

208

(% style="display:none" %)

=== 1.5.1 Jumper JP2 ===

213

214

215

Power on Device when put this jumper.

216

217

218

=== 1.5.2 BOOT MODE / SW1 ===

(((

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

231

232

233

Press to reboot the device.

=== 1.5.4 LED ===

It will flash:

~1. When boot the device in flash mode

242

243

2. Send an uplink packet

244

245

246

== 1.6 Hardware Change log ==

247

248

249

(% style="color:red" %)**Note: Hardware version is marked in the PCB.**

250

251

252

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

253

254

1. Change R14 to 1M ohm

255

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

256

1. Add ESD to each I/O

257

258

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

259

260

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

261

262

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

263

264

* Add P-MOS to control 5V output

265

266

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

267

268

* Add LED. Turn on for every LoRa transmit

269

* Add pin PA4, PB13, NRST

270

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

271

272

== 1.7 Hole Option ==

273

274

275

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:

276

277

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

278

279

280

[[image:1656298089706-973.png]]

281

282

283

= 2. Use LSN50 with LoRaWAN firmware =

284

285

== 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.8.0):

)))

[[image:image-20220823174408-9.png||height="890" width="657"]]

(((

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>>||anchor="H3.A0UsingtheATCommands"]] to set the keys in the LSN50.

)))

)))

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

(((

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.

317

318

319

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

)))

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

330

331

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

)))

(((

[[image:image-20230425173445-3.png]]

336

)))

337

338

(% title="Click and drag to resize" %)(% _mstaria-label="548795" 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"]](% _mstaria-label="548795" 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"]](% _mstaria-label="548795" 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" %)(% _mstaria-label="548795" 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" %)(% _mstaria-label="548795" 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:

)))

(((

**Register the device：**

)))

)))

(% _mstaria-label="548795" 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"]](% _mstaria-label="548795" 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"]](% _mstaria-label="548795" 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" %)(% _mstaria-label="795587" 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"]](%%)(% _mstaria-label="548795" 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"]](% _mstaria-label="548795" 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"]](% _mstaria-label="548795" 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" %)(% _mstaria-label="548795" 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"]](% _mstaria-label="548795" 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"]](% _mstaria-label="548795" 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" %)

351

352

(% _mstaria-label="548795" 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"]](% _mstaria-label="548795" 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"]](% _mstaria-label="548795" 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" %)

353

354

355

**Add APP EUI and DEV EUI：**

356

357

358

(% _mstaria-label="1002404" 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：**

363

364

365

(% _mstaria-label="1002768" 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**

(% _mstaria-label="1003132" 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" %)

371

372

(% _mstaria-label="548795" 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"]](% _mstaria-label="548795" 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"]](% _mstaria-label="548795" 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" %)(% _mstaria-label="548795" 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"]](% _mstaria-label="548795" 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"]](% _mstaria-label="548795" 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" %)

373

374

(% _mstaria-label="548795" 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"]](% _mstaria-label="548795" 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"]](% _mstaria-label="548795" 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" %)(% _mstaria-label="548795" 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" %)(% _mstaria-label="548795" 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" %)(%%)

375

376

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

377

378

379

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

380

381

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

382

383

(% style="display:none" %)

**For LSn50v2:**

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

389

390

391

(% _mstaria-label="548795" 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"]](% _mstaria-label="548795" 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"]](% _mstaria-label="548795" 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" %)(%%)(% _mstaria-label="548795" 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"]](% _mstaria-label="548795" 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"]](% _mstaria-label="548795" 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" %)(% _mstaria-label="548795" 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" %)(% _mstaria-label="548795" 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.

)))

)))

(% _mstaria-label="548795" 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"]](% _mstaria-label="548795" 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"]](% _mstaria-label="548795" 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]]

402

403

404

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

405

406

(% _mstaria-label="548795" 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"]](% _mstaria-label="548795" 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"]](% _mstaria-label="548795" 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" %)(% _mstaria-label="548795" 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"]](% _mstaria-label="548795" 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"]](% _mstaria-label="548795" 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" %)

407

408

== 2.3 Working Mode & Uplink Payload ==

(((

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:

)))

(((

(% _mstmutation="1" 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.

)))

(((

)))

(((

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

)))

(((

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

433

434

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

435

436

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

)))

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

(((

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

445

446

447

(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %)

448

|(% style="background-color:#d9e2f3; color:#0070c0; width:60px" %)**Size(bytes)**|(% style="background-color:#d9e2f3; color:#0070c0; width:40px" %)**2**|(% style="background-color:#d9e2f3; color:#0070c0; width:100px" %)**2**|(% style="background-color:#d9e2f3; color:#0070c0; width:30px" %)**2**|(% style="background-color:#d9e2f3; color:#0070c0; width:110px" %)**1**|(% style="background-color:#d9e2f3; color:#0070c0; width:110px" %)**2**|(% style="background-color:#d9e2f3; color:#0070c0; width:60px" %)**2**

449

450

451

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

)))

=== 2.3.2 MOD~=2 (Distance Mode) ===

456

457

458

This mode is target to measure the distance. The payload of this mode is totally 11 bytes. The 8^^th^^ and 9^^th^^ bytes is for the distance.

459

460

(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %)

461

|(% style="background-color:#d9e2f3; color:#0070c0; width:60px" %)**Size(bytes)**|(% style="background-color:#d9e2f3; color:#0070c0; width:40px" %)**2**|(% style="background-color:#d9e2f3; color:#0070c0; width:100px" %)**2**|(% style="background-color:#d9e2f3; color:#0070c0; width:30px" %)**2**|(% style="background-color:#d9e2f3; color:#0070c0; width:110px" %)**1**|(% style="background-color:#d9e2f3; color:#0070c0; width:110px" %)**2**|(% style="background-color:#d9e2f3; color:#0070c0; width:60px" %)**2**

462

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

463

Temperature(DS18B20)

464

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

Distance measure by:

1) LIDAR-Lite V3HP

Or

2) Ultrasonic Sensor

)))|Reserved

[[image:1656324539647-568.png]]

(% style="color:red" %)**Connection of LIDAR-Lite V3HP:**

476

477

478

[[image:1656324581381-162.png]]

(% style="color:red" %)**Connection to Ultrasonic Sensor:**

483

484

485

[[image:1656324598488-204.png]]

486

487

488

For the connection to TF-Mini or TF-Luna , MOD2 payload is as below:

489

490

(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %)

491

|(% style="background-color:#d9e2f3; color:#0070c0; width:60px" %)**Size(bytes)**|(% style="background-color:#d9e2f3; color:#0070c0; width:35px" %)**2**|(% style="background-color:#d9e2f3; color:#0070c0; width:100px" %)**2**|(% style="background-color:#d9e2f3; color:#0070c0; width:80px" %)**1**|(% style="background-color:#d9e2f3; color:#0070c0; width:35px" %)**2**|(% style="background-color:#d9e2f3; color:#0070c0; width:100px" %)**2**|(% style="background-color:#d9e2f3; color:#0070c0; width:100px" %)**2**

492

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

493

Temperature(DS18B20)

494

)))|(% style="width:145px" %)Digital in & Digital Interrupt|ADC|(((

495

Distance measure by:1)TF-Mini plus LiDAR

496

Or

497

2) TF-Luna LiDAR

498

)))|Distance signal strength

499

500

[[image:1656376779088-686.png]]

(% style="color:red" %)**Connection to [[TF-Mini plus>>url:http://en.benewake.com/product/detail/5c345cd0e5b3a844c472329b.html]] LiDAR(UART version):**

505

506

507

Need to remove R3 and R4 resistors to get low power. Since firmware v1.7.0

508

509

510

[[image:1656376795715-436.png]]

(% style="color:red" %)**Connection to [[TF-Luna>>url:http://en.benewake.com/product/detail/5e1c1fd04d839408076b6255.html]] LiDAR (UART version):**

515

516

517

Need to remove R3 and R4 resistors to get low power. Since firmware v1.7.0

518

519

520

[[image:1656376865561-355.png]]

(((

Please use firmware version > 1.6.5 when use MOD=2, in this firmware version, user can use LSn50 v1 to power the ultrasonic sensor directly and with low power consumption.

)))

=== 2.3.3 MOD~=3 (3 ADC + I2C) ===

529

530

531

This mode has total 12 bytes. Include 3 x ADC + 1x I2C

532

533

(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:520px" %)

534

|=(% style="width: 60px;background-color:#D9E2F3;color:#0070C0" %)(((

535

**Size(bytes)**

536

)))|=(% style="width: 60px;background-color:#D9E2F3;color:#0070C0" %)**2**|=(% style="width: 50px;background-color:#D9E2F3;color:#0070C0" %)**2**|=(% style="width: 50px;background-color:#D9E2F3;color:#0070C0" %)**2**|=(% style="width: 90px;background-color:#D9E2F3;color:#0070C0" %)**1**|=(% style="width: 90px;background-color:#D9E2F3;color:#0070C0" %)2|=(% style="width: 90px;background-color:#D9E2F3;color:#0070C0" %)2|=(% style="width: 30px;background-color:#D9E2F3;color:#0070C0" %)1

537

538

Digital in(PA12)&Digital Interrupt1(PB14)

539

)))|(% style="width:151px" %)Temperature（SHT20 or SHT31 or BH1750 Illumination Sensor）|(% style="width:131px" %)Humidity（SHT20 or SHT31)|(% style="width:66px" %)Bat

540

541

[[image:1656377431497-975.png]]

542

543

544

=== 2.3.4 MOD~=4 (3 x DS18B20) ===

545

546

547

This mode is supported in firmware version since v1.6.1. Software set to AT+MOD=4

548

549

Hardware connection is as below,

550

551

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

552

553

* In hardware version v1.x and v2.0 , R3 & R4 should change from 10k to 4.7k ohm to support the other 2 x DS18B20 probes.

554

* In hardware version v2.1 no need to change R3 , R4, by default, they are 4.7k ohm already.

555

556

See [[here>>||anchor="H1.6A0HardwareChangelog" _mstmutation="1"]] for hardware changelog. (% style="color:red" %)**) **

557

558

[[image:1656377461619-156.png]]

559

560

561

This mode has total 11 bytes. As shown below:

562

563

(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %)

564

|(% style="background-color:#d9e2f3; color:#0070c0; width:60px" %)**Size(bytes)**|(% style="background-color:#d9e2f3; color:#0070c0; width:40px" %)**2**|(% style="background-color:#d9e2f3; color:#0070c0; width:100px" %)**2**|(% style="background-color:#d9e2f3; color:#0070c0; width:30px" %)**2**|(% style="background-color:#d9e2f3; color:#0070c0; width:110px" %)**1**|(% style="background-color:#d9e2f3; color:#0070c0; width:110px" %)**2**|(% style="background-color:#d9e2f3; color:#0070c0; width:60px" %)**2**

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

Temperature1

(DS18B20)

(PB3)

)))|ADC|Digital in & Digital Interrupt|Temperature2

(DS18B20)

(PA9)|Temperature3

(DS18B20)

(PA10)

[[image:1656377606181-607.png]]

576

577

578

=== 2.3.5 MOD~=5(Weight Measurement by HX711) ===

(((

This mode is supported in firmware version since v1.6.2. Please use v1.6.5 firmware version so user no need to use extra LDO for connection.

)))

[[image:1656378224664-860.png]]

588

589

590

Each HX711 need to be calibrated before used. User need to do below two steps:

591

592

1. Zero calibration. Don't put anything on load cell and run **AT+WEIGRE** to calibrate to Zero gram.

593

1. Adjust calibration factor (default value 400): Put a known weight thing on load cell and run **AT+WEIGAP** to adjust the Calibration Factor.

594

1. (((

595

Remove the limit of plus or minus 5Kg in mode 5, and expand from 2 bytes to 4 bytes, the unit is g.(Since v1.8.0)

)))

For example:

(% style="color:#4472c4" %)**AT+WEIGAP =403.0**

601

602

Response: Weight is 401 g

603

604

605

Check the response of this command and adjust the value to match the real value for thing.

606

607

(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:490px" %)

608

|=(% style="width: 60px;background-color:#D9E2F3" %)(((

609

**Size(bytes)**

610

)))|=(% style="width: 30px;background-color:#D9E2F3" %)**2**|=(% style="width: 110px;background-color:#D9E2F3" %)**2**|=(% style="width: 60px;background-color:#D9E2F3" %)**2**|=(% style="width: 130px;background-color:#D9E2F3" %)**1**|=(% style="width: 50px;background-color:#D9E2F3" %)**4**|=(% style="width: 50px;background-color:#D9E2F3" %)2

611

|(% style="width:97px" %)**Value**|(% style="width:40px" %)[[Bat>>||anchor="H2.4.1BatteryInfo"]]|(% style="width:110px" %)[[Temperature(DS18B20)>>||anchor="H2.4.2Temperature28DS18B2029"]]|(% style="width:30px" %)[[ADC>>||anchor="H2.4.4AnalogueDigitalConverter28ADC29"]]|(% style="width:120px" %)[[Digital Input and Digitak Interrupt>>||anchor="H2.4.3DigitalInput"]]|(% style="width:40px" %)Weight|(% style="width:40px" %)Reserved

612

613

[[image:image-20220820120036-2.png||height="469" width="1003"]]

614

615

616

=== 2.3.6 MOD~=6 (Counting Mode, Since firmware v1.6.5) ===

(((

In this mode, the device will work in counting mode. It counts the interrupt on the interrupt pins and sends the count on TDC time.

)))

(((

Connection is as below. The PIR sensor is a count sensor, it will generate interrupt when people come close or go away. User can replace the PIR sensor with other counting sensors.

)))

[[image:1656378351863-572.png]]

(((

(% style="color:red" %)**Note:**(%%) LoRaWAN wireless transmission will infect the PIR sensor. Which cause the counting value increase +1 for every uplink. User can change PIR sensor or put sensor away of the LSN50 to avoid this happen.

)))

(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:390px" %)

637

|=(% style="width: 60px;background-color:#D9E2F3" %)**Size(bytes)**|=(% style="width: 50px;background-color:#D9E2F3" %)**2**|=(% style="width: 110px;background-color:#D9E2F3" %)**2**|=(% style="width: 50px;background-color:#D9E2F3" %)**2**|=(% style="width: 70px;background-color:#D9E2F3" %)**1**|=(% style="width: 50px;background-color:#D9E2F3" %)**4**

638

|(% style="width:80px" %)**Value**|(% style="width:44px" %)[[BAT>>||anchor="H2.4.1BatteryInfo"]]|(% style="width:172px" %)(((

639

[[Temperature(DS18B20)>>||anchor="H2.4.2Temperature28DS18B2029"]]

640

)))|(% style="width:51px" %)[[ADC>>||anchor="H2.4.4AnalogueDigitalConverter28ADC29"]]|(% style="width:206px" %)[[Digital in>>||anchor="H2.4.3DigitalInput"]]|(% style="width:72px" %)Count

641

642

[[image:1656378441509-171.png]]

643

644

645

=== 2.3.7 MOD~=7 Three interrupt contact modes (the hardware version needs to support three interrupt versions, Since firmware v1.8.0) ===

646

647

648

[[image:image-20220820140109-3.png]]

649

650

651

(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:490px" %)

652

|=(% style="width: 60px;background-color:#D9E2F3;color:#0070C0" %)(((

653

**Size(bytes)**

654

)))|=(% style="width: 30px;background-color:#D9E2F3;color:#0070C0" %)**2**|=(% style="width: 100px;background-color:#D9E2F3;color:#0070C0" %)**2**|=(% style="width: 30px;background-color:#D9E2F3;color:#0070C0" %)**2**|=(% style="width: 80px;background-color:#D9E2F3;color:#0070C0" %)**1**|=(% style="width: 70px;background-color:#D9E2F3;color:#0070C0" %)**1**|=(% style="width: 70px;background-color:#D9E2F3;color:#0070C0" %)1|=(% style="width: 50px;background-color:#D9E2F3;color:#0070C0" %)2

655

656

Digital in(PA12)&Digital Interrupt1(PB14)

657

)))|(% style="width:159px" %)Digital Interrupt2(PB15)|(% style="width:159px" %)Digital Interrupt3(PA4)|(% style="width:159px" %)Reserved

658

659

=== 2.3.8 MOD~=8 （3ADC+1DS18B20, Since firmware v1.8.0） ===

660

661

662

(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:470px" %)

663

|=(% style="width: 60px;background-color:#D9E2F3;color:#0070C0" %)(((

664

**Size(bytes)**

665

)))|=(% style="width: 30px;background-color:#D9E2F3;color:#0070C0" %)**2**|=(% style="width: 100px;background-color:#D9E2F3;color:#0070C0" %)**2**|=(% style="width: 60px;background-color:#D9E2F3;color:#0070C0" %)**2**|=(% style="width: 100px;background-color:#D9E2F3;color:#0070C0" %)**1**|=(% style="width: 60px;background-color:#D9E2F3;color:#0070C0" %)**2**|=(% style="width: 60px;background-color:#D9E2F3;color:#0070C0" %)2

666

|(% style="width:97px" %)**Value**|(% style="width:46px" %)BAT|(% style="width:123px" %)Temperature(DS18B20)|(% style="width:108px" %)(((

667

ADC1(PA0)

668

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

669

Digital in

670

& Digital Interrupt(PB14)

671

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

672

ADC2(PA1)

673

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

ADC3(PA4)

)))

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

678

679

680

=== 2.3.9 MOD~=9 3DS18B20+ two Interrupt count mode (the hardware version needs to support 3 interrupt versions, Since firmware v1.8.0) ===

681

682

683

(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:520px" %)

684

|=(% style="width: 60px;background-color:#D9E2F3;color:#0070C0" %)(((

685

**Size(bytes)**

686

)))|=(% style="width: 30px;background-color:#D9E2F3;color:#0070C0" %)**2**|=(% style="width: 80px;background-color:#D9E2F3;color:#0070C0" %)**2**|=(% style="width: 80px;background-color:#D9E2F3;color:#0070C0" %)**2**|=(% style="width: 70px;background-color:#D9E2F3;color:#0070C0" %)**1**|=(% style="width: 80px;background-color:#D9E2F3;color:#0070C0" %)**2**|=(% style="width: 60px;background-color:#D9E2F3;color:#0070C0" %)4|=(% style="width: 60px;background-color:#D9E2F3;color:#0070C0" %)4

687

|(% style="width:97px" %)**Value**|(% style="width:46px" %)BAT|(% style="width:123px" %)(((

688

Temperature1(PB3)

689

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

690

Temperature2(PA9)

691

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

692

Digital in

693

& Digital Interrupt(PA4)

694

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

695

Temperature3(PA10)

696

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

697

Count1(PB14)

698

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

Count2(PB15)

)))

(% class="wikigeneratedid" id="H" %)

703

[[image:image-20220823165322-3.png]]

704

705

706

(% style="color:blue" %)**The newly added AT command is issued correspondingly:**

707

708

(% style="color:#4472c4" %)** AT+INTMOD1**(%%) (% style="background-color:yellow" %)** PB14**(%%) pin： Corresponding downlink: (% style="background-color:yellow" %)**06 00 00 xx**

709

710

(% style="color:#4472c4" %)** AT+INTMOD2**(%%) (% style="background-color:yellow" %)**PB15**(%%) pin： Corresponding downlink:** (% style="background-color:yellow" %)06 00 01 xx(%%)**

711

712

(% style="color:#4472c4" %)** AT+INTMOD3** (%%) (% style="background-color:yellow" %)**PA4** (%%) pin： Corresponding downlink: ** (% style="background-color:yellow" %)06 00 02 xx(%%)**

713

714

715

(% style="color:blue" %)**AT+SETCNT=aa,bb**

716

717

When AA is 1, set the count of PB14 pin to BB Corresponding downlink：09 01 bb bb bb bb

718

719

When AA is 2, set the count of PB15 pin to BB Corresponding downlink：09 02 bb bb bb bb

720

721

722

=== 2.3.10 Decode payload in The Things Network ===

723

724

725

While using TTN V3 network, you can add the payload format to decode the payload.

726

727

728

[[image:1656378466788-734.png]]

(((

The payload decoder function for TTN V3 are here:

)))

(((

LSN50 TTN V3 Payload Decoder: [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]]

)))

== 2.4 Payload Explanation and Sensor Interface ==

741

742

=== 2.4.1 Battery Info ===

(((

Check the battery voltage for LSN50.

)))

(((

Ex1: 0x0B45 = 2885mV

)))

(((

Ex2: 0x0B49 = 2889mV

)))

=== 2.4.2 Temperature (DS18B20) ===

759

760

761

If there is a DS18B20 connected to PB3 pin. The temperature will be uploaded in the payload.

762

763

More DS18B20 can check the [[3 DS18B20 mode>>||anchor="2.3.4MOD3D4283xDS18B2029"]]

764

765

766

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

767

768

[[image:1656378573379-646.png]]

769

770

771

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

772

773

If payload is: 0105H: (0105 & 8000 == 0), temp = 0105H /10 = 26.1 degree

774

775

If payload is: FF3FH : (FF3F & 8000 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.

776

777

（FF3F & 8000：Judge whether the highest bit is 1, when the highest bit is 1, it is negative）

778

779

780

=== 2.4.3 Digital Input ===

781

782

783

The digital input for pin PA12,

784

785

* When PA12 is high, the bit 1 of payload byte 6 is 1.

786

* When PA12 is low, the bit 1 of payload byte 6 is 0.

787

788

789

=== 2.4.4 Analogue Digital Converter (ADC) ===

(((

The ADC pins in LSN50 can measure range from 0~~Vbat, it use reference voltage from STM32. If user need to measure a voltage > VBat, please use resistors to divide this voltage to lower than VBat, otherwise, it may destroy the ADC pin.

794

795

Note: minimum VBat is 2.5v, when batrrey lower than this value. Device won't be able to send LoRa Uplink.

)))

(((

The ADC monitors the voltage on the PA0 line, in mV.

)))

(((

Ex: 0x021F = 543mv,

)))

(((

(% style="color:#4472c4" %)** Example1:** (%%) Reading an Oil Sensor (Read a resistance value):

)))

[[image:image-20220627172409-28.png]]

815

816

817

In the LSN50, we can use PB4 and PA0 pin to calculate the resistance for the oil sensor.

818

819

820

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

821

822

1. Solder a 10K resistor between PA0 and VCC.

823

1. Screw oil sensor's two pins to PA0 and PB4.

824

825

The equipment circuit is as below:

826

827

828

[[image:image-20220627172500-29.png]]

829

830

831

According to above diagram:

832

833

[[image:image-20220628091043-4.png]]

So

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

838

839

840

[[image:image-20220628091621-8.png]] is the reading of ADC. So if ADC=0x05DC=0.9 v and VCC (BAT) is 2.9v

841

842

843

The [[image:image-20220628091702-9.png]] 4.5K ohm

844

845

Since the Bouy is linear resistance from 10 ~~ 70cm.

846

847

848

The position of Bouy is [[image:image-20220628091824-10.png]] , from the bottom of Bouy.

849

850

851

=== 2.4.5 Digital Interrupt ===

852

853

854

Digital Interrupt refers to pin PB14, and there are different trigger methods. When there is a trigger, the LSN50 will send a packet to the server.

(((

(% style="color:#4472c4" %)** Interrupt connection method:**

859

)))

860

861

[[image:1656379178634-321.png]]

(((

(% style="color:#4472c4" %)**Example to use with door sensor : (Requires firmware > 1.5.1)**

)))

(((

The door sensor is shown at right. It is a two wire magnetic contact switch used for detecting the open/close status of doors or windows.

871

)))

872

873

[[image:1656379210849-860.png]]

(((

When the two pieces are close to each other, the 2 wire output will be short or open (depending on the type), while if the two pieces are away from each other, the 2 wire output will be the opposite status. So we can use LSN50 interrupt interface to detect the status for the door or window.

)))

(((

(% style="color:#4472c4" %)** Below is the installation example:**

)))

(((

Fix one piece of the magnetic sensor to the door and connect the two pins to LSN50 as follows:

)))

* (((

One pin to LSN50's PB14 pin

891

)))

892

* (((

893

The other pin to LSN50's VCC pin

)))

(((

Install the other piece to the door. Find a place where the two pieces will be close to each other when the door is closed. For this particular magnetic sensor, when the door is closed, the output will be short, and PB14 will be at the VCC voltage.

)))

(((

Door sensors have two types: ** (% style="color:#4472c4" %)NC (Normal close)(%%)** and (% style="color:#4472c4" %)**NO (normal open)**(%%). The connection for both type sensors are the same. But the decoding for payload are reverse, user need to modify this in the IoT Server decoder.

)))

(((

When door sensor is shorted, there will extra power consumption in the circuit, the extra current is 3v3/R14 = 3v2/1Mohm = 0.3uA which can be ignored.

)))

[[image:1656379283019-229.png]]

(((

The above photos shows the two parts of the magnetic switch fitted to a door.

)))

(((

(((

The software by default uses the falling edge on the signal line as an interrupt. We need to modify it to accept both the rising edge (0v ~-~-> VCC , door close) and the falling edge (VCC ~-~-> 0v , door open) as the interrupt.

)))

)))

(((

The command is:

)))

(((

(% _mstmutation="1" style="color:blue" %)**AT+INTMOD=1 **(% _mstmutation="1" %)** **(%%)~/~/(more info about INMOD please refer(% _mstmutation="1" %)** **(%%)[[**AT Command Manual**>>url:http://www.dragino.com/downloads/index.php?dir=LSN50-LoRaST/&file=DRAGINO_LSN50_AT_Commands_v1.5.1.pdf||_mstmutation="1"]](% _mstmutation="1" %)**. **(%%))

)))

(((

Below shows some screen captures in TTN V3:

)))

[[image:1656379339508-835.png]]

939

940

941

In MOD=1, user can use byte 6 to see the status for door open or close. TTN V3 decoder is as below:

942

943

(% style="background-color:#dcdcdc" %)door= (bytes[6] & 0x80)? "CLOSE":"OPEN";

944

945

946

(% style="color:red" %)**Notice for hardware version LSN50 v1 < v1.3**(%%) (produced before 2018-Nov).

947

948

In this hardware version, there is no R14 resistance solder. When use the latest firmware, it should set AT+INTMOD=0 to close the interrupt. If user need to use Interrupt in this hardware version, user need to solder R14 with 10M resistor and C1 (0.1uF) on board.

949

950

[[image:1656379563303-771.png]]

951

952

953

=== 2.4.6 I2C Interface (SHT20) ===

(((

The PB6(SDA) and PB7(SCK) are I2C interface lines. You can use these to connect to an I2C device and get the sensor data.

)))

(((

We have made an example to show how to use the I2C interface to connect to the SHT20 Temperature and Humidity Sensor. This is supported in the stock firmware since v1.5 with (% style="color:#4472c4" %)**AT+MOD=1 (default value).**

962

963

Notice: Different I2C sensors have different I2C commands set and initiate process, if user want to use other I2C sensors, User need to re-write the source code to support those sensors. SHT20 code in LSN50 will be a good reference.

)))

(((

Below is the connection to SHT20/ SHT31. The connection is as below:

)))

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

972

973

974

The device will be able to get the I2C sensor data now and upload to IoT Server.

975

976

977

[[image:1656379664142-345.png]]

978

979

Convert the read byte to decimal and divide it by ten.

980

981

982

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

983

984

Temperature: Read:0116(H) = 278(D) Value: 278 /10=27.8℃;

985

986

Humidity: Read:0248(H)=584(D) Value: 584 / 10=58.4, So 58.4%

987

988

989

If you want to use other I2C device, please refer the SHT20 part source code as reference.

990

991

992

=== 2.4.7 Distance Reading ===

993

994

995

Refer [[Ultrasonic Sensor section>>||anchor="H2.4.8UltrasonicSensor"]].

996

997

998

=== 2.4.8 Ultrasonic Sensor ===

(((

The LSN50 v1.5 firmware supports ultrasonic sensor (with AT+MOD=2) such as SEN0208 from DF-Robot. This Fundamental Principles of this sensor can be found at this link: [[https:~~/~~/wiki.dfrobot.com/Weather_-_proof_Ultrasonic_Sensor_with_Separate_Probe_SKU~~_~~__SEN0208>>url:https://wiki.dfrobot.com/Weather_-_proof_Ultrasonic_Sensor_with_Separate_Probe_SKU___SEN0208]]

)))

(((

The LSN50 detects the pulse width of the sensor and converts it to mm output. The accuracy will be within 1 centimeter. The usable range (the distance between the ultrasonic probe and the measured object) is between 24cm and 600cm.

)))

(((

The picture below shows the connection:

1013

)))

1014

1015

[[image:1656380061365-178.png]]

1016

1017

1018

Connect to the LSN50 and run (% style="color:blue" %)**AT+MOD=2**(%%) to switch to ultrasonic mode (ULT).

1019

1020

The ultrasonic sensor uses the 8^^th^^ and 9^^th^^ byte for the measurement value.

1021

1022

1023

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

1024

1025

Distance: Read: 0C2D(Hex) = 3117(D) Value: 3117 mm=311.7 cm

1026

1027

1028

[[image:1656384895430-327.png]]

1029

1030

1031

[[image:1656384913616-455.png]]

1032

1033

1034

You can see the serial output in ULT mode as below:

1035

1036

[[image:1656384939855-223.png]]

1037

1038

1039

**In TTN V3 server:**

1040

1041

1042

[[image:1656384961830-307.png]]

1043

1044

1045

[[image:1656384973646-598.png]]

1046

1047

1048

=== 2.4.9 Battery Output - VDD pin ===

1049

1050

1051

The VDD pin of LSN50v2 is connected to the Battery directly. If users want to use VDD pin to power an external sensor. User need to make sure the external sensor is of low power consumption. Because the VDD pin is always open. If the external sensor is of high power consumption. the battery of LSN50v2 will run out very soon.

1052

1053

1054

=== 2.4.10 +5V Output ===

1055

1056

1057

Since v1.2 hardware version, a +5v output is added in the hardware. The +5V output will be valid for every sampling. LSN50 will enable +5V output before all sampling and disable the +5v after all sampling.

(((

Since firmware (% style="color:red" %)**v1.6.3**(%%), The 5V output time can be controlled by AT Command.

)))

(((

(% style="color:#4472c4" %)**AT+5VT=1000**

)))

(((

Means set 5V valid time to have 1000ms. So the real 5V output will actually have 1000ms + sampling time for other sensors.

)))

(((

By default the AT+5VT=500. If the external sensor which require 5v and require more time to get stable state, user can use this command to increase the power ON duration for this sensor.

)))

=== 2.4.11 Weigh Sensor HX711 ===

1079

1080

1081

Since v1.6.2 firmware, LSN50 support Weigh Sensor HX711.

1082

1083

1084

=== 2.4.12 BH1750 Illumination Sensor ===

1085

1086

1087

Since v1.7.0 firmware, MOD=1 support this sensor. The sensor value is in the 8^^th^^ and 9^^th^^ bytes.

1088

1089

1090

[[image:image-20220628110012-11.jpeg]]

1091

1092

1093

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

1094

1095

1096

=== 2.4.13 Working MOD ===

(((

The working MOD info is contained in the Digital in & Digital Interrupt byte (7^^th^^ Byte).

)))

(((

User can use the 3^^rd^^ ~~ 7^^th^^ bit of this byte to see the working mod:

)))

(((

Case 7^^th^^ Byte >> 2 & 0x1f:

)))

* 0: MOD1

* 1: MOD2

* 2: MOD3

* 3: MOD4

* 4: MOD5

* 5: MOD6

== 2.5 Configure LSN50 via AT or Downlink ==

(((

User can configure LSN50 via [[AT Commands >>||anchor="H3.A0UsingtheATCommands"]]or LoRaWAN Downlink Commands

)))

(((

There are two kinds of Commands:

1128

)))

1129

1130

* (% _mstmutation="1" style="color:blue" %)**Common Commands**(%%): They should be available for each sensor, such as: change uplink interval, reset device. For firmware v1.7.0, user can find what common commands it supports: [[End Device AT Commands>>doc:Main.End Device AT Commands and Downlink Command.WebHome||_mstmutation="1"]]

1131

1132

* (% style="color:blue" %)**Sensor Related Commands**(%%): These commands are special designed for LSN50. User can see these commands below:

1133

1134

1135

=== 2.5.1 Common Commands: ===

1136

1137

1138

They should be available for each of Dragino Sensors, such as: change uplink interval, reset device. For firmware v1.7.0, user can find what common commands it supports: [[End Device AT Commands>>doc:Main.End Device AT Commands and Downlink Command.WebHome]]

1139

1140

1141

=== 2.5.2 Sensor related commands: ===

1142

1143

1144

(% style="color:blue" %)**Set work mode:**

1145

1146

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

1147

1148

(((

1149

(% _mstmutation="1" style="background-color:#dcdcdc" %)**AT+MOD=2 **(%%) ~/~/ Set work MOD =2. (1: IIC mode, 2: Distance mode, 3: 3ADC mode, 4: 3DS18B20 mode, 5: weight mode)

)))

(((

(% _mstmutation="1" style="background-color:#dcdcdc" %)**AT+MOD=?** (%%) ~/~/ Get current work MOD

)))

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

1158

1159

(% style="background-color:#dcdcdc" %)**0x0A aa** (%%) ~/~/ Same as AT+MOD=aa

(% style="color:blue" %)**Set the trigger interrupt mode:**

1164

1165

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

1166

1167

(((

1168

(% _mstmutation="1" style="background-color:#dcdcdc" %)**AT+INTMOD=2** (%%) ~/~/ Set INTMOD =2. (0: Disable, 1:falling or rising, 2: falling, 3: rising)

)))

(((

(% _mstmutation="1" style="background-color:#dcdcdc" %)**AT+INTMOD=?** (%%) ~/~/ Get current INTMOD

)))

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

1177

1178

(% style="background-color:#dcdcdc" %)**0x06 000003** (%%) ~/~/ Set AT+INTMOD=3

(% style="color:blue" %)**Set the 5V power open time during sampling:**

1183

1184

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

1185

1186

(((

1187

(% _mstmutation="1" style="background-color:#dcdcdc" %)**AT+5VT=1000** (%%) ~/~/ Set 5v open time to 1000ms

)))

(((

(% _mstmutation="1" style="background-color:#dcdcdc" %)**AT+5VT=?** (%%) ~/~/ Check current 5v open duration

)))

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

1196

1197

(% style="background-color:#dcdcdc" %)**0x07 aa bb** (%%) ~/~/ Equal AT+5VT=0x(aa bb)

(% style="color:blue" %)**Set the weight to 0g (Zero Calibration)：**

1202

1203

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

1204

1205

(% style="background-color:#dcdcdc" %)**AT+WEIGRE** ** **(%%)** **~/~/ Set the weight to 0g

1206

1207

1208

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

1209

1210

(% style="background-color:#dcdcdc" %)**0x08 01** (%%) ~/~/ Set the weight to 0g

(% style="color:blue" %)**Get or Set the GAP Value (calibrate factor) of measurement：**

1215

1216

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

1217

1218

(((

1219

(% _mstmutation="1" style="background-color:#dcdcdc" %)**AT+WEIGAP=403.0** (%%) ~/~/ Set GAP Value =403.0 (response: Weight: xx g)

)))

(((

(% _mstmutation="1" style="background-color:#dcdcdc" %)**AT+WEIGAP=?** (%%) ~/~/ Get current GAP Value

)))

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

1228

1229

(% style="background-color:#dcdcdc" %)**0x08 02 aa bb** (%%) ~/~/ Equal to AT+WEIGAP=0x(aa bb)/10

(% style="color:blue" %)**Encrypt upload：**

1234

1235

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

1236

1237

(((

1238

(% _mstmutation="1" style="background-color:#dcdcdc" %)**AT+DECRYPT=1** (%%) ~/~/ The payload is uploaded without encryption

)))

(((

(% _mstmutation="1" style="background-color:#dcdcdc" %)**AT+DECRYPT=0** (%%) ~/~/ Encrypt when uploading payload (default)

)))

(% style="color:blue" %)**Get data：**

1248

1249

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

1250

1251

(((

1252

(% _mstmutation="1" style="background-color:#dcdcdc" %)**AT+GETSENSORVALUE=0** (%%) ~/~/ The serial port gets the reading of the current sensor

)))

(((

(% _mstmutation="1" style="background-color:#dcdcdc" %)**AT+GETSENSORVALUE=1** (%%) ~/~/ The serial port gets the current sensor reading and uploads it.

(% style="color:blue" %)**Resets the downlink packet count：**

1261

1262

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

1263

1264

(((

1265

(% _mstmutation="1" style="background-color:#dcdcdc" %)**AT+DISFCNTCHECK=0**(% _mstmutation="1" %)** **(%%) ~/~/(% _mstmutation="1" %)** **(%%)When the downlink packet count sent by the server is less than the node downlink packet count or exceeds 16384, the node will no longer receive downlink packets (default)

)))

(((

(% _mstmutation="1" style="background-color:#dcdcdc" %)**AT+DISFCNTCHECK=1** (%%) ~/~/ When the downlink packet count sent by the server is less than the node downlink packet count or exceeds 16384, the node resets the downlink packet count and keeps it consistent with the server downlink packet count

)))

(% style="color:blue" %)**When the limit bytes are exceeded, upload in batches：**

1275

1276

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

1277

1278

(((

1279

(% _mstmutation="1" style="background-color:#dcdcdc" %)**AT+DISMACANS=0**(%%) ~/~/ When the MACANS of the reply server plus the payload exceeds the maximum number of bytes of 11 bytes (DR0 of US915, DR2 of AS923, DR2 of AU195), the node will send a packet with a payload of 00 and a port of 4. (default)

)))

(((

(% _mstmutation="1" style="background-color:#dcdcdc" %)**AT+DISMACANS=1** (%%) ~/~/ When the MACANS of the reply server plus the payload exceeds the maximum number of bytes of the DR, the node will ignore the MACANS and not reply, and only upload the payload part.

1284

)))

1285

1286

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

1287

1288

(% class="wikigeneratedid" %)

1289

(% style="background-color:#dcdcdc" %)**0x21 00 01 ** (%%) ~/~/ Set the DISMACANS=1

(% style="color:blue" %)**Copy downlink to uplink：**

1294

1295

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

1296

1297

(((

1298

(% _mstmutation="1" style="background-color:#dcdcdc" %)**AT+RPL=5**(%%) ~/~/ After receiving the package from the server, it will immediately upload the content of the package to the server, the port number is 100.

1299

)))

1300

1301

(% class="wikigeneratedid" %)

1302

Example：(% style="background-color:#dcdcdc" %)**aa xx xx xx xx** (%%) ~/~/ aa indicates whether the configuration has changed, 00 is yes, 01 is no; xx xx xx xx are the bytes sent.

1303

1304

1305

(% class="wikigeneratedid" %)

1306

[[image:image-20220823173747-6.png||height="165" width="1124"]]

1307

1308

**For example, sending 11 22 33 44 55 66 77 will return invalid configuration 00 11 22 33 44 55 66 77.**

[[image:image-20220823173833-7.png||height="149" width="1124"]]

1313

1314

**For example, if 01 00 02 58 is issued, a valid configuration of 01 01 00 02 58 will be returned.**

(% style="color:blue" %)**Query version number and frequency band 、TDC：**

1319

1320

* (((

1321

(% style="color:#037691" %)**Downlink: 26 01 **(%%) ~/~/ Downlink 26 01 can query device upload frequency, frequency band, software version number, TDC time.

)))

**Example：**

[[image:image-20220823173929-8.png||height="76" width="1205"]]

(% style="color:blue" %)**Add rejoin feature if device offline：**

1332

1333

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

1334

1335

**AT+DDETECT=<Flag>,<ACK_Timout_1>,<ACK_Timout_2> (Default Value: AT+DDETECT=1,1440,2880)**

1336

1337

(% style="color:red" %)**Flag:** (%%) 1 Enable online detect，0: Disable online detect

1338

1339

(% style="color:red" %)**ACK_Timout_1:**(%%) Unit: min

1340

1341

(% style="color:red" %)**ACK_Timout_2:**(%%) Unit: min

1342

1343

1344

**Example: AT+DDETECT=1,1440,2880**

1345

1346

Enable Online Detect, if end node doesn't receive any downlink within ACK_Timout_1( 1440 minutes or 24 hours). End node will use confirmed uplink to send packets during ACK_Timout_1 (the 24th hour) to ACK_Timout_2 ( the 48th hour).

1347

1348

If from the 24th to 48th hour, end node got an downlink from server, it will switch back to unconfirmed uplink. end node will restart ACK_Timout_1.

1349

1350

If from the 24th to 48th hour, end node still not got any downlink, means device doesn't get ACK in 48 hours. Device will process rejoin, rejoin request interval is AT+RJTDC period. For AU915/ US915, device will use the sub-band used for last join.

* (((

(% style="color:#037691" %)**Downlink: 0x32 01 05A0 0B40 **

0x01 : Flag

0x05A0: ACK_Timout_1

0x0B40: ACK_Timout_2

)))

(% class="wikigeneratedid" %)

1367

(% style="color:blue" %)**Add new feature to control NBTrans for unconfirmed uplink mode：**

1368

1369

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

1370

1371

(% style="background-color:#dcdcdc" %)** AT+SETMAXNBTRANS=value1,value2 **(%%)** **~/~/ NBTrans specified how many re-transmission for each packet. If LoRaWAN LinkADR from server set NBTrans to high value. The battery will consume fast.

1372

1373

**AT+SETMAXNBTRANS=value1,value2 Default Value: AT+SETMAXNBTRANS=1,0**

1374

1375

(% style="color:red" %)**value1:** (%%) Set max NBTrans. For example, if value1(NBTrans)=1, end node set NBTrans max to 1 , even downlink LinkADR request end node to set NBTrans to higher value such as 6.

1376

1377

(% style="color:red" %)**value2:** (%%) 0: uplink fcnt doesn't change for each NBTrans; 1: uplink fcnt increase by 1 for each NBTrans.

1378

1379

set value2 to 1 for Chirpstack server, because Chirpstack will ignore same FCNT in re-transmission.

1380

1381

1382

**Example: AT+SETMAXNBTRANS=2,1**

1383

1384

Set max NBTrans to 2, fcnt will increase +1 for each NBTrans

* (((

(% style="color:#037691" %)**Downlink: 0x33 02 01**

value1=0x02

)))

(% class="wikigeneratedid" %)

value2=0x01

== 2.6 Show Data in Datacake IoT Server ==

(((

Datacake provides a human friendly interface to show the sensor data, once we have data in TTN V3, we can use Datacake to connect to TTN V3 and see the data in Datacake. Below are the steps:

)))

(((

)))

(((

(% style="color:blue" %)**Step 1**(%%)**:** Be sure that your device is programmed and properly connected to the network at this time.

)))

(((

(% style="color:blue" %)**Step 2**(%%)**:** To configure the Application to forward data to Datacake you will need to add integration. To add the Datacake integration, perform the following steps:

)))

[[image:1656385623971-339.png]]

1418

1419

1420

[[image:1656385646347-395.png]]

1421

1422

1423

[[image:1656385662459-942.png]]

1424

1425

1426

(% style="color:blue" %)**Step 3**(%%)**: **Create an account or log in Datacake.

1427

1428

1429

(% style="color:blue" %)**Step 4**(%%)**:** Search the LSN50 and add DevEUI.

1430

1431

1432

[[image:1656385688973-317.png]]

1433

1434

1435

== 2.7 Firmware Change Log ==

(((

**Firmware download: ** [[https:~~/~~/www.dropbox.com/sh/9k0a6sn8a94dc03/AAD54woDmnmAMUMY2WfKfjxoa?dl=0>>https://www.dropbox.com/sh/9k0a6sn8a94dc03/AAD54woDmnmAMUMY2WfKfjxoa?dl=0]]

)))

(((

**Firmware Change Log: **[[https:~~/~~/www.dropbox.com/sh/9k0a6sn8a94dc03/AAD54woDmnmAMUMY2WfKfjxoa?dl=0>>https://www.dropbox.com/sh/9k0a6sn8a94dc03/AAD54woDmnmAMUMY2WfKfjxoa?dl=0]]

)))

== 2.8 Use VDD or +5V to Power External Sensor ==

(((

User can use VDD or +5V to power external sensor.

)))

(((

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

)))

1. (((

VDD is 2.5~~3.3v from the battery + diode, the VDD is always on, so when use VDD to power external sensor, make sure the sensor has a low power consumption in sleep mode ( less 50 uA) to get a long battery life.

1461

)))

1462

1. (((

1463

+5V output is only ON when sampling. And MCU will turn off it after sampling. So if sensor can support 5v, +5V out is the best choice. [[See here for more info>>||anchor="H2.4.10A02B5VOutput"]].

)))

(((

(% style="color:red" %)**Note: Always test the actually current pass by the JP2 jumper when connect to a new type of sensor.**

)))

== 2.9 Battery & Power Consumption ==

1472

1473

1474

LSN50v2 uses ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.

1475

1476

[[**Battery Info & Power Consumption Analyze**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .

1477

1478

1479

= 3. Using the AT Commands =

1480

1481

== 3.1 Access AT Commands ==

1482

1483

1484

LSN50 supports AT Command set in the stock firmware. You can use a USB to TTL adapter to connect to LSN50 for using AT command, as below.

1485

1486

1487

(% style="color:#4472c4" %)**LSN50 v1 UART connection photo**

1488

1489

[[image:image-20220627165424-24.png||height="495" width="486"]]

(% style="color:#4472c4" %)**LSN50 v2 UART connection photo**

1494

1495

[[image:image-20220627165424-25.png||height="437" width="894"]]

(((

In the PC, you need to set the serial baud rate to (% style="color:green" %)**9600**(%%) to access the serial console for LSN50. LSN50 will output system info once power on as below:

)))

[[image:image-20220627165531-26.png||height="624" width="893"]](% style="display:none" %)

1504

1505

1506

== 3.2 Common AT Command Sequence ==

1507

1508

=== 3.2.1 Multi-channel ABP mode (Use with SX1301/LG308) ===

(((

(% style="color:#037691" %)**If device has not joined network via OTAA:**

)))

(((

(% style="background-color:#dcdcdc" %)**AT+FDR**

)))

(((

(% style="background-color:#dcdcdc" %)**AT+NJM=0**

)))

(((

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

)))

(((

(% style="color:#037691" %)**If device already joined network:**

)))

(((

(% style="background-color:#dcdcdc" %)**AT+NJM=0**

)))

(((

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

)))

=== 3.2.2 Single-channel ABP mode (Use with LG01/LG02) ===

1542

1543

1544

See [[Sect 6.7>>||anchor="H6.7A0HowtoconfiguretheEUIkeysinLSN503F"]]

1545

1546

1547

= 4. Upload Firmware =

1548

1549

1550

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

1551

1552

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

1553

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

1554

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

1555

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

1556

1557

1558

== 4.1 Upload Firmware via Serial Port ==

1559

1560

1561

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

1562

1563

1564

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

1565

1566

1567

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

1568

1569

1570

(% style="color:blue" %)**Step2**(%%)**:** Download the [[LSN50 Image files>>url:https://www.dropbox.com/sh/g99v0fxcltn9r1y/AADnMzn1IN0LssOQNHlvooTta/LSN50%20%26%20LSN50-v2/Firmware/LSN50.hex?dl=0&subfolder_nav_tracking=1]].

1571

1572

1573

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

1574

1575

1576

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

1577

1578

1579

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

1580

1581

1582

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

(((

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

)))

(((

The LSN50 will then run the new firmware.

)))

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

1595

1596

1597

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

1598

1599

1600

[[image:1656319349131-664.png]]

1601

1602

1603

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

1604

1605

* (% style="background-color:yellow" %)**ST-LINK v2 GND <~-~-> LSN50 GND**

1606

* (% style="background-color:yellow" %)**ST-LINK v2 SWCLK <~-~-> LSN50 PA14**

1607

* (% style="background-color:yellow" %)**ST-LINK v2 SWDIO <~-~-> LSN50 PA13**

1608

* (% style="background-color:yellow" %)**ST-LINK v2 RST <~-~-> LSN50 NRST**

1609

1610

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

1611

1612

1613

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

1614

1615

1616

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

1617

1618

1619

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

1620

1621

1622

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

(((

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

)))

(((

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

)))

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

1636

1637

1638

= 5. Developer Guide =

* (((

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

1643

)))

1644

* (((

1645

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

)))

(((

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

)))

* (((

Software Source Code: [[https:~~/~~/github.com/dragino/LoRa_STM32/tree/master/STM32CubeExpansion_LRWAN>>url:https://github.com/dragino/LoRa_STM32/tree/master/STM32CubeExpansion_LRWAN||_mstmutation="1"]]

1654

)))

1655

* (((

1656

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

1657

)))

1658

* (((

1659

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

)))

(((

Use Keil to open project file:

)))

(((

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

)))

(((

)))

(((

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

1676

)))

1677

1678

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

1679

1680

1681

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

1682

1683

1684

For example, change EU868 to US915

1685

1686

[[image:1656318662202-530.png]]

1687

1688

1689

**2. Compile and build**

1690

1691

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

= 6. FAQ =

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

(((

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? ==

1705

1706

1707

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

1708

1709

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

1710

1711

1712

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

1713

1714

1715

You can follow the instructions for [[how to upgrade image>>||anchor="H2.7200BFirmwareChangeLog"]].

1716

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

1717

1718

1719

== 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**:

1735

1736

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.

1737

1738

1739

Refs: [[https:~~/~~/www.dropbox.com/sh/u9s41qdx5yujwcb/AAAT5r4QkMaeOogWrzJt7Wn4a?dl=0>>https://www.dropbox.com/sh/u9s41qdx5yujwcb/AAAT5r4QkMaeOogWrzJt7Wn4a?dl=0]]

1740

1741

1742

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

1743

1744

1745

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

1746

1747

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

1748

1749

Compile it and Upload it to LSN50, the LSN50 will transfer on the frequency 868.3Mhz.

1750

1751

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

1752

1753

1754

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

1755

1756

1757

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

(((

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.

)))

(((

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.

)))

(((

)))

(((

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.

1774

)))

1775

1776

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

(((

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

)))

* (((

903.9 - SF7BW125 to SF10BW125

1785

)))

1786

* (((

1787

904.1 - SF7BW125 to SF10BW125

1788

)))

1789

* (((

1790

904.3 - SF7BW125 to SF10BW125

1791

)))

1792

* (((

1793

904.5 - SF7BW125 to SF10BW125

1794

)))

1795

* (((

1796

904.7 - SF7BW125 to SF10BW125

1797

)))

1798

* (((

1799

904.9 - SF7BW125 to SF10BW125

1800

)))

1801

* (((

1802

905.1 - SF7BW125 to SF10BW125

1803

)))

1804

* (((

1805

905.3 - SF7BW125 to SF10BW125

)))

* (((

904.6 - SF8BW500

)))

(((

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:

)))

(((

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

)))

(((

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

)))

(((

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.

)))

(((

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

1830

)))

1831

1832

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

1833

1834

1835

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

(((

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

)))

(((

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

)))

(((

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

)))

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

(((

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

)))

(((

(% style="color:red" %)**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]].**

)))

(((

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

)))

(((

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

)))

(((

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

)))

(((

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

)))

(((

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

)))

(((

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

)))

(((

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

)))

(((

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

)))

(((

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

)))

(((

As shown below:

)))

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

1908

1909

1910

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

(((

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

1915

It is recommended that you update the image to the latest version before configure the keys. Refer [[upgrade_image>>||anchor="H2.7200BFirmwareChangeLog"]] to update the firmware to the latest version.

)))

(((

Run AT commands to set the keys to desired keys; refer [[AT Command manual>>https://www.dragino.com/downloads/downloads/LSN50-LoRaST/DRAGINO_LSN50_AT_Commands_v1.6.3.pdf]].

)))

= 7. Trouble Shooting =

1924

1925

== 7.1 Connection problem when uploading firmware. ==

(((

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

)))

(((

)))

(((

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

)))

(((

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

)))

(((

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.

)))

(((

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

)))

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

(((

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.

)))

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

1962

1963

1964

It is due to channel mapping. Please see the [[Eight Channel Mode>>doc:Main.End Device AT Commands and Downlink Command.WebHome||anchor="H7.19EightChannelMode"]] section above for details.

1965

1966

1967

== 7.3 AT Command input doesn't work ==

1968

1969

1970

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-v2-XX-YY-ZZ(%%)**

1977

1978

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

1979

1980

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

1981

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

1982

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

1983

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

1984

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

1985

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

1986

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

1987

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

1988

1989

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

1990

1991

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

1992

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

1993

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

1994

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

1995

1996

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

1997

1998

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

1999

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

= 9. Packing Info =

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

2006

2007

**Package Includes**:

2008

2009

* LSN50 LoRa Sensor Node x 1

2010

2011

**Dimension and weight**:

2012

2013

* Device Size: 8 x 6.5 x 5 cm

2014

* Device Weight: 137g

2015

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

2016

* Weight / pcs : 160g

2017

2018

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

2019

2020

**Package Includes**:

2021

2022

* LSN50 v2 LoRa Sensor Node x 1

2023

* External antenna x 1

2024

* Spring Antenna (evaluate purpose)

2025

2026

**Dimension and weight**:

2027

2028

* Device Size: 9.7 x 6.5 x 4.7 cm

2029

* Device Weight: 150g

2030

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

2031

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

2038

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

2045

* [[Data Sheet, Document Base>>https://www.dropbox.com/sh/djkxs7mr17y94mi/AABVlWbM9uzK9OA3mXyAT10Za?dl=0]]

2046

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

2047

)))

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

Applications

Navigation