Dragino LG01N User manual

www.dragino.com
LG01-N/OLG01-N Gateway User Manual 1 / 61
LG01N/OLG01N LoRa Gateway User Manual
Document Version: 1.3.0
Firmware Version: LG02_LG08--build-v5.3.1581838658-20200216-1539
Version
Description
Date
1.0
Release
2018-Dec-28
1.1
Add Customized Script Feature
(firmware ver >LG02_LG08--build-v5.1.1547896817-20190119-1921)
2019-Jan-19
1.2
--Add Downlink support and example.
(firmware ver >LG02_LG08--build-v5.1.1548820215-20190130-1151)
--Correct typo for the UNO code of example for lg02_single_rx_tx
2019-Jan-30
1.2.1
-- Add OLG01 connector photo
-- Add how to control LEDs
-- Modify MQTT instruction
2019-Jun-19
1.2.2
--Add photo for OLG01 4G installation
2019-Nov-1
1.2.3
-- Change the HTTP Port and SSH port for firmware version > v5.3
2019-Nov-26
1.3.0
-- Add more features, remote access
2020-Mar-02

www.dragino.com
LG01-N/OLG01-N Gateway User Manual 2 / 61
1. Introduction..............................................................................................................................5
1.1 What is LG01N & OLG01N ..........................................................................................................5
1.2 Specifications..............................................................................................................................6
1.3 Features......................................................................................................................................8
1.4 System Structure ........................................................................................................................8
1.5 Applications................................................................................................................................9
1.6 Hardware Variants ...................................................................................................................10
1.7 Interfaces..................................................................................................................................10
1.8 Install SIM card in 4G module...................................................................................................11
1.9 Firmware Change log ...............................................................................................................12
2. Access LG01N..........................................................................................................................12
3. Typical Network Setup ............................................................................................................ 14
3.1 Overview ..................................................................................................................................14
3.2 Use WAN port to access Internet..............................................................................................14
3.3 Access Internet as a WiFi Client................................................................................................15
3.4 Use built-in 4G modem for internet access ..............................................................................17
3.5 Check Internet connection........................................................................................................19
4. Example 1: Configure as a LoRaWAN gateway –Limited LoRaWAN mode............................... 20
4.1 Create a gateway in TTN Server ...............................................................................................20
4.2 Configure LG01N Gateway .......................................................................................................22
4.2.1 Configure to connect to LoRaWAN server ......................................................................22
4.2.2 Configure LG01’s Radio frequency..................................................................................23
4.3 Create LoRa End Node..............................................................................................................24
4.3.1 About Limited support for LoRaWAN .............................................................................24
4.3.2 Preparation .....................................................................................................................25
4.3.3 Test with OTAA LoRa end node (LoRa Shield + UNO)......................................................26
4.3.4 Test with ABP LoRa end node (LoRa Shield + UNO) ........................................................30
5. Example 2: Manually send / receive LoRa packets .................................................................. 34
5.1 User LoRa Radio via pkt_fwd....................................................................................................34
5.1.1 Use pkt_fwd to receive ...................................................................................................34
5.1.2 Use pkt_fwd to transmit .................................................................................................34

www.dragino.com
LG01-N/OLG01-N Gateway User Manual 3 / 61
5.2 Use LoRa radio device directly..................................................................................................36
6. Example 3: MQTT Transfer Mode ............................................................................................ 39
7. Example 4: TCP IP Client Mode................................................................................................ 40
8. Example 5: Write a customized script...................................................................................... 42
9. Example 6: Communicate to a HTTP server .............................................................................44
9.1 Test uplink and downlink via Linux command ..........................................................................44
9.2 Test uplink and downlink in LoRa .............................................................................................46
9.2.1 Set up on gateway...........................................................................................................46
10. More features ......................................................................................................................... 47
10.1 Remote Access .....................................................................................................................47
10.2 More instructions ................................................................................................................47
11. Linux System ...........................................................................................................................47
11.1 SSH Access for Linux console................................................................................................47
11.2 Edit and Transfer files ..........................................................................................................49
11.3 File System ...........................................................................................................................49
11.4 Package maintain system ....................................................................................................51
12. Upgrade Linux Firmware .........................................................................................................52
12.1 Upgrade via Web UI.............................................................................................................52
12.2 Upgrade via Linux console ...................................................................................................52
13. FAQ ......................................................................................................................................... 53
13.1 Why there is 433/868/915 version LoRa part? ....................................................................53
13.2 What is the frequency range of LG01N LoRa part? .............................................................53
13.3 What does “Limited support on LoRaWAN”? ......................................................................53
13.4 Can I develop my own LoRa protocol and other software for LG01N? ................................54
13.5 Can I make my own firmware for LG01N? Where can I find the source code of LG01N? ....54
13.6 On OTAA mode, if I use the other frequency, how should I modify in the library?...............54
13.7 How can I reset the device to factory default? ....................................................................55
13.8 Can I control the LEDs? ........................................................................................................56
13.9 Can I upgrade the LG01-P / LG01-S to LG01-N?...................................................................56

