www.dragino.com DLOS8 Outdoor LoRaWAN Gateway User Manual Document Version: 1.0.0 Firmware Version: LG02_LG08--build-v5.4.1590459021-20200526-1012 Version 1.
www.dragino.com Table of Contents 1 2 Introduction .............................................................................................................................. 5 1.1 What is the DLOS8 ...................................................................................................................... 5 1.2 Specifications.............................................................................................................................. 6 1.3 Features .....................
www.dragino.com 5.3 5.3.1 LoRaWAN --> LoRaWAN .................................................................................................. 28 5.3.2 LoRaWAN --> LORIOT ...................................................................................................... 28 5.4 MQTT Settings .......................................................................................................................... 29 5.5 System .....................................................................
www.dragino.com 10.3 I configured DLOS8 for WiFi access and lost its IP. What to do now? .................................. 45 11 Order Info ............................................................................................................................... 46 12 Packing Info ............................................................................................................................ 47 13 Support .............................................................................
www.dragino.com 1 1.1 Introduction What is the DLOS8 The DLOS8 is an open source outdoor LoRaWAN 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. The DLOS8 uses Semtech packet forwarder and fully compatible with LoRaWAN protocol. It includes a SX1301 LoRaWAN concentrator, which provide 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 2 WiFi : 802.11 b/g/n LoRaWAN Wireless Power Input: 12 ~ 24 V DC, 1 A IEEE 802.3 af compliant PoE port (DC 37 ~ 57 v) USB 2.0 host connector x 1 Mini-PCI E connector x 1 SX1301 + 2 x SX1257 WiFi Spec: IEEE 802.11 b/g/n Frequency Band: 2.4 ~ 2.
www.dragino.com 2 x 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 Power over Ethernet: 1.3 IEEE 802.3af compliant. Support wide input voltage range 37Vdc to 57Vdc. Thermal cut off. Short circuit protection. Over current protection Isolation level 4 KVrms.
www.dragino.com 1.
www.dragino.com 1.5 DLOS8 Applications 1.6 LED Indicators There is a waterproof triple color LED on DLOS8 enclosure, the meaning of the LED is: SOLID GREEN: DLOS8 is alive with LoRaWAN server connection. BLINKING GREEN: a) Device has internet connection but no LoRaWAN Connection. or b) Device is in booting stage, in this stage, it will BLINKING GREEN for several seconds and then RED and YELLOW will blink together. SOLID RED: Device doesn’t have Internet connection.
www.dragino.com 2 Access and Configure DLOS8 The DLOS8 is configured as a WiFi Access Point by default. User can access and configure the DLOS8 after connecting to its WiFi network, or via its Ethernet port. 2.1 Find IP address of DLOS8 2.1.1 Connect via WiFi At the first boot of DLOS8, it will auto generate a WiFi network called dragino-xxxxxx with password: dragino+dragino User can use a PC to connect to this WiFi network. The PC will get an IP address 10.130.1.
www.dragino.com 2.1.2 Connect via Ethernet with DHCP IP from router Alternatively, connect the DLOS8 Ethernet port to your router and DLOS8 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 DLOS8. You can also use this IP to connect. 2.1.3 Connect via WiFi with DHCP IP from router If the DLOS8 already connect to the router via WiFi, use can use the WiFi IP to connect to DLOS8. 2.1.
www.dragino.com 2.2 Access Configure Web UI Web Interface Open a browser on the PC and type the DLOS8 ip address (depends on your connect method) http://10.130.1.1/ (Access via WiFi AP network) or http://IP_ADDRESS or http:// IP_ADDRESS:8000 You will see the login interface of DLOS8 as shown below.
www.dragino.com 3 Typical Network Setup 3.1 Overview The DLOS8 supports flexible network set up for different environments. This section describes the typical network topology. The network set up includes: 3.2 WAN Port Internet Mode WiFi Client Mode WiFi AP Mode Cellular Mode Use WAN port to access Internet By default, the DLOS8 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, DLOS8 acts as a WiFi client and gets DHCP from an upstream router via WiFi. The settings for WiFi Client is under page System WiFi WiFi WAN Client Settings In the WiFi Survey Choose the WiFi AP, and input the Passphrase then click Save & Apply to connect. 3.4 Access the Internet via Cellular If the DLOS8 support 3G/4G Cellular modem option, user can use it as main internet connection or back up.
www.dragino.com The set up page is 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. 3.5 Check Internet connection In the Home page, we can check the Internet connection. GREEN Tick Yellow Tick : This interface has IP address but don’t use it for internet connection. RED Cross : This interface doesn’t connected.
www.dragino.com 4 Example: Configure as a LoRaWAN gateway DLOS8 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 DLOS8 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 DLOS8 has a unique gateway id.
www.dragino.com Step 3: Create a Gateway Click on the Gateways icon to open the page below: Notice: The TTN router should match the Frequency Plan you choose, otherwise you will have problem for End Node to join the network. If you don’t know which router you need to select, please check: https://www.thethingsnetwork.org/docs/gateways/packet-forwarder/semtechudp.html#connect-a-gateway_server-addresses After creating the gateway, you can see the gateway info, as below.
www.dragino.com 4.2 Configure DLOS8 to connect to TTN You can now configure the DLOS8 to let it connect to TTN network. Make sure your DLOS8 has a working Internet Connection first. Choose the right server provider and click Save&Apply Note: The server address must match the router you choose in TTN. In the home page, we can see the LoRaWAN connection is ready now.
www.dragino.com In TTN portal, we can also see the gateway is connected.
www.dragino.com 4.3 Configure frequency We also need to set the frequency plan in DLOS8 to match the LoRaWAN end node we use, so to receive the LoRaWAN packets from the LoRaWAN sensor. In logread page, user can check the frequency actually used.
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-22222-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 LT-22222-L 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 5.1 Web Configure Pages Home Shows the system running status.
www.dragino.com 5.2 LoRa Settings 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 DLOS8 hardware version can support different frequency range: 868: valid frequency: 863Mhz ~ 870Mhz. for bands EU868, RU864, IN865 or KZ865. 915: valid frequency: 902Mhz ~ 928Mhz.
www.dragino.com 5.2.2 LoRa --> ABP Decryption The DLOS8 can communicate with LoRaWAN ABP End Node without the need of LoRaWAN server. It can be used in some cases such as: No internet connection. 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). Detail of this feature: http://wiki.dragino.com/index.
www.dragino.com 5.3 LoRaWAN Settings 5.3.1 LoRaWAN --> LoRaWAN This page is for the connection set up to a general LoRaWAN Network server such as: TTN, ChirpStack etc Note *: User can ignore the latitude and longitude settings here, DLOS8 will use the actually value from GPS module. **: Packet filter is to drop the unwanted LoRaWAN packet, instruction see here: See http://wiki.dragino.com/index.php?title=Main_Page#Filter_unwanted_LoRaWAN_packets 5.3.
www.dragino.com 5.4 MQTT Settings If end nodes works in ABP mode, user can configure DLOS8 to transfer the data to MQTT broker, Instruction: http://wiki.dragino.com/index.php?title=Main_Page#MQTT_Forward_Instruction 5.5 System 5.5.
www.dragino.com 5.5.2 System --> General ( login settings) System Password: There are two login for DLOS8: root /dragino or admin /dragino. 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. Timezone: Set device timezone. Port forwarding: Enable/Disable the HTTP and SSH access via WAN interface.
www.dragino.com 5.5.3 System --> Network LAN Settings: When the DLOS8 has the AP enable, LAN settings specify the network info for DLOS8’s own network.
www.dragino.com 5.5.4 System --> WiFi DLOS8 WiFi Settings. 5.5.5 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. Note *: For DLOS8 which doesn’t have the cellular module, this page will shows Cellular not detected.
www.dragino.com 5.5.6 System --> Network Status 5.5.7 System --> Remote Mgnt R-SSH is for remote access device and management, introduction for how to use: http://wiki.dragino.com/index.
www.dragino.com 5.5.8 System --> Firmware Upgrade We keep improving the DLOS8 Linux side firmware for new features and bug fixes. Below are the links for reference. Latest firmware: LoRa Gateway Firmware, ( http://www.dragino.com/downloads/index.php?dir=LoRa_Gateway/LG02-OLG02/Firmware ) Change Log: 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 The system will automatically boot into the new firmware after upgrade. Note *: User can also upgrade firmware via Linux console 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. 5.5.
www.dragino.com 5.5.10 System --> Package Maintain Place to show what package has installed and possible to upgrade packages.
www.dragino.com 5.6 LogRead 5.6.1 LogRead --> LoRa Log Show the frequency for LoRa Radio and traffics. 5.6.
www.dragino.com 6 6.1 More features More instructions http://wiki.dragino.com/index.php?title=Main_Page#LoRa.
www.dragino.com 7 Linux System The DLOS8 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 User can access the Linux console via the SSH protocol. Make sure your PC and the DLOS8 are connected to the same network, then use a SSH tool (such as putty in Windows) to access it.
www.dragino.com 7.2 Edit and Transfer files The DLOS8 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 DLOS8, or edit the files directly in the windows. Screenshot is as below: 7.3 File System The DLOS8 has a 16MB flash and a 64MB RAM.
www.dragino.com 7.4 Package maintenance system DLOS8 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 DLOS8 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.
www.dragino.com 9 9.1 FAQ How can I configure for a customized frequency band? See below link for how to customize frequency band: http://wiki.dragino.com/index.php?title=Customized_Frequency_Band_for_Gateway 9.2 Can I connect DLOS8 to LORIOT? Yes, the set up instruction is here: http://wiki.dragino.com/index.php?title=Notes_for_LORIOT 9.
www.dragino.com 10 Trouble Shooting 10.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 10.3 I configured DLOS8 for WiFi access and lost its IP. What to do now? The DLOS8 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 DLOS8 no matter what the WiFi IP is. The fall back IP is useful for connecting and debug the unit. (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 DLOS8’s WAN port 2. Configure PC’s Ethernet port has IP: 172.31.255.
www.dragino.com 11 Order Info PART: DLOS8-XXX-YYY: XXX: Frequency Band 868: valid frequency: 863Mhz ~ 870Mhz. for bands EU868, RU864, IN865 or KZ865. 915: valid frequency: 902Mhz ~ 928Mhz.
www.dragino.com 12 Packing Info Package Includes: DLOS8 LoRaWAN 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 3 cm Weight: 187g Package Size: 14.5 x 13.5 x 6 cm Weight: 300g 13 Support Try to see if your questions already answered in the wiki. Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8.
