LG308N - LoRaWAN Gateway User Manual

The LG308N is an open source (% style="color:blue" %)**LoRaWAN Pico Gateway**(%%). It lets you bridge LoRa wireless network to an IP network via WiFi, Ethernet, 3G or 4G cellular network. The LoRa wireless allows users to send data and reach extremely long ranges at low data-rates.

31

)))

32

33

(((

34

The LG308N uses (% style="color:blue" %)**Semtech packet forwarder** (%%)and fully compatible with LoRaWAN protocol. It includes a (% style="color:blue" %)**SX1302 LoRa concentrator**(%%), which provides 10 programmable parallel demodulation paths.

)))

(((

LG308N has (% style="color:blue" %)**pre-configured standard LoRaWAN frequency bands**(%%) to use for different countries. User can also (% style="color:blue" %)**customized the frequency bands**(%%) to use in their own LoRa network.

)))

(((

LG308N can communicate with ABP LoRaWAN end node without LoRaWAN server. System integrator can use it to integrate with their existing IoT Service without set up own LoRaWAN server or use 3rd party LoRaWAN service.

)))

)))

(((

)))

[[image:1657010949218-224.png]]

== 1.2 Specifications ==

55

56

57

(% style="color:#037691" %)**Hardware System:**

(((

Linux Part:

)))

* 400Mhz ar9331 processor

* 64MB RAM

* 16MB Flash

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

71

72

* 10M/100M RJ45 Ports x 2

73

* WiFi : 802.11 b/g/n

74

* LoRaWAN Wireless

75

* Power Input: 12 V DC, 2 A

76

* IEEE 802.3 af compliant PoE port (DC 37 ~~ 57 v)

77

* USB 2.0 host connector x 1

78

* Mini-PCI E connector x 1

79

* SX1302 + 2 x SX1250

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

85

86

* IEEE 802.11 b/g/n

87

* Frequency Band: 2.4 ~~ 2.462GHz

88

* Tx power:

89

** 11n tx power : mcs7/15: 11db mcs0 : 17db

90

** 11b tx power: 18db

91

** 11g 54M tx power: 12db

92

** 11g 6M tx power: 18db

* Wifi Sensitivity

** 11g 54M : -71dbm

** 11n 20M : -67dbm

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

101

102

* Up to -142.5 dBm sensitivity with SX1250 Tx/Rx front-end

103

* 70 dB CW interferer rejection at 1 MHz offset

104

* Able to operate with negative SNR, CCR up to 9dB

105

* Emulates 49 x LoRa demodulators and 1 x (G)FSK demodulator

106

* Dual digital TX & RX radio front-end interfaces

107

* 10 programmable parallel demodulation paths

108

* Dynamic data-rate (DDR) adaptation

109

* True antenna diversity or simultaneous dual-band operation

(% style="color:#037691" %)**Cellular 4G LTE (optional):**

115

116

* Quectel: [[**EC25 LTE module**>>url:https://www.quectel.com/product/ec25minipcie.htm]]

117

* Standard Size SIM Slot

118

* 2 x 4G Sticker Antenna.

119

* Up to 150Mbps downlink and 50Mbps uplink data rates

120

* Worldwide LTE,UMTS/HSPA+ and GSM/GPRS/EDGE coverage

121

* MIMO technology meets demands for data rate and link reliability in modem wireless communication systems

== 1.3 Features ==

* Open Source Linux system

131

* Managed by Web GUI, SSH via LAN or WiFi

132

* Emulates 49x LoRa demodulators

133

* LoRaWAN Gateway

134

* 10 programmable parallel demodulation paths

== 1.4 Hardware System Structure ==

141

142

143

[[image:1657011152828-178.png]]

== 1.5 LG308N Applications ==

148

149

150

[[image:1657011208596-209.png]]

== 1.6 LED Indicators ==

155

156

157

LG308N has totally 6 LEDs, They are:

158

159

* **Power LED **[[image:image-20220705165446-1.png||height="15" width="16"]] : This (% style="color:red" %)**LED**(%%) will be **solid on** if the device is properly powered.

160

* **HEART LED **[[image:image-20220705165446-2.png||height="16" width="15"]] : No function yet.

161

* **SYS LED** [[image:image-20220705165446-3.png||height="16" width="15"]] : This** LED** will shows different colors on different state:

162

** (% style="color:red" %)**SOLID**(%%): Device is alive with LoRaWAN server connection.

163

** (% style="color:red" %)**BLINKING**(%%)**:** a) Device has internet connection but no LoRaWAN Connection. or b) Device is in booting stage, in this stage, it will (% style="color:red" %)**BLINKING**(%%)** **for several seconds.

164

** (% style="color:red" %)**OFF**(%%): Device doesn't have Internet connection.

165

166

* **ETH LED** [[image:image-20220705165446-5.png||height="15" width="17"]] [[image:image-20220705165446-5.png||height="15" width="17"]]: These two LEDs show the ETH interfaces connection status.

167