www.dragino.com
LG01-N/OLG01-N Gateway User Manual 4 / 61
14. Trouble Shooting..................................................................................................................... 57
14.1 I get kernel error when install new package, how to fix? ....................................................57
14.2 How to recover the LG01N if firmware crash.......................................................................58
14.3 I configured LG01N for WiFi access and lost its IP. What to do now? ..................................59
15. Order Info ...............................................................................................................................60
16. Packing Info ............................................................................................................................60
17. Support...................................................................................................................................60
18. Reference................................................................................................................................61

www.dragino.com
LG01-N/OLG01-N Gateway User Manual 5 / 61
1. Introduction
1.1 What is LG01N & OLG01N
LG01N & OLG01N are an open source single channel LoRa Gateway. It lets you bridge LoRa
wireless network to an IP network via WiFi, Ethernet, 3G or 4G cellular. The LoRa wireless allows
users to send data and reach extremely long ranges at low data-rates. It provides ultra-long range
spread spectrum communication and high interference immunity.
LG01N & OLG01N have rich internet connection method such as WiFi interface, Ethernet port
and 3G/4G Cellular. These Interfaces provide flexible methods for users to connect their sensor
networks to Internet.
LG01N & OLG01N can support the LoRaWAN protocol in single frequency and customized LoRa
transition protocol.
LG01N can be used to provide a low cost IoT wireless solution to support 50~100 sensor nodes.
Except limited LoRaWAN mode, LG01N can support multiply working mode such as: MQTT mode,
TCP/IP Client mode to fit different requirement for IoT connection.
LG01N & OLG01N provide a low cost for your IoT network connection. Compare to the cost with
normal SX1301 LoRaWAN solution. LG01N & OLG01N is only of its 1/4 or less cost. This makes the
LG01N very suitable to set up small scale LoRa network or use it to extend the coverage of
current LoRaWAN network.
LG01N in an IoT Network

www.dragino.com
LG01-N/OLG01-N Gateway User Manual 6 / 61
1.2 Specifications
Hardware System:
Linux Part:
400Mhz ar9331 processor
64MB RAM
16MB Flash
Interface:
10M/100M RJ45 Ports x 2
WiFi : 802.11 b/g/n
LoRa Wireless
Power Input: 12V DC
USB 2.0 host connector x 1
USB 2.0 host internal interface x 1
1 x LoRa Interfaces
WiFi Spec:
IEEE 802.11 b/g/n
Frenquency Band: 2.4 ~ 2.462GHz
Tx power:
11n tx power : mcs7/15: 11db mcs0 : 17db
11b tx power: 18db
11g 54M tx power: 12db
11g 6M tx power: 18db
Wifi Sensitivity
11g 54M : -71dbm
11n 20M : -67dbm
LoRa Spec:
Frequency Range:
Band 1 (HF): 862 ~ 1020 Mhz
Band 2 (LF): 410 ~ 528 Mhz
168 dB maximum link budget.
+20 dBm - 100 mW constant RF output vs.
+14 dBm high efficiency PA.
Programmable bit rate up to 300 kbps.
High sensitivity: down to -148 dBm.
Bullet-proof front end: IIP3 = -12.5 dBm.
Excellent blocking immunity.
Low RX current of 10.3 mA, 200 nA register retention.
Fully integrated synthesizer with a resolution of 61 Hz.
FSK, GFSK, MSK, GMSK, LoRaTM and OOK modulation.

www.dragino.com
LG01-N/OLG01-N Gateway User Manual 7 / 61
Built-in bit synchronizer for clock recovery.
Preamble detection.
127 dB Dynamic Range RSSI.
Automatic RF Sense and CAD with ultra-fast AFC.
Packet engine up to 256 bytes with CRC.
Built-in temperature sensor and low battery indicator.
Cellular 4G LTE (optional):
Quectel EC25 LTE module
Micro SIM Slot
Internal 4G Antenna + External 4G Sticker Antenna.
Up to 150Mbps downlink and 50Mbps uplink data rates
Worldwide LTE,UMTS/HSPA+ and GSM/GPRS/EDGE coverage
MIMO technology meets demands for data rate and link reliability in modem
wireless communication systems

www.dragino.com
LG01-N/OLG01-N Gateway User Manual 8 / 61
1.3 Features
Open Source OpenWrt LEDE system
Low power consumption
Firmware upgrade via Web
Software upgradable via network
Flexible protocol to connect to IoT servers
Auto-Provisioning
Built-in web server
Managed by Web GUI, SSH via LAN or WiFi
Internet connection via LAN, WiFi, 3G or 4G
Failsafe design provides robustly system
1 x SX1276/SX1278 LoRa modules
Full–duplex LoRa transceiver
Two receive channels, and one transmit channel
Limited support in LoRaWAN/ Support Private LoRa protocol
Support upto 100 nodes
LoRa band available at 433/868/915/920 Mhz
Max range in LoRa: 5~10 km. Density Area:>500m
1.4 System Structure

