www.dragino.com LPS8 LoRaWAN Gateway User Manual Document Version: 1.0 Firmware Version: LG02_LG08--build-v5.3.1572062709-20191026-1206 Version 1.0 1.0.1 1.0.2 Description Release Add trouble shooting for wifi AP not access issue Change the HTTP Port and SSH port for firmware version > v5.
www.dragino.com Table of Contents 1 2 Introduction .............................................................................................................................. 4 1.1 What is the LPS8 ......................................................................................................................... 4 1.2 Specifications.............................................................................................................................. 5 1.3 Features ...................
www.dragino.com 7 8 FAQ ......................................................................................................................................... 26 7.1 How can I configure for a customized frequency band? ........................................................... 26 7.2 Can I make my own firmware for LPS8? Where can I find the source code of LPS8? .............. 31 7.3 Can I use the 868Mhz version for 915Mhz bands? ...................................................................
www.dragino.com 1 Introduction 1.1 What is the LPS8 The LPS8 is an open source LoRaWAN Gateway. It lets you bridge LoRa wireless network to an IP network via WiFi, Ethernet. The LoRa wireless allows users to send data and reach extremely long ranges at low data-rates. The LPS8 uses Semtech packet forwarder and fully compatible with LoRaWAN protocol. It includes a SX1308 LoRa concentrator, which provides 10 programmable parallel demodulation paths.
www.dragino.com 1.2 Specifications Hardware System: Linux Part: 400Mhz ar9331 processor 64MB RAM 16MB Flash Interface: 10M/100M RJ45 Ports x 1 WiFi : 802.11 b/g/n LoRaWAN Wireless Power Input: 5V DC, 2A USB 2.0 host connector x 1 WiFi Spec: IEEE 802.11 b/g/n Frequency Band: 2.4 ~ 2.
www.dragino.com 1.
www.dragino.com 1.
www.dragino.com 2 Access LPS8 2.1 Access and Configure the LPS8 via WiFi or Ethernet The LPS8 is configured as a WiFi Access Point by factory default. You can access and configure the LPS8 after connecting to its WiFi network, or via its WAN Ethernet port. WiFi At the first boot of LPS8, it will auto generate an open WiFi network called dragino-xxxxxx You can use a PC to connect to this WiFi network. The PC will get an IP address 10.130.1.xxx and the LPS8 has the default IP 10.130.1.
www.dragino.
www.dragino.com 3 Typical Network Setup 3.1 Overview The LPS8 supports flexible network set up for different environments. This section describes the typical network topology can be set in LPS8. The network set up includes: WAN Port Internet Mode WiFi Client Mode WiFi AP Mode 3.2 Use WAN port to access Internet By default, the LPS8 is set to use the WAN port to connect to an upstream network.
www.dragino.com 3.3 Access the Internet as a WiFi Client. In the WiFi Client Mode, the LPS8 acts as a WiFi client and gets DHCP from an upstream router via WiFi. The steps to set up as a WiFi Client are as below: Step1: In Network -> Wireless, select Radio0 interface and scan.
www.dragino.com Step3: In the Network->Wireless page, disable WiFi AP network. This step is important, the LPS WiFi interface can only WiFi AP or WiFi Client mode at a time. Note: After doing that, you will lose connection if your PC connects to the LPS8 via LPS8’s WiFi network. After successful association, the WiFi network interface can be seen in the same page: 3.4 Check Internet connection You can use the diagnostics page to check and analyze the Internet connection as shown below.
www.dragino.com 4 Example: Configure as a LoRaWAN gateway LPS8 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. This chapter describes how to use the LPS8 to work with TheThingsNetwork (TTN) LoRaWAN Server (www.thethingsnetwork.
www.dragino.com 4.1 Create a gateway in TTN Server Step 1: Get a Unique gateway ID. Every LPS8 has a unique gateway id.
www.dragino.com Step 3: Create a Gateway Click on the Gateways icon to open the page below: After creating the gateway, you can see the gateway info, as below.
www.dragino.com 4.2 Configure LPS8 to connect to TTN You can now configure the LPS8 to let it connect to TTN network. Make sure your LPS8 has a working Internet Connection first. Step1: Configure LPS8 to act as raw forwarder Step2: Input server info and gateway id Choose the correct the server address and gateway ID.
www.dragino.com Check Result After making the above settings, the LPS8 should be able to connect to TTN. Below is the result seen from TTN: 4.3 Configure frequency After making the settings above, the LPS8 will be able to act as a LoRaWAN gateway.
www.dragino.com 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-33222-L IO Controller as a reference device - the setup for other LoRaWAN devices will be similar. Step 1: Create a Device definition in TTN with the OTAA keys from the example LT-33222-L IO Controller device. Three codes are required to define the device in TTN: DEV EUI - Unique ID code for a particular device.
www.dragino.com Select Add Application to open the screen below. Note that there is an APP EUI already created by TTN, but this is not the one set in the device. To add the APP EUI for the LT33222 device, select Manage EUIs and Add EUI, then enter the required code. Select Devices and Register Device to open the screen below. Enter the Device EUI and APP KEY codes, then select the App EUI from the list. Check that all three codes match those shown on the device label before saving the configuration.
www.dragino.
www.dragino.com 5 Linux System The LPS8 is based on the OpenWrt Linux system. It is open source, and users are free to configure and modify the Linux settings. 5.1 SSH Access for Linux console You can access the Linux console via the SSH protocol. Make sure your PC and the LPS8 are connected to the same network, then use a SSH tool (such as putty in Windows) to access it. IP address: IP address of LPS8 Port: 22 or 2222 (SSH port in WAN interface has been change to 2222 since firmware 5.3.
www.dragino.com 5.2 Edit and Transfer files The LPS8 supports the SCP protocol and has a built-in SFTP server. There are many ways to edit and transfer files using these protocols. In Windows, one of the easiest methods is using the WinSCP utility. After establishing access via WinSCP to the device, you can use an FTP style window to drag / drop files to the LPS8, or edit the files directly in the windows. Screenshot is as below: 5.3 File System The LPS8 has a 16MB flash and a 64MB RAM.
www.dragino.com 5.4 Package maintenance system LPS8 uses the OpenWrt OPKG package maintenance system. 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 LPS8 to use iperf . Below are some example opkg commands. For more information please refer to the OPKG package maintain system (https://wiki.openwrt.
www.dragino.com 6 Upgrade Linux Firmware We keep improving the LPS8 Linux side firmware for new features and bug fixes. The latest firmware can be found on LoRa Gateway Firmware, ( http://www.dragino.com/downloads/index.php?dir=LoRa_Gateway/LG02-OLG02/Firmware ) The Change Log can be found here: Firmware Change Log. ( http://www.dragino.com/downloads/downloads/LoRa_Gateway/LG02OLG02/Firmware/ChangeLog ) The file named as xxxxx–xxxxx-squashfs-sysupgrade.bin is the upgrade Image.
www.dragino.com SCP the firmware to the system /var directory and then run root@OpenWrt:~# /sbin/sysupgrade –n /var/Your_Image NOTE: it is important to transfer the image in the /var directory, otherwise it may exceed the available flash size.
www.dragino.com 7 FAQ 7.1 How can I configure for a customized frequency band? You can customize your LoRaWAN channel on LPS8.
www.dragino.com Step 1: Choose Frequency Band to use “Customized Bands” Step 2: Configure Radio 0 & 1 Frequency The LPS8 has two Radios from SX1308. You can configure these eight channels based on these two radios. Go to the Radio Settings page and enable Radio 0 to 865700000 and enable Radio 1 to 866500000.
www.dragino.com Step 3: Configure Channel Frequency. What we need to configure for LoRoit is 0~7 multiSF channel frequency and LoRa frequency as per LoRiot frequency plan. Each Channel Configure include below parameters: Radio used for this channel. Channel IF, frequency shift base on Radio Frequency. Below are the settings for the LoRiot frequency plan: Channel 0 frequency = radio0 –300000Hz = 865700000300000 = 865.4Mhz Channel 1 frequency = 865.6Mhz Channel 2 frequency = 865.
www.dragino.com Channel 3 frequency = 866.0Mhz Channel 4 frequency = 866.2Mhz Channel 5 frequency = 866.4Mhz Channel 6 frequency = 866.6Mhz Channel 7 frequency = 866.8Mhz Channel LoRaSTDfrequency = 865.
www.dragino.com Step 4: Save & Apply & check result in logread page.
www.dragino.com 7.2 Can I make my own firmware for LPS8? Where can I find the source code of LPS8? Yes, You can make your own firmware for the LPS8 for branding purposes or to add customized applications. The LPS8 source code and compile instructions can be found at: https://github.com/dragino/openwrt_lede-18.06 7.3 Can I use the 868Mhz version for 915Mhz bands? It is possible but the distance will be very short, you can select US915 frequency band in 868Mhz version hardware.
www.dragino.com 8 Trouble Shooting 8.1 I get kernel error when install new package, how to fix? 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: root@dragino-16c538:~# opkg install kmod-dragino2-si3217x_3.10.49+0.2-1_ar71xx.ipk Installing kmod-dragino2-si3217x (3.10.49+0.2-1) to root… Collected errors: * satisfy_dependencies_for: Cannot satisfy the following dependencies for kmod-dragino2si3217x: * kernel (= 3.10.
www.dragino.com 8.2 How to recover the LPS8 if the firmware crashes LPS8 provides the user with full control on its Linux system, so it is possible that the device will brick and can’t boot after an improper modification in some boot files. In this case, the user can recover the whole Linux system by uploading a new firmware via Web Failsafe mode. Procedure is as below: Use an RJ45 cable to connect the PC to LPS8’s WAN port directly. Set the PC to a static IP of 192.168.255.x, Netmask 255.255.255.
www.dragino.com (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 WAN port 2. Configure PC’s Ethernet port has IP: 172.31.255.253 and Netmask: 255.255.255.252 As below photo: 3. In the PC, use IP address 172.31.255.254 to access the LPS8 via Web or Console. Please note the latest firmware has use port 8000 for http and 2222 for ssh access. 8.
www.dragino.com 9 Order Info PART: LPS8-XXX-YYY: XXX: Frequency Band 868: valid frequency: 863Mhz ~ 870Mhz. for band EU868 or IN865. 915: valid frequency: 902Mhz ~ 928Mhz.
www.dragino.com 10 Packing Info Package Includes: LPS8 LoRa Gateway x 1 Stick Antenna for LoRa RF part. Frequency is one of 470 or 868 or 915Mhz depends the model ordered Packaging with environmental protection paper box Dimension and weight: Device Size: 12 x 12 x 2.5 cm Device Weight: Package Size / pcs : Weight / pcs : Carton dimension: Weight / carton : 11 Support Try to see if your questions already answered in the wiki.