LoRaWAN IoT Kit v3 User Manual

(% style="color:blue" %)**Dragino LoRaWAN IoT Kit v3**(%%) is designed to facilitate beginners and developers to quickly learn and demonstrate LoRa/LoRaWAN and IoT technology. It helps users to turn the idea into a practical application and make the Internet of Things a reality.

21

)))

22

23

(((

24

The LoRaWAN IoT Kit v3 can be used to evaluate the multi-channel LoRaWAN solution and single-channel private LoRa solution. Users can also use LoRaWAN IoT Kit v3 to test different network structure solutions and find the best for their IoT solution.

)))

(((

The LoRaWAN IoT kit v3 (% style="color:blue" %)**shows how to build a LoRaWAN network**(%%), and (% style="color:blue" %)**how to use the network to send data from a LoRa sensor node to the cloud server.** (%%)Depends on the actually use environment, the LoRaWAN gateway will connect your other LoRa nodes up to 500 ~~ 5,000 meters.

)))

== 1.2 Features ==

* Open Source LoRa/LoRaWAN kits

35

36

* Support multi-channels LoRaWAN and Single-Channel LoRa

37

38

* Support various network structures

39

40

== 1.3 What can you learn from the kit? ==

41

42

43

(% style="color:blue" %)**The goals through this LoRaWAN IoT kit v3**:

44

45

* Understand the structure of an Internet of Things network, and how does an IoT network works

46

47

* Learn coding method for Arduino micro controller

48

49

* Learn some common sensors.

50

51

* Learn some basic commands for Linux

52

53

* Learn about LoRaWAN and how to set up a LoRaWAN network.

54

55

* Learn about Node-Red and how to set up it as IoT server and plot data.

56

57

* Learn different way to connect LoRaWAN network to IoT Server and compare their advantages / disadvantages.

58

59

== 1.4 What parts Dragino LoRa IoT v3 includes? ==

60

61

62

[[image:1669019631002-626.png]]

(% style="color:blue" %)**LoRaWAN IoT Kit v3 Packing List**:

67

68

