PG1302 - LoRaWAN Concentrator User Manual

The PG1302 is a (% style="color:green" %)**multi-channel high-performance transmitter/receiver**(%%) designed to simultaneously receive several LoRa packets using random spreading factors on random channels. Its goal is to enable robust connection between a central wireless data concentrator and a massive amount of wireless end-points spread over a very wide range of distances.

24

)))

25

26

(((

27

The PG1302 is designed to use with Raspberry Pi to build smart metering fixed networks and Internet of Things applications with up to 5000 nodes per km2 in a moderately interfered environment.

)))

(((

PG1302 is fully compatible with (% style="color:green" %)**RPi3/4 or Tinker Board**(%%), users can use the pre-build OS from Dragino to set up and easy to use the module by Web UI. Or install the raw LoRaWAN driver in the existing OS.

)))

== 1.2 Features ==

* Base on Semtech SX1302 solution

39

* Support Raspberry Pi 3B/3B+/4, TinkerBoard2/2S, Orange Pi Pc/PC PLUS.

40

* Up to -140dBm sensitivity

41

* Support 3.3v and 5v.

42

* Mini-PCIe Interface

43

* Converter board to support Raspberry Pi

44

45

== 1.3 General Interfaces for PG1302 ==

46

47

48

* SPI interface for LoRa

49

* Power Input: 5v, 1A

50

* 1 x I-PEX for LoRa

51

* Working Temperature: -40 ℃ ~~ 80℃

52

53

== 1.4 Pin Mapping ==

54

55

56

[[image:1651743282627-547.png||height="402" width="425"]]

== 1.5 LEDs ==

(((

TX: Blink when transmit a packet

64

RX: Blink when receive a packet

Config: Always ON

)))

== 1.6 Power Consumption ==

<300mA @ 3.3v.