www.dragino.com
LG01-N/OLG01-N Gateway User Manual 9 / 61
1.5 Applications

www.dragino.com
LG01-N/OLG01-N Gateway User Manual 10 / 61
1.6 Hardware Variants
The LG01N and OLG01N use the same firmware and have the same feature in the software side.
In this document, we will use LG01N as the model number to explain the feature.
Model
Photo
Description
LG01N
Indoor version for single channel LoRa Gateway,
OLG01N
Outdoor version for dual channel LoRa Gateway
1.7 Interfaces
OLG01N Version Interface:
LoRa ANT. In new version, this
antenna was built-in device
PWR
WAN
LAN/POE
toggle

www.dragino.com
LG01-N/OLG01-N Gateway User Manual 11 / 61
1.8 Install SIM card in 4G module
LG01N & OLG01N has optional built-in 4G module version. For the 4G version, devices will be
shipped with screws un assembly, please open the box and use below direction to install the SIM
card (Micro SIM)

www.dragino.com
LG01-N/OLG01-N Gateway User Manual 12 / 61
1.9 Firmware Change log
Please see this link for firmware change log:
http://www.dragino.com/downloads/index.php?dir=LoRa_Gateway/LG02-OLG02/Firmware/&file
=ChangeLog
2. Access LG01N
Access and configure LG01
The LG01N is configured as a WiFi AP by factory default. User can access and configure the LG01N
after connect to its WiFi network.
At the first boot of LG01N, it will auto generate an unsecure
WiFi network call dragino-xxxxxx
User can use the laptop to connect to this WiFi network. The
laptop will get an IP address 10.130.1.xxx and the LG01 has the
default IP 10.130.1.1
Open a browser in the laptop and type
http://10.130.1.1/cgi-bin/luci/admin
User will see the login interface of LG01N.
The account for Web Login is:
User Name: root
Password: dragino
Note: the LG01 can also be accessed via WAN interface (WAN port or WiFi when
device acts as WiFi Client). But for security reason, for firmware version >5.3, the
http access on WAN interface has been set to 8000, SSH access has been set to 2222.

www.dragino.com
LG01-N/OLG01-N Gateway User Manual 13 / 61
Notice: In case the WiFi network is disabled, user can connect the PC to LG01N’s LAN
port, the PC will get DHCP from LG01N, and be able to access it.

www.dragino.com
LG01-N/OLG01-N Gateway User Manual 14 / 61
3. Typical Network Setup
3.1 Overview
LG01N supports flexible network set up for different environment. This section describes the
typical network topology can be set in LG01N. The typical network set up includes:
WAN Port Internet Mode
WiFi Client Mode
WiFi AP Mode
USB Dial Up Mode
3.2 Use WAN port to access Internet
By default, the LG01N set to use WAN port as network connection. When connect LG01N’s WAN
port to router, LG01N will get IP from router and have internet access. The network status is as
below:

www.dragino.com
LG01-N/OLG01-N Gateway User Manual 15 / 61
3.3 Access Internet as a WiFi Client.
In the WiFi Client Mode, Dragino acts as a WiFi client and gets IP from uplink router via WiFi.
The step to set is as below:
Step1:
In network -> Wireless, select Radio0 interface and scan.
Step2:
Select the wireless AP and join:
Step3:
In network->wireless page, disable WiFi AP network. Notice: After doing that, you will lose
connection if your computer connects to the LG01N via LG01N’s wifi network.

www.dragino.com
LG01-N/OLG01-N Gateway User Manual 16 / 61
(Note:make sure click the Save & Apply after configure)
After successful associate, the WiFi network interface can be seen in the same page:

www.dragino.com
LG01-N/OLG01-N Gateway User Manual 17 / 61
3.4 Use built-in 4G modem for internet access
For the LG01N with built-in 4G version, user can configure the modem for internet access.
Step 1: Add New Interface

www.dragino.com
LG01-N/OLG01-N Gateway User Manual 18 / 61
Step 2: Configure cellular interface
Step 3: Check Result
Note: In case you don’t know if your device has 4G modem, you can run lsusb command in SSH
access to check, as below:

www.dragino.com
LG01-N/OLG01-N Gateway User Manual 19 / 61
3.5 Check Internet connection
User can use the diagnostics page to check and analyze Internet connection.

www.dragino.com
LG01-N/OLG01-N Gateway User Manual 20 / 61
4. Example 1: Configure as a LoRaWAN gateway –Limited LoRaWAN mode
This chapter describes how to use LG01N to work with TTN LoRaWAN Server. The method to
work with other LoRaWAN Server is similar.
4.1 Create a gateway in TTN Server
Step 1: Get a Unique gateway ID.
Every LG01N has a unique gateway id. The id can be found at LoRaWAN page:
The gateway id is: a840411b6fc44150