* [[LPS8v2>>url:https://www.dragino.com/products/lora-lorawan-gateway/item/228-lps8v2.html]] LoRaWAN Gateway

69

70

* [[LA66 LoRaWAN Shield>>url:https://www.dragino.com/products/lora/item/231-la66-lorawan-shield.html]] for Arduino

71

72

* [[LA66 USB LoRaWAN Adapter>>url:https://www.dragino.com/products/lora/item/232-la66-usb-lorawan-adapter.html]] for PC/Mobile/RPi

73

74

* 1 x DHT11 Temperature & Humidity Sensor

* 1 x RGB LED

* 20 x dupont cable (male to male)

79

80

* 20 x dupont cable (female to female)

81

82

* 20 x dupont cable (male to female)

83

84

= 2. Example 1: Test a LoRaWAN network =

85

86

87

This example describes how to use LPS8v2, LA66 Shield & LA66 USB to set up a LoRaWAN network and connect it to [[TTNv3 LoRaWAN Server>>url:https://accounts.thethingsindustries.com/]]. It also shows how to use external application server to monitor / manage the LoRa Nodes.

88

89

The network structure of this example is as below.

90

91

92

[[image:1669019691933-772.png]]

93

94

95

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

96

97

~1. Register LPS8v2 gateway to TTN so provide a LoRaWAN coverage. See section “[[Gateway Registration for Semtech UDP ~~-~~-~> Primary LoRaWAN Server>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Notes%20for%20TTN/#H2.A0GatewayRegistrationforSemtechUDP]]”

98

99

2. Register LA66 Shield to TTN and uplink Temperature to TTN. See section “[[Example: Log Temperature Sensor(DHT11) and send data to TTN, show it in Node-RED>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LA66%20LoRaWAN%20Shield%20User%20Manual/#H1.7A0Example:LogTemperatureSensor28DHT1129andsenddatatoTTN2CshowitinNode-RED.]].”

100

101

3. Register LA66 USB to TTN and track people location. See “[[Example: Use of LA66 USB LoRaWAN Adapter and mobile APP>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LA66%20USB%20LoRaWAN%20Adapter%20User%20Manual/#H1.9A0Example:UseofA0LA66USBLoRaWANAdapterandmobileAPP]]”

102

103

104

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

105

106

[[image:1669019732684-677.png]]

= 3. Example 2: Test Built-In LoRaWAN Server =

111

112

113

This example describes how to use LPS8v2, LA66 Shield & LA66 USB to set up a LoRaWAN network and connect it to built-in LoRaWAN Server in. It also shows how to use external application server to monitor / manage the LoRa Nodes.

114

115

116

[[image:1669019757521-444.png]]

117

118

119

This example is almost the same as Example1, the difference is that this example use the built-in LoRaWAN server (TTNv3 Stack) in LPS8v2. While Example 1 use the public TTN server.

120

121

TTN v3 stack has the same configure method as the public TTN server. When user test example 2 here. User need to log in the TTNv3 stack in LPS8v2 as per below:

122

123

**Input URL( __http:~/~/<hostname>:8080 or http:~/~/<local-IPV4-address> __) in your browser.**

124

125

**Such as __http:~/~/dragino-54ff12:8080 or http:~/~/<Local-IPV4-Address>__**

126

127

128

(% style="color:blue" %)**Login account:**

**User ID: admin**

**Password: dragino**

133

134

[[image:1669019821266-501.png]]

= 4. Example 3: Test Built-in LoRaWAN server and Application server =

139

140

141

This example describes how to use LPS8v2, LA66 Shield & LA66 USB to set up a LoRaWAN network and connect it to built-in LoRaWAN Server in. It also shows how to use external application server to monitor / manage the LoRa Nodes.

142

143

144

[[image:1669019855783-448.png]]

145

146

147

This example is quite similiar as Example2, the difference is that this example use the built-in Application server (Node-Red) in LPS8v2. While Example 2 use the public Node-Red

148

149

Below is the Node-Red access instruction of LPS8v2:

150

151

You can access the gateway's built-in AS server of Node-Red via the **URL(__http:~/~/<hostname>:1880 or http:~/~/<local-IPV4-address>__)** in your browser.

152

153

**Such as __http:~/~/dragino-54ff12:1880 or [[http:~~/~~/<Local-IPV4-Address~>>>http://<Local-IPV4-Address>]]__**

154

155

156

[[image:1669019884655-805.png]]

157

158

159

= 5. Example 4: Peer to Peer Test on end node =

160

161

162

This example describes how to test peer to peer communicate between LoRa End Node.

163

164

165

[[image:1669019964124-630.png]]

166

167

168

In this example, the end nodes LA66 Shield and LA66 USB are not use LoRaWAN protocol. Users need to flash them with the firmware support private LoRa.

169

170

* **Software Location: [[LA66 Peer to Peer firmware>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LA66%20LoRaWAN%20Shield%20User%20Manual/Instruction%20for%20LA66%20Peer%20to%20Peer%20firmware/]]**

171

172

* **How to Flash Firmware: [[For LA66 Shield>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LA66%20LoRaWAN%20Shield%20User%20Manual/#H1.9A0UpgradeFirmwareofLA66LoRaWANShield]] , For [[LA66 USB>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LA66%20USB%20LoRaWAN%20Adapter%20User%20Manual/#H1.10A0UpgradeFirmwareofLA66USBLoRaWANAdapter]].**

173

174

This example will show how to get Temperature sensor value from LA66 Shield and send it to LA66 USB. LA66 USB is connected to mobile phone. So user can see the temperature value in mobile phone directly . User can also send message from mobile phone to LA66 to control the RGB LED.

175

176

177

== 5.1 Set Up LA66 Shield + UNO ==

178

179

=== 5.1.1 Set up LA66 Module ===

180

181

182

LA66 Module is loaded with the firmware [[LA66 Peer to Peer firmware>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LA66%20LoRaWAN%20Shield%20User%20Manual/Instruction%20for%20LA66%20Peer%20to%20Peer%20firmware/]] and user can use AT Command to set up LA66 with below parameters:

183

184

185

(% style="color:#037691" %)**AT+FRE=904.100,904.100 ** (%%) ~-~--> TX and RX frequency set: 9041100000

186

187

(% style="color:#037691" %)**AT+BW=0,0 ** (%%) ~-~--> TX and RX Bandwidth set: 125kHz

188

189

(% style="color:#037691" %)**AT+SF=12,12 ** (%%) ~-~--> TX and RX Spreading Factor set: SF10

190

191

(% style="color:#037691" %)**AT+CRC=1,1 ** (%%) ~-~--> 0: CRC OFF ,1: CRC ON

192

193

(% style="color:#037691" %)**AT+HEADER=0,0** (%%) ~-~--> Header Type: explicit, explicit

194

195

(% style="color:#037691" %)**AT+CR=1,1 ** (%%) ~-~--> CR: 4/5, 4/5

196

197

(% style="color:#037691" %)**AT+IQ=0,0** (%%) ~-~--> Invert IQ: 0,0

198

199

(% style="color:#037691" %)**AT+PREAMBLE=8,8 ** (%%) ~-~--> TX and RX Preamble Length set: 8

200

201

(% style="color:#037691" %)**AT+SYNCWORD=0** (%%) ~-~--> Syncword**(0: private，1: public)**

202

203

(% style="color:#037691" %)**AT+RXMOD=6,0 ** (%%) ~-~--> Rx Timeout and Reply mode

=== 5.1.2 Hardware Connection ===

[[image:1669020260360-253.png]]

212

213

214

There is a sensor DHT11 (Temperature & Humidity sensor) and LED RGB connected to LA66 Shield + UNO. Please use the connection as we show in the photo.

215

216

217

=== 5.1.3 Set up Arduino UNO ===

218

219

220

The sketch for this example is [[Log-Temperature-Sensor-and- Control-RBG-LED.ino>>url:https://www.dropbox.com/sh/r5l3h5fhifrqbxn/AACgNoQ-aYnvWOxGwUDWxNlFa?dl=0]]

221

222

223

(% style="color:blue" %)**Upload the code to UNO:**

224

225

[[image:1669020288319-334.png]]

(% style="color:blue" %)**Check the LA66 Shield data:**

230

231

[[image:1669020309356-484.png]]

232

233

234

== 5.2 Set Up LA66 USB ==

235

236

237

LA66 USB is loaded with the firmware [[LA66 Peer to Peer firmware>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LA66%20LoRaWAN%20Shield%20User%20Manual/Instruction%20for%20LA66%20Peer%20to%20Peer%20firmware/]] and user can use AT Command to set up LA66 USB with below parameters:

238

239

240

(% style="color:#037691" %)**AT+FRE=904.100,904.100**(%%) ~-~-> TX and RX frequency set: 904100000

241

242

(% style="color:#037691" %)**AT+BW=0,0** (%%) ~-~-> TX and RX Bandwidth set: 125kHz

243

244

(% style="color:#037691" %)**AT+SF=10,10** (%%) ~-~-> TX and RX Spreading Factor set: SF10

245

246

(% style="color:#037691" %)**AT+CRC=1,1** (%%) ~-~-> 0: CRC OFF ,1: CRC ON

247

248

(% style="color:#037691" %)**AT+HEADER=0,0** (%%) ~-~-> Header Type: explicit, explicit

249

250

(% style="color:#037691" %)**AT+CR=1,1** (%%) ~-~-> CR: 4/5, 4/5

251

252

(% style="color:#037691" %)**AT+IQ=0,0** (%%) ~-~-> Invert IQ: 0,0

253

254

(% style="color:#037691" %)**AT+PREAMBLE=8,8** (%%) ~-~-> TX and RX Preamble Length set: 8

255

256

(% style="color:#037691" %)**AT+SYNCWORD=0** (%%) ~-~-> Syncword**(0: private，1: public)**

257

258

(% style="color:#037691" %)**AT+RXMOD=65535,0** (%%) ~-~-> Set the receive mode

259

260

(% style="color:#037691" %)**AT+RXDAFORM=1** (%%) ~-~-> ASCII to string

261

262

263

Users using USB to Type-C adapter is needed to connect to a Mobile phone, Users need to download the USB Serial APP in their phones.

264

265

For example, [[USB Serial Console>>url:https://play.google.com/store/apps/details?id=jp.sugnakys.usbserialconsole]] (Android Version Only)

266

267

268

[[image:1669020888886-358.png]]

269

270

271

The serial port configuration for LA66 USB is as follows:

272

273

[[image:1669021003598-788.png]] [[image:1669021009003-965.png]]

274

275

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

276

277

== 5.3 Test result ==

278

279

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

280

281

Users can view the temperature and humidity information received by LA66 USB in the mobile APP

282

283

[[image:1669021002246-577.png]] [[image:1669021002645-501.png]]

284

285

Send a message to the LA66 USB control LA66 Shield + UNO external RBG LED through the mobile phone:

286

287

288

For example, if you send **AT+SEND=1,000101,2,0** the (% style="display:none" %) (%%)RBG LED will light up red.(% style="display:none" %)

289

290

[[image:1669021075655-472.png]](% style="display:none" %)

[[image:1669021098924-484.png]]

= 6. Example 5: Peer to Peer Test and plot the data in LPS8v2 =

300

301

This example describes how to test peer to peer communicate between LoRa End Node and LoRa Gateway.

302

303

[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image020.png]]

304

305

In this example, the end nodes LA66 Shield and LA66 USB are not use LoRaWAN protocol. Users need to flash them with the firmware support private LoRa.

306

307

* (% style="color:blue" %)Software Location(%%): [[LA66 Peer to Peer firmware>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LA66%20LoRaWAN%20Shield%20User%20Manual/Instruction%20for%20LA66%20Peer%20to%20Peer%20firmware/]]

308

309

* (% style="color:blue" %)How to Flash Firmware(%%): [[For LA66 Shield>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LA66%20LoRaWAN%20Shield%20User%20Manual/#H1.9A0UpgradeFirmwareofLA66LoRaWANShield]] , For [[LA66 USB>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LA66%20USB%20LoRaWAN%20Adapter%20User%20Manual/#H1.10A0UpgradeFirmwareofLA66USBLoRaWANAdapter]].

310

311

This example will show how to get Temperature sensor value from LA66 Shield and send it to LA66 USB. LA66 USB is connected to LPS8v2. LPS8v2 will receive the data from LA66 USB and plot the data in the built-in Node-Red server.

312

313

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

314

315

1. LPS8v2 has LoRaWAN concentrator which doesn’t do anything in this example. This example doesn’t need this SX1302 concentrator.

316

2. For mass deployment, user can use the LG01v2 instead of LPS8v2+LA66 USB. LG01v2 already include LA66 module inside.

317

318

Use can check [[THIS LINK>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20All%20Gateway%20models/LG01v2/#H5.2Example:LG01v2]] for an instruction of this example. In the link it uses LG01v2 as example, the use for LPS8v2+LA66 USB is the same as LG01v2.

= 7. Example 6: Limited LoRaWAN relay =

324

325

326

This example describes a limited LoRaWAN relay method with the use of LA66 module.

327

328

329

[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image021.png]]

330

331

332

In this example, the end nodes LA66 Shield and LA66 USB are not use LoRaWAN protocol. Users need to flash them with the firmware support private LoRa.

333

334

* (% style="color:blue" %)**Software Location**(%%): [[LA66 USB use LoRaWAN firmware>>url:https://www.dropbox.com/sh/els49fz9rd6fu1y/AAAt-kKIvXu1ZOK0hWysq97na?dl=0]], [[LA66 Shield use Point to Point firmware>>url:https://www.dropbox.com/sh/els49fz9rd6fu1y/AAAt-kKIvXu1ZOK0hWysq97na?dl=0]].

335

336

* (% style="color:blue" %)**How to Flash Firmware**(%%): [[For LA66 Shield>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LA66%20LoRaWAN%20Shield%20User%20Manual/#H1.9A0UpgradeFirmwareofLA66LoRaWANShield]] , For [[LA66 USB>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LA66%20USB%20LoRaWAN%20Adapter%20User%20Manual/#H1.10A0UpgradeFirmwareofLA66USBLoRaWANAdapter]].

337

338

(% style="color:red" %)Note: LA66 USB use a LoRaWAN version firmware and user need to set it to work in fix frequency, fix DR and ABP mode. LA66 already register to TTNv3 in ABP mode.

339

340

341

== 7.1 Set up LA66 USB ==

342

343

LA66 USB is loaded with the firmware [[LA66 USB use LoRaWAN firmware>>url:https://www.dropbox.com/sh/els49fz9rd6fu1y/AAAt-kKIvXu1ZOK0hWysq97na?dl=0]] and user can use AT Command to set up LA66 with below parameters:

344

345

AT+CHS=904100000 ~-~-> Fix frequency

346

347

AT+NJM=0 ~-~->Set the ABP mode

348

349

AT+ADR=0 ~-~->Close ADR

350

351

AT+DR=0 ~-~-> Fix DR=0

352

353

Set up LA66 USB t work in ABP mode, use fix frequency(904100000) and fix DR0(SF10) to transmit data.

== 7.2 Set up LA66 Shield ==

358

359

LA66 Shield is loaded with the firmware [[LA66 Shield use Point to Point firmware>>url:https://www.dropbox.com/sh/els49fz9rd6fu1y/AAAt-kKIvXu1ZOK0hWysq97na?dl=0]], LA66 Shield as Relay needs to be configured as follows:

360

361

AT+FRE=904.100,904.100 ~-~->TX and RX frequency set: 904100000

362

363

AT+BW=0,0 ~-~->TX and RX Bandwidth set: 125kHz

364

365

AT+SF=10,10 ~-~->TX and RX Spreading Factor set: SF10(corresponding toDR=0)

366

367

AT+CRC=1,1 ~-~->0: CRC OFF ,1: CRC ON

368

369

AT+HEADER=0,0 ~-~->Header Type: explicit, explicit

370

371

AT+CR=1,1 ~-~->CR: 4/5, 4/5

372

373

AT+IQ=0,0 ~-~->Invert IQ: 0,0

374

375

AT+PREAMBLE=8,8 ~-~->TX and RX Preamble Length set: 8

376

377

AT+SYNCWORD=1 ~-~->Syncword**(0: private，1: public)**

378

379

AT+RXMOD=65535,1 ~-~->Set the Relay mode

380

381

AT+WAITTIME=1000 ~-~->Relay wait time 1000ms

== 7.3 Uplink test ==

386

387

Users can connect to the LA66 USB using the serial port tool and enter the AT command: AT+SENDB=01,02,8,05820802581ea0a5

388

389

Command format: AT+SENDB=<confirn_status>,<Fport>,<data_len>,<data>

390

391

[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image022.png]]

392

393

394

In addition, users can also access LA66 USB using the mobile app [[Download Link for Android apk >>url:https://www.dropbox.com/sh/zxwx16qb777uvkz/AABE_P8coGCQ4DAC8enH4bUya?dl=0]] (Android Version Only)

395

396

[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image023.jpg]]

== 7.4 Test result ==

401

402

See two duplicate messages on Gateway Traffic.

403

404

[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image024.png]]

405

406

407

Bring LA66 USB and walk to a remote location to get the max distance. At this point,RSSi=-134 SNR=13.8, Go back 100 meters and put the LA66 Shield (Relay) in the location, Due to the following examples, there may be errors in the test in the urban area.

408

409

[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image025.png]]

Without Relay, the LA66 USB can reach about 833meters. [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image026.png]]

414

415

With Relay, the LA66 USB can reach around 2km.

416

417

[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image027.jpg]]

= 8. Technical Support =

425

426

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

427

428

* 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

429

430

[[support@dragino.com>>url:file:///D:/市场资料/说明书/LoRa/LG02/support@dragino.com]]

= 9. Reference =

1. [[LoRaWAN official website. And Technicel document for LoRaWAN.>>url:https://lora-alliance.org/lorawan-for-developers]]

437

438

2. [[LoRa Low Energy design guide>>url:https://www.semtech.com/uploads/documents/LoraLowEnergyDesign_STD.pdf]] and [[Calculator Tool>>url:https://www.semtech.com/uploads/documents/SX1272LoRaCalculatorSetup1_1.zip]].

439

440

3. About Distance: [[LoRa Modem Design Guide>>url:https://www.semtech.com/uploads/documents/LoraDesignGuide_STD.pdf]]

441

442

4. User Manual: [[LPS8v2>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20All%20Gateway%20models/HP0C/]], [[LA66 LoRaWAN Shield>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LA66%20LoRaWAN%20Shield%20User%20Manual/]] , [[LA66 USB LoRaWAN Adapter>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LA66%20USB%20LoRaWAN%20Adapter%20User%20Manual/]]

443

444

Wiki source code of LoRaWAN IoT Kit v3 User Manual

Applications

Navigation