* **WiFi LED** [[image:image-20220705165446-6.png||height="15" width="15"]]** **: This LED shows the WiFi interface connection status.

168

169

(((

170

(% style="color:red" %)**Note: Above LED indication are for firmware version > LG02_LG08~-~-build-v5.3.1584002217-20200312-1639**

)))

(((

(((

)))

)))

= 2. Access and Configure LG308N =

181

182

183

The LG308N is configured as a WiFi Access Point by default. User can access and configure the LG308N after connecting to its WiFi network, or via its Ethernet port.

== 2.1 Find IP address of LG308N ==

188

189

190

=== 2.1.1 Connect via WiFi ===

191

192

[[image:1657011715859-829.png]]

193

194

195

At the first boot of LG308N, it will auto generate a WiFi network called (% style="color:green" %)**//dragino-xxxxxx //**(%%)with password:

196

197

(% style="color:red" %)**Note: In latest version firmware, it has been password protected and the password is: **(% style="background-color:yellow" %)**dragino+dragino**

198

199

200

[[image:1652413127647-377.png]]

(((

User can use a PC to connect to this WiFi network. The PC will get an IP address 10.130.1.xxx and the LG308N has the default IP (% style="color:green" %)**10.130.1.1**

)))

=== 2.1.2 Connect via WAN port with DHCP IP from router ===

211

212

213

[[image:1657011966663-484.png]]

214

215

(((

216

Alternatively, connect the LG308N** __WAN port__** to your router and LG308N 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 LG308N. You can also use this IP to connect.

)))

(((

)))

=== 2.1.3 Connect via LAN port with direct connection from PC ===

225

226

227

[[image:1657012061799-674.png]]

228

229

(((

230

The LG308N __**LAN port**__ is configured as DHCP router by default, user can connect the PC to LAN port and set PC to DHCP mode, it will get IP from LAN port and be able to access to the device. The default IP in LAN port is 10.130.1.1

)))

=== 2.1.4 Connect WiFi with DHCP IP from router ===

236

237

238

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

239

240

241

If the LG308N already connect to the router via WiFi, use can use the WiFi IP to connect to LG308N.

=== 2.1.5 Connect via LAN port by fall back ip ===

246

247

248