Detail Test Report see [[this link>>https://www.dropbox.com/sh/89virm4y0b02c7i/AAA-cgQEsSc8gNGFYAB0qZ_Za?dl=0]]

75

76

77

== 1.7 Applications ==

78

79

80

* Smart Buildings & Home Automation

81

* Logistics and Supply Chain Management

* Smart Metering

* Smart Agriculture

* Smart Cities

* Smart Factory

= 2. Example: Set up as LoRaWAN gateway =

88

89

== 2.1 System structure ==

(((

This example is an example to show how to set up the PG1302 + RPi as a LoRaWAN gateway to use with [[TheThingsNetwork>>url:http://www.thethingsnetwork.org/]](TTN) LoRaWAN server. Set up method for other server are similar.

)))

[[image:1651743698677-436.png||height="457" width="686"]]

99

100

101

== 2.2 Hardware Installation ==

102

103

104

(% style="color:red" %)**Important Notice: Please power the RPI with 5V,3A cable.**

105

106

[[image:image-20220621104746-1.png||height="381" width="451"]]

107

108

109

= 3. Install the software? =

110

111

112

**Raspberry Pi 3B/3B+/4,**

113

114

* Flash SD card with Dragino pre-build image which supports Web UI.

115

* Install [[Dragino-FWD>>http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20All%20Gateway%20models/PG1302/#H5.2.2.A0Selecttheappropriatedeviceversiontodownload:]] in existing RPi OS.

116

117

**TinkerBoard2/2S, **

118

119

* Install [[Dragino-FWD>>http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20All%20Gateway%20models/PG1302/#H5.2.2.A0Selecttheappropriatedeviceversiontodownload:]] in the existing OS.

120

121

**Orange Pi PC/PC PLUS.**

122

123

* Install [[Dragino-FWD>>http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20All%20Gateway%20models/PG1302/#H5.2.2.A0Selecttheappropriatedeviceversiontodownload:]] in the existing OS.

124

125

= 4. Flash with pre-build image =

126

127

== 4.1 Download the dragino image for RPI ==

(((

Download PG1302_for_Rpi4_64_with_webui from: [[https:~~/~~/www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0>>https://www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0]]

)))

== 4.2 Flash the image to an SD card ==

136

137

138

Flash the image to the SD card:

139

140

[[image:1651744119133-233.png||height="373" width="621"]]

141

142

143

(% style="color:red" %)**Note: Download the flash tool following this link：**[[https:~~/~~/www.balena.io/etcher/>>https://www.balena.io/etcher/]]

144

145

146

== 4.3 Access the Linux console ==

(((

Connect the RPI Ethernet port to your router, RPi will obtain an IP address from your router. In the router's management portal, you should be able to find what IP address the router has assigned to the RPI. You can use this IP to connect the WEB UI or SSH access of RPI. Make sure your PC and the RPI is in the same network, then use a SSH tool (such as [[putty>>url:http://www.chiark.greenend.org.uk/~~sgtatham/putty/download.html]]) to access it. Below are screenshots

)))

[[image:1651744193675-591.png||height="450" width="466"]]

155

156

The account details for Web Login are:

157

158

(((

159

**~ (% style="color:#0000ff" %)User Name: root(%%)**

)))

(((

**~ (% style="color:#0000ff" %)Password: dragino(%%)**

)))

(((

)))

(((

**~ (% style="color:#0000ff" %)Backup account(%%)**

)))

(((

**~ (% style="color:#0000ff" %)Pi/dragino(%%)**

)))

After logging in, you will be in the Linux console and type the command here.

181

182

[[image:1651744358515-107.png||height="366" width="581"]]

183

184

185

== 4.4 Access the WebUI of RPi4 ==

186

187

=== 4.4.1 Home page ===

(((

Open a browser on the PC and type the RPI ip address **http:~/~/IP_ADDRESS ** (If the IP is assigned by the uplink router)

192

You will see the login interface of RPI as shown below.

193

The account details for Web Login are:

)))

(((

**~ (% style="color:#0000ff" %)User Name: root(%%)**

198

(% style="color:#0000ff" %)** Password: dragino**

)))

[[image:1651744457761-993.png||height="352" width="621"]]

204

205

206

=== 4.4.2 LoRa Page ===

207

208

209

This page shows the LoRa Radio Settings. There are a set of default frequency band according to LoRaWAN protocol, and user can customize the band* as well.

210

211

212

[[image:1651744554845-970.png||height="328" width="621"]]

213

214

215

Different PG1302 hardware version can support different frequency range:

216

217

* (% style="color:red" %)**868: valid frequency: 863Mhz ~~ 870Mhz. for bands EU868, RU864, IN865 or KZ865.**

218

* (% style="color:red" %)**915: valid frequency: 902Mhz ~~ 928Mhz. for bands US915, AU915, AS923 or KR920**

219

220

After user choose the frequency plan, he can see the actually frequency in used by checking the (% style="color:#037691" %)**page LogRead ~-~-> LoRa Log**

221

222

(% style="color:red" %)**Note *: [[See this instruction for how to customize frequency band>>doc:Main.How to customized LoRaWAN frequency band.WebHome]]**

223

224

225

=== 4.4.3 LoRaWAN Page ===

226

227

==== 4.4.3.1 Semtech UDP ====

228

229

230

[[image:1651744767914-283.png||height="352" width="621"]]

231

232

233

(% style="color:red" %)**Note *: [[See this instruction for how to configure TTN>>doc:Main.Notes for TTN.WebHome]].**

234

235

236

==== 4.4.3.2 Basic Station ====

237

238

239

[[image:1651744890629-683.png||height="380" width="621"]]

240

241

242

(% style="color:red" %)**Note *: [[See this instruction for how to configure AWS-loT-Core>>doc:Main.AWS IoT Core for LoRaWAN.WebHome]].**

243

244

245

=== 4.4.4 LogRead ===

246

247

==== 4.4.4.1 LoRa Log ====

248

249

250

[[image:1651744955955-452.png||height="571" width="621"]]

251

252

253

Show the frequency for LoRa Radio and traffics.

254

255

256

==== 4.4.4.2 System Log ====

Show system log.

[[image:1651745003470-264.png||height="477" width="621"]]

263

264

265

==== 4.4.4.3 Record Log ====

266

267

268

**Record the system log.**

269

270

271

[[image:1651745069814-662.png||height="144" width="621"]]

272

273

274

= 5. Install stand-alone LoRa Packet Forwarder =

275

276

== 5.1 Choose the right installation package for your OS ==

(((

**draginofwd-32bit (RPI, Orange PI)**

281

282

**Download URL:** https:~/~/www.dragino.com/downloads/downloads/LoRa_Gateway/PG1302/software/draginofwd-32bit.deb

283

284

**Linux Command:** wget https:~/~/www.dragino.com/downloads/downloads/LoRa_Gateway/PG1302/software/draginofwd-32bit.deb && dpkg -i draginofwd-32bit.deb

285

286

287

**dragino-64bit (RPI, Orange PI)**

288

289

**Download URL: **https:~/~/www.dragino.com/downloads/downloads/LoRa_Gateway/PG1302/software/draginofwd-64bit.deb

290

)))

291

292

**Linux Command: **wget https:~/~/www.dragino.com/downloads/downloads/LoRa_Gateway/PG1302/software/draginofwd-64bit.deb && dpkg -i draginofwd-64bit.deb

293

294

295

**dragino-tiker-32bit (Tinker Board)**

296

297

**Download URL: **https:~/~/www.dragino.com/downloads/downloads/LoRa_Gateway/PG1302/software/draginofwd-tinker-32bit.deb

298

299

**Linux Command: **wget https:~/~/www.dragino.com/downloads/downloads/LoRa_Gateway/PG1302/software/draginofwd-tinker-32bit.deb && dpkg -i draginofwd-tinker-32bit.deb

**Install details:**

[[image:image-20220928181226-1.png||height="218" width="1100"]]

305

306

307

RPI in this example is RPI model 4B with fresh Raspbian OS install.

(% class="box" %)

(((

pi@raspberrypi:~~$ cat /etc/os-release

312

PRETTY_NAME="Raspbian GNU/Linux 8 (jessie)"

313

NAME="Raspbian GNU/Linux"

VERSION_ID="8"

VERSION="8 (jessie)"

ID=raspbian

ID_LIKE=debian

HOME_URL="http:~/~/www.raspbian.org/"

319

SUPPORT_URL="http:~/~/www.raspbian.org/RaspbianForums"

320

BUG_REPORT_URL="http:~/~/www.raspbian.org/RaspbianBugs"

)))

== 5.2 Select the mode of connection to the server ==

327

328

329

The Dragino LoRa Packet Forware supports the Semtech UDP and Basic Station mode.

330

331

The User can choose one of the methods as the connection mode.

332

333

334

**~1. Semtech UDP Mode ~-~-> 5.2.1**

335

336

**2. Basic Station Mode ~-~-> 5.2.2**

337

338

339

=== 5.2.1 Semtech UDP Mode ===

340

341

342

==== a). Get a gateway EUI from the device ETH MAC. ====

343

344

345

In RPI, run the below command to get a Gateway ID

346

347

(% class="box infomessage" %)

(((

**~ ifconfig eth0**

)))

[[image:1651745210205-512.png||height="130" width="621"]]

(((

(((

We got the ether (eth0 MAC) address is b8:27:eb:49:62:bc). Add ffff at the end and remove “:” to get the gateway ID: b827ebxxxxbcffff. Input this to TTN v3. Make sure to select legacy packet forwarder.

==== b). Input this Gateway EUI to the TTN-Stack ====

)))

)))

[[image:1651745267862-321.png||height="526" width="621"]]

366

367

[[image:1651745306744-481.png||height="478" width="621"]]

368

369

370

==== c). After Register, the status should show not connected as below: ====

371

372

[[image:1651745366987-458.png||height="363" width="621"]]

373

374

375

==== d). Enable SPI and I2C on your device ====

376

377

**the below example is using Raspberry 4B.**

378

379

380

Run (% style="background-color:yellow" %) **sudo raspi-config**(%%) to open the config window

381

382

[[image:1651745476754-240.png||height="234" width="629"]]

383

384

385

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

386

387

388

[[image:image-20220505181135-2.png||height="229" width="622"]]

==== e). Access the root account: ====

393

394

(((

395

[[image:1651745583363-614.png||height="151" width="732"]]

)))

==== f). Modify the configuration of FWD ====

(((

After installation, user can find the configuration file in** (% style="color:#0000ff" %)/etc/lora/ (%%)**Replace the gateway ID we got above to the (% style="color:#0000ff" %)**gateway_ID** (%%)in file (% style="color:#0000ff" %)**local_conf.json.**

)))

(((

The default LoRaWAN server points to localhost, user need to put the correct server address to the server_address field in file (% style="color:#0000ff" %)**local_conf.json**(%%), like below.

409

410

411

the User can find the lora configuration directory in (% style="color:#0000ff" %)**/etc/lora/**(%%) there are the cfg-302 directory and the global_conf.json, and local_conf.json files.

412

413

/etc/lora/

414

├── cfg-302 ~-~--> global configuration file

415

├── devskey ~-~--> Database

416

├── global_conf.json ~-~--> Frequency plan for current applications

417

└── local_conf.json ~-~--> Local fwd configuration

418

419

At default, the users need to change two configurations file: global_conf.json and local_conf.json.

420

421

===== **1.) Configure gateway EUI and server address, port for fwd** =====

)))

[[image:1651745709709-887.png||height="820" width="621"]]

427

428

429

**Note: Users can find the TTN v3 server address from [[Server Addresses ~| The Things Stack for LoRaWAN (thethingsindustries.com)>>url:https://www.thethingsindustries.com/docs/getting-started/server-addresses/#deployments]]**

430

431

432

===== **2). Override the global_conf.json file by selecting the appropriate frequency plan for your region in cfg-302** =====

433

434

435

the default frequency band is US915 in the (% style="color:#0000ff" %)**global_conf.json**(%%) file.

436

437

[[image:1651745838008-820.png||height="650" width="621"]]

438

439

440

If the user wants to change to other frequency bands, the User can copy the file from(% style="color:#0000ff" %)** /etc/lora/cfg-302**(%%) ** **and put it into** (% style="color:#0000ff" %)/etc/lora/global_conf.json(%%).**

441

442

**//eg: cp /etc/lora/cfg-302/EU-global_conf.json /etc/lora/global_conf.json //**

====== **Selecting the appropriate frequency plan for your region in cfg-302.** ======

447

448

[[image:1651745867516-322.png||height="83" width="740"]]

449

450

451

====== **Override the global_conf.json** ======

452

453

(% class="box infomessage" %)

454

(((

455

**cp /etc/lora/cfg-302/EU-global_conf.json /etc/lora/global_conf.json**

456

)))

457

458

[[image:1651745984006-868.png||height="87" width="745"]]

459

460

461

==== (% style="color:inherit; font-family:inherit; font-size:23px" %)g). Running the Fwd Server(%%) ====

(((

Run the below command to restart the dragino_fwd:

)))

(((

(% class="box infomessage" %)

470

(((

471

**sudo systemctl start draginofwd**

)))

)))

(((

debug check the ruing status of fwd:

)))

(((

(% class="box infomessage" %)

481

(((

482

**sudo systemctl status draginofwd**

)))

)))

[[image:1651746045057-414.png||height="193" width="729"]]

487

488

489

Wait for a few minutes, the gateway will be online/active on the TTN-Stack.

490

491

[[image:1651746078253-168.png||height="372" width="621"]]

Get the draginofwd real-time running log:

496

497

(% class="box infomessage" %)

498

(((

499

**~ sudo journalctl -u draginofwd -f**

500

)))

501

502

[[image:1651746111963-838.png||height="184" width="730"]]

If there are LoRaWAN nodes transmitting nearby, we can see the traffic in (% style="color:#037691" %)**TTN v3 –> Gateway ~-~-> Live data**

507

508

[[image:1651746139304-966.png||height="326" width="621"]]

509

510

511

==== h). Commands to handle service ====

512

513

* (% style="color:#0000ff" %)**Stop** (%%)dragino_fwd service: sudo systemctl stop draginofwd

514

* (% style="color:#0000ff" %)**Disable**(%%) dragino_fwd auto run after boot: sudo systemctl disable draginofwd

515

* (% style="color:#0000ff" %)**Start** (%%)dragino_fwd : sudo systemctl start draginofwd

516

* (% style="color:#0000ff" %)**Auto run**(%%) dragino_fwd after boot: sudo systemctl enable draginofwd

517

* (% style="color:#0000ff" %)**Show status** (%%)of dragino_fwd: sudo systemctl status draginofwd

518

519

520

=== **5.2.2 Basic Station Mode.** ===

521

522

523

==== a). Get a gateway EUI from the device ETH MAC. ====

524

525

526

In RPI, run the below command to get a Gateway ID

527

528

(% class="box infomessage" %)

(((

**~ ifconfig eth0**

)))

[[image:1651745210205-512.png||height="130" width="621"]]

(((

(((

We got the ether (eth0 MAC) address is b8:27:eb:49:62:bc). Add ffff at the end and remove “:” to get the gateway ID: b827ebxxxxbcffff. Input this to TTN v3. Make sure to select legacy packet forwarder.

)))

)))

b

c

d

e

f

g

h

i

j

k

= 6. Order Info =

Part Number: (% style="color:#0000ff" %)**PG1302-XX** (%%) Or Part Number: (% style="color:#0000ff" %)**PG1302-PI-XX **(%%)(Include RPi converter board for RPI 3/4)

574

575

**~ (% style="color:#0000ff" %)XX:(%%)**

576

577

* (% style="color:red" %)**868** (%%)(For Bands: EU868,IN865)

578

* (% style="color:red" %)**915** (%%)(For Bands: US915,AU915,AS923,KR920)

579

* (% style="color:red" %)**470** (%%)(For Band: CN470)

580

581