The **LAN port** also has a [[fall back ip address>>path:#fallback_ip]] for access if user doesn't connect to uplink router.

== 2.2 Access Configure Web UI ==

**Web Interface**

Open a browser on the PC and type the LG308N ip address (depends on your connect method)

258

259

[[http:~~/~~/10.130.1.1/>>url:http://10.130.1.1/]] (Access via WiFi AP network)

or

http:~/~/IP_ADDRESS or [[http:~~/~~/ IP_ADDRESS:8000>>url:http://192.168.1.xx:8000]]

264

265

266

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

267

268

The account details for Web Login are:

269

270

(% style="color:#4f81bd" %)**User Name: root**

271

272

(% style="color:#4f81bd" %)**Password: dragino**

273

274

[[image:1652414287022-223.png]]

= 3. Typical Network Setup =

== 3.1 Overview ==

(((

LG308N supports flexible network set up for different environment. This section describes the typical network topology can be set in LG308N. The typical network set up includes:

286

)))

287

288

* **WAN Port Internet Mode**

289

* **WiFi Client Mode**

* **WiFi AP Mode**

* **Cellular Mode**

== 3.2 Use WAN port to access Internet ==

298

299

300

By default, the LG308N is set to use the WAN port to connect to an upstream network. When you connect the LG308N's WAN port to an upstream router, LG308N will get an IP address from the router and have Internet access via the upstream router. The network status can be checked in the (% style="color:#4f81bd" %)**home page**:

301

302

[[image:1657012559318-672.png]]

== 3.3 Access the Internet as a WiFi Client ==

307

308

309

In the WiFi Client Mode, LG308N acts as a WiFi client and gets DHCP from an upstream router via WiFi.

310

311

(((

312

The settings for WiFi Client is under page (% style="color:#4f81bd" %)**System~-~-> WiFi ~-~-> WiFi WAN Client Settings**

313

)))

314

315

[[image:1657012573321-862.png]]

316

317

(((

318

In the WiFi Survey Choose the WiFi AP, and input the Passphrase then click(% style="color:blue" %)** Save & Apply**(%%) to connect.

)))

== 3.4 Use built-in 4G modem for internet access ==

325

326

327

If the LG308N has 3G/4G Cellular modem, user can use it as main internet connection or back up.

328

329

330

First, install the Micro SIM card as below direction

331

332

Second, Power off/ ON LG308N to let it detect the SIM card.

333

334

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

(((

The set up page is (% style="color:#4f81bd" %)**System ~-~-> Cellular**

)))

(((

While use the cellular as Backup WAN, device will use Cellular for internet connection while WAN port or WiFi is not valid and switch back to WAN port or WiFi after they recover.

)))

(((

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

)))

== 3.5 Check Internet connection ==

355

356

357

In the (% style="color:#4f81bd" %)**home**(%%) page, we can check the Internet connection.

358

359

* GREEN Tick [[image:1652436675869-206.png||height="14" width="15"]] : This interface has Internet connection.

360

* Yellow Tick [[image:1652436705761-420.png||height="15" width="15"]] : This interface has IP address but don't use it for internet connection.

361

* RED Cross [[image:1652436787176-950.png||height="14" width="15"]] : This interface doesn't connected.

362

363

[[image:1657012821329-972.png]]

= 4. Example: Configure as a LoRaWAN gateway =

368

369

370

LG308N is fully compatible with LoRaWAN protocol. It uses the legacy Semtech Packet forwarder to forward the LoRaWAN packets to server. The structure is as below.

371

372

(((

373

[[image:1657012860422-990.png]]

374

)))

375

376

This chapter describes how to use the LG308N to work with(TTN v3)[[ LoRaWAN Server>>url:https://www.thethingsnetwork.org/]] ([[www.thethingsnetwork.org>>url:http://www.thethingsnetwork.org/]])

== 4.1 Create a gateway in TTN V3 Server ==

(((

(% style="color:blue" %)**Step 1: Get a Unique gateway ID.**

)))

(((

(((

Every LG308N has a unique gateway id. The ID can be found at LoRaWAN page:

)))

)))

(((

[[image:1657013108723-531.png]]

)))

The example gateway id is: (% style="color:green" %)**a840411e96744154**

(% style="color:blue" %)**Step 2: Sign up a user account in TTN server**

404

405

[[**https:~~/~~/account.thethingsnetwork.org/register**>>url:https://account.thethingsnetwork.org/register]]

406

407

[[image:1652422127479-258.png||height="346" width="738"]]

(% style="color:blue" %)**Step 3: Choose the TTNv3 Cluster Picker**

412

413

(((

414

[[image:1652422142236-792.png||height="356" width="737"]]

)))

(% style="color:red" %)**Note: Choose the cluster corresponds to a specific Gateway server address**

420

421

422

* Europe 1 (% style="color:red" %)**corresponding Gateway server address:** (% style="color:black" %)eu1.cloud.thethings.network

423

* North America 1 (% style="color:red" %)**corresponding Gateway server address: **(% style="color:black" %)nam1.cloud.thethings.network

424

* Australia 1 (% style="color:red" %)**corresponding Gateway server address: **(% style="color:black" %)au1.cloud.thethings.network

425

* Legacy V2 Console : (% style="color:red" %)**TTN v2 shuts down in December 2021**

(% style="color:blue" %)**Step 4: Create a Gateway**

430

431

[[image:1652422440891-514.png||height="360" width="747"]]

432

433

Click the Gateway icon and then click Add gateway.

434

435

Open the following page:

436

437

[[image:1652422470352-518.png||height="391" width="716"]]

438

439

440

[[image:1652422479876-297.png||height="398" width="729"]]

(((

(% style="color:red" %)**Notice: Gateway Server address must match the gateway configuration, otherwise you will have problem for End Node to join the network.**

)))

After creating the gateway, you can see the gateway info, as below.

450

451

[[image:1652422509034-682.png||height="299" width="739"]]

== 4.2 Configure LG308N to connect to TTN v3 ==

(((

You can now configure the LG308N to let it connect to TTN network V3.

)))

(((

Make sure your LG308N has a working Internet Connection first.

)))

(((

Choose the right server provider and click (% style="color:blue" %)**Save&Apply**

)))

[[image:1652422624783-580.png||height="327" width="729"]]

473

474

475

(% style="color:red" %)**Note: The server address must match the Gateway server address you choose in TTN V3.**

476

477

478

In the home page, we can see the LoRaWAN connection is ready now.

479

480

[[image:1657014479765-850.png]]

481

482

483

In TTN v3 portal, we can also see the gateway is connected.

484

485

[[image:1652422703020-955.png||height="343" width="730"]]

== 4.3 Configure frequency ==

490

491

492

We also need to set the frequency plan in LG308N to match the end node we use, so to receive the LoRaWAN packets from the LoRaWAN sensor.

493

494

495

[[image:1652422737399-529.png||height="362" width="737"]]

496

497

498

In logread page, user can check the frequency actually used.

499

500

[[image:1652422763536-750.png||height="514" width="730"]]

== 4.4 Add a LoRaWAN End Device ==

(((

This section shows how to add a LoRaWAN End device to a LoRaWAN network and see the data from TTN web site.

)))

(((

We use [[LT-22222-L>>url:http://www.dragino.com/products/lora-lorawan-end-node/item/156-lt-22222-l.html]] IO Controller as a reference device - the setup for other LoRaWAN devices will be similar.

513

)))

514

515

[[image:1652422794767-871.png]]

516

517

(((

518

(% style="color:blue" %)**Step 1**: (% style="color:black" %)Create a Device definition in TTN v3 with the OTAA keys from the example LT-22222-L IO Controller device.

)))

(((

Three codes are required to define the device in TTN v3:

523

)))

524

525

* DEV EUI - Unique ID code for a particular device.

526

* APP EUI - ID code for an Application defined in TTN v3.

527

* APP Key - Unique key to secure communications with a particular device.

(((

A set of these codes are stored in each device by the manufacturer as the default codes for that particular device. Each device is shipped with a sticker with the default Device EUI as shown below.

533

)))

534

535

[[image:1652422840936-838.png]]

(((

(% style="color:red" %)Note: You may be able to change these codes in a device by using a configuration facility on the device e.g. the LT-22222 uses a serial port access and a series of AT commands. Changing the codes may be necessary in the case where you have to use codes assigned by a LoRa WAN server.

)))

(((

For the TTN v3 server, you can use the codes set in the device as in the following example.

)))

(((

Select **Add Application** to open the screen below.

550

)))

551

552

[[image:1657014671459-433.png]]

553

554

555

Open the **Application **select** Add end device**

556

557

558

Start Register the end device

559

560

[[image:1652422975885-591.png||height="359" width="726"]]

561

562

(((

563

Select OTAA activation mode

)))

(((

The LoRaWAN version for your device should be provided by the manufacturer in a datasheet as LoRaWAN version or LoRaWAN specification. The most commonly used LoRaWAN versions are v1.0.2 and v1.0.3.

570

)))

571

572

[[image:1652422998005-968.png||height="352" width="744"]]

573

574

First, input the End device ID, AppEUI and DevEUI.

575

576

577

[[image:1652423022781-339.png||height="365" width="741"]]

578

579

Secondly, choose the corresponding frequency and LoRaWAN class capabilities.

580

581

582

[[image:1652423046741-467.png||height="355" width="736"]]

583

584

(((

585

Finally, Application layer settings input the corresponding AppKey. Before saving the configuration, check that the data matches the device.

)))

(((

(% style="color:blue" %)**Step 2**: (% style="color:black" %)Power on LT-22222-L device and it will automatically join the TTN network. After joining successfully, it will start to upload messages to the TTN v3. Select the Live data tab and you will see the data appearing in the panel.

)))

(((

(% style="color:red" %)**Note that it may take some time for the device data to appear in the TTN v3 display.**

)))

[[image:1652423277549-324.png||height="273" width="745"]]

= 5. Web Configure Pages =

== 5.1 Home ==

Shows the system running status.

613

614

[[image:1657014949846-507.png]]

== 5.2 LoRa Settings ==

619

620

621

=== 5.2.1 LoRa ~-~-> LoRa ===

(((

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

)))

(((

Different LG308N hardware version can support different frequency range:

630

)))

631

632

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

633

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

634

635

(((

636

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

637

)))

638

639

[[image:1652423554776-574.png||height="380" width="740"]]

640

641

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

=== 5.2.2 LoRa ~-~-> ABP Decryption ===

646

647

648

The LG308N can communicate with LoRaWAN ABP End Node without the need of LoRaWAN server. It can be used in some cases such as:

649

650

* No internet connection.

651

* User wants to get data forward in gateway and forward to their server based on MQTT/HTTP, etc. (Combine ABP communication method and [[MQTT forward together>>doc:Main.MQTT Forward Instruction.WebHome]]).

(((

Detail of this feature: **[[Communication with ABP End Node>>doc:Main.Communicate with ABP End Node without LoRaWAN Network Server --- LG308.WebHome]]**

657

)))

658

659

[[image:1652423628833-467.png||height="357" width="755"]]

== 5.3 LoRaWAN Settings ==

664

665

666

=== 5.3.1 LoRaWAN ~-~-> LoRaWAN ===

667

668

669

This page is for the connection set up to a general LoRaWAN Network server such as: [[TTN>>url:http://www.thethingsnetwork.org/]], [[ChirpStack>>url:https://www.chirpstack.io/]] etc

670

671

[[image:1652423628833-467.png||height="357" width="755"]]

672

673

674

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

675

676

~*: User can ignore the latitude and longitude settings here, LG308N will use the actually value from GPS module.

677

678

~**: Packet filter is to drop the unwanted LoRaWAN packet, instruction see here:

679

680

**See:** **[[Filter unwanted LoRaWAN packets>>doc:Main.Filter unwanted LoRaWAN packets.WebHome]]**

=== 5.3.2 LoRaWAN ~-~-> Amazon AWS-IoT ===

685

686

687

[[image:1652428499323-384.png||height="275" width="723"]]

(((

Please see this instruction to know more detail and demo for how to connect to **[[AWS-IoT LoRaWAN Core>>doc:Main.AWS IoT Core for LoRaWAN.WebHome]].**

)))

=== 5.3.3 LoRaWAN ~-~-> LORIOT ===

(((

Settings to communicate to LORIOT LoRaWAN Network Server: [[https:~~/~~/www.loriot.io/>>url:https://www.loriot.io/]]

)))

(((

Instruction: **[[Notes for LORIOT>>doc:Main.Notes for LORIOT.WebHome]]**

706

)))

707

708

[[image:1652428648903-878.png||height="266" width="731"]]

== 5.4 MQTT Settings ==

(((

If end nodes works in ABP mode, user can configure LG308N to transfer the data to MQTT broker,

)))

(((

Instruction: **[[MQTT Forward Instruction>>doc:Main.MQTT Forward Instruction.WebHome]]**

)))

[[image:1652428705046-212.png||height="417" width="733"]]

== 5.5 System ==

=== 5.5.1 System ~-~-> System Overview ===

732

733

734

Shows the system info:

735

736

[[image:1652428773760-580.png||height="408" width="728"]]

=== 5.5.2 System ~-~-> General ( login settings) ===

741

742

743

[[image:1652428861256-300.png||height="354" width="724"]]

744

745

(((

746

(% style="color:#037691" %)**__System Password:__**

)))

(((

There are two login for DLOS8: (% style="color:#4f81bd" %)root /dragino (% style="color:black" %)or (% style="color:#4f81bd" %)admin /dragino. (% style="color:black" %)Both root and admin has the same right for WEB access. But root user has also the right to access via SSH to Linux system. admin only able to access WEB interface.

)))

(((

This page can be used to set the password for them.

)))

(((

(% style="color:#037691" %)**__Timezone: __**(%%)Set device timezone.

)))

(((

(% style="color:#037691" %)**__Port forwarding: __**(%%)Enable/Disable the HTTP and SSH access via WAN interface.

)))

=== 5.5.3 System ~-~-> Network ===

769

770

771

[[image:1652429149053-824.png||height="467" width="725"]]

(((

(% style="color:#037691" %)**__LAN Settings: __**(%%)When the LG308N has the AP enable, LAN settings specify the network info for LG308N's own network.

)))

(((

(% style="color:#037691" %)__**WAN Settings: **__(%%)Setting for LG308N WAN port

)))

(((

(% style="color:#037691" %)__**WiFi Settings: **__(%%)Setting for LG308N WiFi IP when use it as WiFi Client

)))

=== 5.5.4 System ~-~-> WiFi ===

789

790

791

LG308N WiFi Settings.

792

793

[[image:1652429430767-921.png||height="367" width="723"]]

=== 5.5.5 System ~-~-> Cellular ===

798

799

800

While use the cellular as Backup WAN, device will use Cellular for internet connection while WAN port or WiFi is not valid and switch back to WAN port or WiFi after they recover.

801

802

[[image:1652429309615-825.png||height="320" width="732"]]

803

804

805

(% style="color:red" %)**Note *: For LG308N which doesn't have the cellular module, this page will shows Cellular not detected.**

=== 5.5.6 System ~-~-> Network Status ===

810

811

812

[[image:1652429486609-208.png||height="415" width="728"]]

=== 5.5.7 System ~-~-> Remote Mgnt & Auto Provision ===

817

818

819

Auto Provision is the feature for batch configure and remote management. It can be used in below two cases:

820

821

[[image:1652429518191-846.png||height="332" width="733"]]

822

823

[[image:1652429527544-247.png||height="327" width="724"]]

824

825

[[image:1652429537849-154.png||height="339" width="722"]]

826

827

Please see this document for detail:

828

829

[[http:~~/~~/www.dragino.com/downloads/index.php?dir=LoRa_Gateway/LG308N/Firmware/Application_Note/&file=Auto-update-feature.pdf>>url:http://www.dragino.com/downloads/index.php?dir=LoRa_Gateway/LPS8/Firmware/Application_Note/&file=Auto-update-feature.pdf]]

830

831

832

R-SSH is for remote access device and management, introduction for how to use: **[[Remote Access Gateway>>doc:Main.Remote Access Gateway.WebHome]]**

833

834

[[image:1652429624400-864.png||height="432" width="716"]]

=== 5.5.8 System ~-~-> Firmware Upgrade ===

839

840

841

We keep improving the DLOS8N Linux side firmware for new features and bug fixes. Below are the links for reference.

842

843

* **Latest firmware**: [[LoRa Gateway Firmware>>url:http://www.dragino.com/downloads/index.php?dir=LoRa_Gateway/LG02-OLG02/Firmware/]],

844

845

( [[http:~~/~~/www.dragino.com/downloads/index.php?dir=LoRa_Gateway/LG02-OLG02/Firmware>>url:http://www.dragino.com/downloads/index.php?dir=LoRa_Gateway/LG02-OLG02/Firmware/]] )

846

847

848

* **Change Log**: [[Firmware Change Log>>url:http://www.dragino.com/downloads/downloads/LoRa_Gateway/LG02-OLG02/Firmware/ChangeLog]].

849

850

( [[http:~~/~~/www.dragino.com/downloads/downloads/LoRa_Gateway/LG02-OLG02/Firmware/ChangeLog>>url:http://www.dragino.com/downloads/downloads/LoRa_Gateway/LG02-OLG02/Firmware/ChangeLog]] )

(((

The file named as (% style="color:green" %)**xxxxx–xxxxx-squashfs-sysupgrade.bin **(%%)is the upgrade Image. There are different methods to upgrade, as below.

)))

(((

(% style="color:green" %)**Web~-~-> System~-~-> Firmware Upgrade**

859

)))

860

861

[[image:1652429711145-862.png||height="270" width="737"]]

(((

Select the required image and click (% style="color:blue" %)**Flash Image.**(%%) The image will be uploaded to the device, and then click (% style="color:blue" %)**Process Update** (%%)to upgrade.

)))

(((

(% style="color:red" %)**NOTE**: (%%)You normally need to (% style="color:blue" %)**//uncheck//**(%%) the (% style="color:blue" %)**Preserve Settings**(%%) checkbox when doing an upgrade to ensure that there is no conflict between the old settings and the new firmware. The new firmware will start up with its default settings.

)))

(((

The system will automatically boot into the new firmware after upgrade.

874

)))

875

876

[[image:1652429962190-224.png||height="358" width="729"]]

877

878

879

(% style="color:red" %)**NOTE***(%%): User can also upgrade firmware via Linux console

880

881

SCP the firmware to the system(% style="color:green" %)**/var**(%%)** **directory and then run

882

883

(% style="color:#4f81bd" %)**//root@OpenWrt:~~# /sbin/sysupgrade –n /var/Your_Image//**

884

885

886

(% style="color:red" %)**NOTE**(%%) : it is important to transfer the image in the /var directory, otherwise it may exceed the available flash size.

=== 5.5.9 System ~-~-> Reboot/Reset ===

891

892

893

[[image:1652430197132-330.png||height="256" width="724"]]

(((

)))

=== 5.5.10 System ~-~-> Package Maintain ===

902

903

904

[[image:1652430243826-126.png||height="289" width="723"]]

905

906

Place to show what package has installed and possible to upgrade packages.

== 5.6 LogRead ==

=== 5.6.1 LogRead ~-~-> LoRa Log ===

914

915

916

Show the frequency for LoRa Radio and traffics.

917

918

[[image:1657069890320-513.png]]

=== 5.6.2 LogRead ~-~-> System Log ===

Show the system log

[[image:1657069922599-794.png]]

= 6. More features =

== 6.1 More instructions ==

936

937

938

[[LoRaWAN Gateway Instruction>>doc:Main.WebHome]](LoRaWAN Gateway)

= 7. Linux System =

The LG308N is based on the OpenWrt Linux system. It is open source, and users are free to configure and modify the Linux settings.

== 7.1 SSH Access for Linux console ==

950

951

952

User can access the Linux console via the SSH protocol. Make sure your PC and the LG308N are connected to the same network, then use a SSH tool (such as [[putty>>url:http://www.chiark.greenend.org.uk/~~sgtatham/putty/download.html]] in Windows) to access it.

953

954

IP address: IP address of LG308N

955

956

Port: 22 (via WiFi AP mode) or 2222 (via WAN Interface)

957

958

User Name: (% style="color:green" %)**root**

959

960

Password: (% style="color:green" %)**dragino** (% style="color:black" %)(default)

961

962

963

After logging in, you will be in the Linux console and can enter commands as shown below.

964

965

[[image:1652431588565-830.png]]

966

967

968

The “** (% style="background-color:yellow" %)logread -f"(%%)**command can be used to debug how system runs.

969

970

[[image:1657070133275-283.png]]

== 7.2 Edit and Transfer files ==

(((

The LG308N supports the (% style="color:green" %)**SCP protocol** (% style="color:black" %)and has a built-in (% style="color:green" %)**SFTP server**. (% style="color:black" %)There are many ways to edit and transfer files using these protocols.

)))

(((

In Windows, one of the easiest methods is using the [[WinSCP>>url:https://winscp.net/eng/index.php]] utility.

)))

(((

After establishing access via WinSCP to the device, you can use an FTP style window to drag / drop files to the LG308N, or edit the files directly in the windows.

)))

(((

Screenshot is as below:

991

)))

992

993

[[image:1652431650755-450.png]]

== 7.3 File System ==

(((

(((

The LG308N has a 16MB flash and a 64MB RAM. The /var and /tmp directory are in the RAM, contents stored in /tmp and /var will be erased after reboot the device. Other directories are in the flash and will keep after reboot.

)))

(((

The Linux system use around 8MB ~~10MB flash size which means there is not much room for user to store data in the LG308N flash. User can use an external USB flash to extend the size for storage.

)))

)))

== 7.4 Package maintenance system ==

1014

1015

1016

LG308N uses the OpenWrt [[**OPKG package maintenance system**>>https://oldwiki.archive.openwrt.org/doc/techref/opkg]]. There are more than 3000+ packages available in our package server for users to install for their applications. For example, if you want to add the **//iperf //** tool, you can install the related packages and configure LG308N to use **//iperf //**.

1017

1018

(((

1019

Below are some example **//opkg //** commands. For more information please refer to the [[OPKG package maintain system>>https://oldwiki.archive.openwrt.org/doc/techref/opkg]]** **([[https:~~/~~/oldwiki.archive.openwrt.org/doc/techref/opkg>>https://oldwiki.archive.openwrt.org/doc/techref/opkg]])

)))

(((

**In Linux Console run:**

)))

(((

(% style="color:green" %)**root@dragino-169d30:~~# opkg update** (% style="color:black" %)~/~/ to get the latest packages list

)))

(((

(% style="color:green" %)**root@dragino-169d30:~~# opkg list** (% style="color:black" %) ~/~/shows the available packages

)))

(((

(% style="color:green" %)**root@dragino-169d30:~~# opkg install iperf ** (% style="color:black" %)~/~/ install iperf

1036

)))

1037

1038

The system will automatically install the required packages as shown below.

(((

(% style="background-color:#dcdcdc" %)//root@dragino-169d30:/etc/opkg# opkg install iperf//

)))

(((

(% style="background-color:#dcdcdc" %)//Installing iperf (2.0.12-1) to root…//

)))

(((

(% style="background-color:#dcdcdc" %)//Downloading //[[(% style="background-color: rgb(220, 220, 220); background-color: rgb(220, 220, 220)" %)//http:~~/~~/downloads.openwrt.org/snapshots/packages/mips_24kc/base/iperf_2.0.12-1_mips_24kc.ipk//>>url:http://downloads.openwrt.org/snapshots/packages/mips_24kc/base/iperf_2.0.12-1_mips_24kc.ipk]]

)))

(((

(% style="background-color:#dcdcdc" %)//Installing uclibcxx (0.2.4-3) to root…//

)))

(((

(% style="background-color:#dcdcdc" %)//Downloading //[[(% style="background-color: rgb(220, 220, 220); background-color: rgb(220, 220, 220)" %)//http:~~/~~/downloads.openwrt.org/snapshots/packages/mips_24kc/base/uclibcxx_0.2.4-3_mips_24kc.ipk//>>url:http://downloads.openwrt.org/snapshots/packages/mips_24kc/base/uclibcxx_0.2.4-3_mips_24kc.ipk]]

)))

(((

(% style="background-color:#dcdcdc" %)//Configuring uclibcxx.//

)))

(((

(% style="background-color:#dcdcdc" %)//Configuring iperf.//

)))

= 8. Upgrade Linux Firmware =

= 9. FAQ =

== 9.1 How can I configure for a customized frequency band? ==

(((

See below link for how to customize frequency band: **[[How to customized LoRaWAN frequency band>>doc:Main.How to customized LoRaWAN frequency band.WebHome]]**

)))

(((

)))

== 9.2 Can I connect LG308N to LORIOT? ==

1093

1094

1095

Yes, the set up instruction is here: **[[Notes for LORIOT>>doc:Main.Notes for LORIOT.WebHome]]**

== 9.3 Can I make my own firmware for the gateway, where can I find the source code? ==

(((

Yes, You can make your own firmware for the LG308N for branding purposes or to add customized applications.

)))

(((

The source code and compile instructions can be found at: [[https:~~/~~/github.com/dragino/openwrt_lede-18.06>>url:https://github.com/dragino/openwrt_lede-18.06]]

)))

== 9.4 Can I use 868Mhz version for 915Mhz bands? ==

1113

1114

1115

It is possible but the distance will be very short, you can select US915 frequency band in 868Mhz version hardware. It will work but you will see the performance is greatly decreased because the 868Mhz version has an RF filter for band 863~~870Mhz, all other frequencies will have high attenuation.

== 9.5 Can I control the LEDs? ==

1120

1121

1122

Except the PWR LED is controlled by +3v3 power directly. All other LEDs can be controlled by developer.

1123

1124

1125

(% style="color:blue" %)**Control Globe LED:**

1126

1127

ON: echo 1 > /sys/class/leds/dragino2\:red\:wlan/brightness

1128

1129

OFF: echo 0 > /sys/class/leds/dragino2\:red\:wlan/brightness

1130

1131

1132

(% style="color:blue" %)**Control HEART LED:**

1133

1134

First export the gpio27 and set to out

1135

1136

echo 27 > /sys/class/gpio/export

1137

1138

echo out > /sys/class/gpio/gpio27/direction

1139

1140

ON: echo 0 > /sys/class/gpio/gpio27/value

1141

1142

OFF: echo 1 > /sys/class/gpio/gpio27/value

= 10. Trouble Shooting =

1147

1148

1149

== 10.1 I get kernel error when install new package, how to fix? ==

1150

1151

1152

In some cases, when installing a package with **//opkg//**, it will generate a kernel error such as below due to a mismatch I the kernel ID:

1153

1154

(% style="background-color:yellow" %)root@dragino-16c538:~~# opkg install kmod-dragino2-si3217x_3.10.49+0.2-1_ar71xx.ipk

1155

1156

(% style="background-color:yellow" %)Installing kmod-dragino2-si3217x (3.10.49+0.2-1) to root…

1157

1158

(% style="background-color:yellow" %)Collected errors:

1159

1160

(% style="background-color:yellow" %)* satisfy_dependencies_for: Cannot satisfy the following dependencies for kmod-dragino2-si3217x:

1161

1162

(% style="background-color:yellow" %)* kernel (= 3.10.49-1-4917516478a753314254643facdf360a) *

1163

1164

(% style="background-color:yellow" %)* opkg_install_cmd: Cannot install package kmod-dragino2-si3217x.

1165

1166

(((

1167

In this case, you can use the –force-depends option to install such package as long as the actual kernel version is the same.

1168

)))

1169

1170

(% style="background-color:yellow" %)Opkg install kmod-dragino2-si3217x_3.10.49+0.2-1_ar71xx.ipk –force-depends

== 10.2 How to recover the LG308N if the firmware crashes ==

(((

Please follow this instruction to recover your gateway: **[[Recover Gateway>>doc:Main.How to Recover Gateway if can't access it.WebHome]]**

)))

(((

)))

== 10.3 I configured LG308N for WiFi access and lost its IP. What to do now? ==

1188

1189

1190

[[image:1657074078183-336.png]]

(((

(((

The LG308N has a fall-back IP address on its WAN port. This IP is always enabled so you can use the fall-back IP to access LG308N no matter what the WiFi IP is. The fall back IP is useful for connecting and debug the unit.

)))

)))

(((

(% style="color:red" %)**Note: fallback IP can be disabled in the WAN and DHCP page.**

)))

(((

**Steps to connect via fall back IP:**

)))

(((

~1. Connect PC's Ethernet port to LG01's LAN port

)))

(((

2. Configure PC's Ethernet port has IP: 172.31.255.253 and Netmask: 255.255.255.252

)))

(((

As below photo:

)))

[[image:1652435256286-879.png]]

1221

1222

3. In PC, use 172.31.255.254 to access LG308N via Web or Console.

= 11. Order Info =

**//PART:(% style="color:blue" %) DLOS8N-XXX-YYY//: (%%)**(% style="color:blue" %)

1230

1231

(% style="color:blue" %)**//XXX~://**(%%)**// Frequency Band//**

1232

1233

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

1234

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

1235

1236

(% style="color:#4f81bd" %)

1237

1238

(% style="color:blue" %)**//YYY~://**(%%)**// 4G Cellular Option//**

1239

1240

* (% style="color:red" %)** EC25-E**(% style="color:black" %): EMEA, Korea, Thailand, India.

1241

* (% style="color:red" %)** EC25-A**(% style="color:black" %): North America/ Rogers/AT&T/T-Mobile.

1242

* (% style="color:red" %)** EC25-AU**(% style="color:black" %): Latin America, New Zeland, Taiwan

1243

* (% style="color:red" %)** EC25-J**(% style="color:black" %): Japan, DOCOMO/SoftBank/ KDDI

1244

1245

More info about valid bands, please see [[EC25-E product page>>url:https://www.quectel.com/product/ec25.htm]].

= 12. Packing Info =

(((

**Package Includes**:

1255

1256

* LG308N or LG08 LoRa Gateway x 1

1257

* Stick Antenna for LoRa RF part. Frequency is one of 433 or 868 or 915Mhz depends the model ordered

1258

* Power Adapter: EU/AU/US type power adapter depends on country to be used

1259

* Packaging with environmental protection paper box

)))

(((

**Dimension and weight**:

1266

)))

1267

1268

* Device Size: 26 x 9 x 8.5 cm

1269

* Weight: 450g

1270

* Package Size: 49 x 19.5 x x 19Package Size: 4912 cm

* Weight: 2.5kg

= 13. Support =

* Try to see if your questions already answered in the [[wiki>>doc:Main.WebHome]].

1279

* Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8.

1280

Due to different timezones we cannot offer live support. However, your questions will be answered as soon as possible in the before mentioned schedule.

1281

* 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:file:///C:/Users/11315/Documents/D:/Projects/LoRa%20Product%20Line/LG308%20Picocell%20Gateway/LG308/LG308%20%25E8%25AF%25B4%25E6%2598%258E%25E4%25B9%25A6/support@dragino.com]]

= 14. Reference =

* Source code for LG08 LoRa Gateway: [[https:~~/~~/github.com/dragino/openwrt_lede-18.06>>url:https://github.com/dragino/openwrt_lede-18.06]]

1289

1290

* OpenWrt official Wiki: [[http:~~/~~/www.openwrt.org/>>url:http://www.openwrt.org/]]

1291

1292

* Firmware: [[http:~~/~~/www.dragino.com/downloads/index.php?dir=LoRa_Gateway/LG308N-OLG308N/Firmware/>>url:http://www.dragino.com/downloads/index.php?dir=LoRa_Gateway/LG02-OLG02/Firmware/]]

1293

1294

* Hardware Source code: [[https:~~/~~/github.com/dragino/motherboard-hardware/tree/master/LG308N>>url:https://github.com/dragino/motherboard-hardware/tree/master/LG308]]

Wiki source code of LG308N - LoRaWAN Gateway User Manual

Applications

Navigation