RAKwireless RAK7249 Configuration Manual
  1. Manuals
  2. Brands
  3. RAKwireless Manuals
  4. Gateway
  5. RAK7249
  6. Configuration manual

RAKwireless RAK7249 Configuration Manual

Lorawan industrial gateway
Hide thumbs Also See for RAK7249:
Table of Contents

Advertisement

Quick Links

Configuration Guide for
RAK LoRaWAN
Industrial Gateway
WisDevice Series
RAK7249/RAK7258
Version 1.5 | July, 2019
www.RAKwireless.com
Visit our website for the latest copy of this manual.
31 PAGES

Advertisement

Table of Contents
loading

Related Manuals for RAKwireless RAK7249

Summary of Contents for RAKwireless RAK7249

  • Page 1 Configuration Guide for RAK LoRaWAN Industrial Gateway WisDevice Series RAK7249/RAK7258 Version 1.5 | July, 2019 www.RAKwireless.com Visit our website for the latest copy of this manual. 31 PAGES...

  • Page 2: Table Of Contents

    RAK7249/58 Table of Contents Overview..............................3 Gateway Start-up............................3 Web Management Platform........................4 3.1 Status..............................4 3.1.1 Overview..........................4 3.1.2 LoRaWAN Packet Logger....................5 3.1.3 System Log..........................6 3.1.4 Firewall............................ 6 3.2 Network............................... 7 3.2.1 WAN Interface........................7 3.2.2 Cellular Interface........................7 3.2.3 Wi-Fi............................8 3.2.4 Firewall............................

  • Page 3: Overview

    Make sure all the antennas are connected before powering the Gateway. For RAK7258 use the included adapter. RAK7249 comes with a PoE injector, which you need to connect to the grid on one side and to the Gateway on the other (Ethernet cable not included).

  • Page 4: Web Management Platform

    RAK7249/58 Figure 1 | Login window WAN port (DHCP IP) mode Connect the Ethernet cable to the port marked “ETH” and the other end to your Router. Use the same credentials for the Web UI as for AP mode. Web Management Platform After you have entered the correct credentials, you can start exploring the configuration and monitoring interface of the RAK LoRa Gateway.

  • Page 5: Lorawan Packet Logger

    RAK7249/58 Figure 1 | Status Overview page Active Nodes: Shows the number of active LoRa nodes within the LoRa gateway coverage (those that have sent no data for more than 10 min are discarded from the count). Busy Nodes: Shows the number of busy nodes within the LoRa gateway coverage (nodes with an average message spacing of less than 60s).

  • Page 6: System Log

    RAK7249/58 Figure 2 | LoRa Packet Logger page The user can choose to filter the packets by one of the following: Type: Filter by message type. By default ALL messages are displayed, where possible options are: Join Request/Accept, Unconfirmed Data Up/Down, and Confirmed Data Up/Down DevAddr: Filter messages based on the Device Address in order to single out a node.

  • Page 7: Network

    RAK7249/58 Network WAN Interface 3.2.1 Figure 3 | WAN Interface The user can check the Status (Uptime, IPv4 Address, etc.), or configure the protocol to be used for connecting to your provider’s network. The following options are available: DHCP/PPPoE/Static address.

  • Page 8: Wi-Fi

    RAK7249/58 The same statistics as with the WAN Interface are available. It is here that you set the APN, User, and Password. The gateway metric determines the priority of this interface, compared with the other connectivity options. The lower the value the higher the priority.

  • Page 9: Diagnostics

    RAK7249/58 Figure 6 | Firewall Settings Diagnostics 3.2.5 Figure 7 | Diagnostics This is where you can perform checks via the built-in tools: Ping, Traceroute, Nslookup. You can enter either an URL or an IP Address in the text box and execute the command with the button.
  • Page 10 RAK7249/58 WAN interface represents the Ethernet uplink interface and WWAN represents the LTE cellular network uplink interface. For example if Ping Watchdog is enabled for both uplink interfaces at the same time and the response to degradation of the link quality is set as Increase Gateway Metric the two uplink interfaces work as backups for each other.

  • Page 11: Lora Gateway

    RAK7249/58 LoRa Gateway All the LoRa Settings reside in this section. LoRa Packet Forwarder 3.3.1 Figure 9 | Packet Forwarder General Setup As this is the most important part of the LoRaWAN Gateway, the number of settings and options is greatest here. Thus, this section will be larger and provide information in more detail than previous ones.
  • Page 12 RAK7249/58 Automatic Data Recovery This is an important feature that came with the r176 Firmware update. It allows for LoRa Frames to be store on the SD card (provided there is one in the slot), if the LoRa Network Server is unavailable. Upon restoring the connection those buffed messages will be forwarded so no data will be lost.
  • Page 13 RAK7249/58 Standard Mode: You can start by importing a region via the drop down menu (EU868 is the default one). You will get the defaults channels for the chosen frequency band and the option to add additional ones. Simply enter the frequency in the text box (in MHz) and click the “Add” button. You can add as many channels as you need as long as they fall in the Regional band.
  • Page 14 RAK7249/58 As mentioned before you can choose to import those settings for the Indian, Russian and EU Regions (in accordance with the LoRa Alliance specifications). For details on the procedure refer to the Packet Forwarder Customs Spectrum Settings Guide. Figure 11 | Frequency plan (advanced mode)
  • Page 15 RAK7249/58 General Setup The tab starts with the button to enable/disable this functionality, followed by: MQTT Broker Address: The IP Address where the MQTT Broker is hosted. MQTT Broker Port: The corresponding port. Client ID: The user can input a custom Client ID (Will be reflected in the MQTT Broker data).

  • Page 16: Lora Network Server

    RAK7249/58 This tab has the MQTT Topic template information necessary to publish or subscribe to the Broker. The Uplink, Downlink, Downlink Acknowledgement, and Gateway statistics templates are here. LoRa Network Server The Gateway comes with an integrated LoRa Networks server. This makes the Gateway a standalone solution for the whole LoRaWAN chain in one device.

  • Page 17: Gateway

    RAK7249/58 Minimum and maximum allowed data-rate Note the DR_0, to DR_15 values represent a bits/s value and max payload size. Those are dependent on your region of operation and the bandwidth and SF used. However as they are predefined by the LoRa Alliance the menu does not list the full parameter values. Please refer to the official documentation for details.
  • Page 18 RAK7249/58 Gateway Here you can add a Gateway. You simply need to input the EUI into the text box and press the Add button. Additionally you can add a Name, Description and the coordinates of the Gateway. Gateway Backend Configuration...

  • Page 19: Applications

    RAK7249/58 Applications 3.4.3 Figure 15 | Adding an Application The first time you access the menu it will have no applications listed. Create one by Entering a name in the field and pressing the “Add” button. You will be redirected to the Application Configuration Screen (Figure 16).
  • Page 20 RAK7249/58 Devices If you want to manually add a device to your application, you can do this one by one by entering their EUIs in the field pressing the “Add” button. Another option is to use the Batch Add function.
  • Page 21 RAK7249/58 Figure 19 | Device Configuration parameters Configuration Here you can edit device parameters as follows: Name – does not need to match the EUI, batch loading results in a match by default. Class – both Class A and Class C devices are supported.
  • Page 22 RAK7249/58 Device Address - The field is generated automatically and displays the address assigned to the node. This is how you distinguish devices in the LoRa Packet Logger. Application session key – The key assigned to the device upon OTAA Activation, or the one input manually if ABP is used..

  • Page 23: Global Integration

    RAK7249/58 Live Device Data You can see the packets for the selected devices in real time in this section. Figure 21 | Live Device Data Global Integration 3.4.4 This feature allows for integration of the Built-in LoRa Application Server with an External MQTT broker.
  • Page 24 RAK7249/58 General Setup The configuration is very similar to the LoRa Gateway MQTT Bridge as can be seen below: MQTT Broker Address: The IP Address where the MQTT Broker is hosted. MQTT Broker Port: The corresponding port. Client ID: The user can input a custom Client ID (Will be reflected in the MQTT Broker data).

  • Page 25: Services

    RAK7249/58 Here you can get information on the topic templates: Join Topic, Uplink Topic, Downlink Topic, Ack Topic, Downlink Topic (status). Unlike the MQTT Bridge those are all application topics. Figure 23 | Live Device Data Services As of now the OpenVPN Service is the only one implemented. This allows a Virtual Private Network access to be set-up.

  • Page 26: System

    RAK7249/58 System This is the place where you configure general device parameters. System 3.5.1 Figure 24 | System configuration options General Settings The system time is displayed here. Additionally you can edit the Host Name and select the Time zone.

  • Page 27: Administration

    RAK7249/58 Administration 3.5.2 This is where you change the administration password of the device. Figure 25 | Username and Password Backup / Flash Firmware 3.5.3 Figure 26 | OBackup / Flash Firmware and Recovery Generate archive – downloads an archive of the current configuration Perform reset –...

  • Page 28: Reboot

    RAK7249/58 Reboot 3.5.4 Reboots the gateway. All unsaved changes will be discarded. This is not a reset in any way and only power cycles the device. All configuration settings will be left intact. Figure 27 | Gateway Reboot File Browser 3.5.1...

  • Page 29: Sd Card Backup And Packet Recovery

    RAK7249/58 SD card Backup and packet recovery Finally there is the functionality to buff packets on the SD card (provided one is inserted) in case of LoRa Network Server outage. The stored packets will be forwarded 8 at a time (FIFO), as soon as the connection is restored.

  • Page 30: Contact Information

    RAK7249/58 Contact Information Please contact us if you need technical support or want to know more information. Support center: https://forum.rakwireless.com/ Email us: info@rakwireless.com RAK LoRaWAN Industrial Gateway Configuration Guide...

  • Page 31: Revision History

    Penn About RAKwireless: RAKwireless is the pioneer in providing innovative and diverse cellular and LoRa connectivity solutions for IoT edge devices. It's easy and modular design can be used in different IoT applications and accelerate time-to-market. For more information, please visit RAKwireless website at www.rakwireless.com.
  • Page 32 MQTT Bridge Configuration for Integration with an External LoRaServer Version V1.1 | June 2019 www.RAKwireless.com Visit our website for more document. 9 PAGES...
  • Page 33 Table of Contents 1. LoRaServer instance and Gateway configuration..............3 2. Configure the Mosquitto TLS..................... 3 2.1 Generated the Certificate....................3 2.2 Configure Mosquitto......................4 2.3 Configure LoRa Server..................... 4 2.4 Configure the LoRaWAN Gateway.................5 2.5 Subscribe to the MQTT topic where the Gateway is publishing via the Mosquitto commands..........................

  • Page 34: Loraserver Instance And Gateway Configuration

    Unzip the generate_CA.zip file Grant executable rights for Generate_CA.sh su root cd ~ wget http://docs.rakwireless.com/en/LoRa/Indoor-Gateway-RAK7258/Firmware/generate_CA.zip unzip generate_CA.zip chmod +x generate_CA.sh Step 1. Generate the CA Certificate and the Certificate for the Mosquitto Server ./generate_CA.sh server Step 2. Generate the TLS Certificate and Key for the LoRa Network Server (NS)

  • Page 35: Configure Mosquitto

    Step 3. Generate the TLS Certificate and Key for the LoRa Application Server (AS) ./generate_CA.sh client loraappserver Step 4. Generate the TLS Certificate and Key for the Client (Gateway) Note: Replace xxxxxxxxxxxxxxxx with your LoRa Gateway EUI ./generate_CA.sh client eui_xxxxxxxxxxxxxxxx 2.2 Configure Mosquitto Step 1.

  • Page 36: Configure The Lorawan Gateway

    Note: Only the relevant section of the file are shown and the lines to be edited are in red. The rest of the file has been omitted in order to keep posterity. Please only edit the lines in and leave the rest of the file as it is! ………………………………………………………………………………………………………………………………...
  • Page 37 Step 2. Configure the LoRa Gateway MQTT Bridge Edit the MQTT Broker Address/Port Enable User Authentication Enter the Username/Password if you input those in the loraserver.toml Select self-signed server & client certificate for the SSL/TLS Mode Choose the TLS Version (TLSv1) Copy the content of ~/ca.crt in server to CA Certificate Copy content of ~/eui_xxxxxxxxxxxxxxxx.crt to TLS Certificate Copy content of ~/eui_ xxxxxxxxxxxxxxxx.key to TLS Key...

  • Page 38: Subscribe To The Mqtt Topic Where The Gateway Is Publishing Via The Mosquitto

    2.5 Subscribe to the MQTT topic where the Gateway is publishing via the Mosquitto commands mosquitto_sub -t "gateway/#" -p 8883 -v --cafile ~/ca.crt --cert ~/eui_xxxxxxxxxxxxxxxx.crt --key eui_ xxxxxxxxxxxxxxxx.key --tls-version tlsv1 Note: xxxxxxxxxxxxxxxx stands for your Gateway EUI If the following message appear, this means you have subscribed successfully gateway/60c5a8fffe6f74a0/rx {"rxInfo":{"mac":"60c5a8fffe6f74a0","timestamp":2036224996,"frequency":905300000,"channel":7,"rfChain":1,"crcStatus":1,"c odeRate":"4/5","rssi":-23,"loRaSNR":10.5,"size":24,"dataRate":{"modulation":"LORA","spreadFactor":7,"bandwidth":125},"boa...

  • Page 39: Check If You Can See The Packets In Loraserver

    2.6 Check if you can see the packets in LoRaServer Go to the Gateways tab of your LoRa Server Web UI, select your gateway and go to the LIVE LORAWAN Frames tab. You should see the packets in real time.

  • Page 40: Revision History

    Vladislav Penn About RAKwireless: RAKwireless is the pioneer in providing innovative and diverse cellular and LoRa connectivity solutions for IoT edge devices. It's easy and modular design can be used in different IoT applications and accelerate time-to-market. For more information, please visit RAKwireless website at www.rakwireless.com.
  • Page 41 Industrial LoRa Micro Gateway RAK7258 Quick Start Guide www.rakwireless.com info@rakwireless.com...
  • Page 42 First Time Power Up Step 1: Attach the antenna First and foremost screw on the antenna to the SMA connector on the front panel of the gateway. Note: Do not power the device if the antenna port has been left open (not connected to the antenna).
  • Page 43 Your Gateway should now be registered with TTN and you should be able to forward LoRa packets. Note: By Default the Gateway is set to connect to TTN (using it as its LoRa Network server). For detailed information about advanced configuration options refer to the Configuration Guide via the link: https://www.rakwireless.com/en/download/LoRa/Indoor-Gateway-RAK7258...
  • Page 44 Package Content Gateway Device LoRa Antenna Tapping Screws Screw Anchors Power Adapter Casing and Ports...
  • Page 45 Status LEDs LEDs Status Indication Power Indicator, LED is on when the device is powered ON - link is up OFF - link is down Flashing - Data is being transferred ON - LoRa module status is up OFF - LoRa module status is down LoRa Flashing - LoRa module data is being transferred Reserved for future use...
  • Page 46 Wall Mounting Step 1: Use a 5mm drill bit to drill 2 holes on a wall. Follow the dimensions on the image as a guideline for spacing the holes. When done insert the screw anchors into the wall. 100mm Step 2: Install the screws into the wall, leaving about 3mm of clearance.
  • Page 47 Step 3: Insert the screw heads into the hanging holes located on the gateway back plate, then gently pull down to complete the installation. Contact Us Support center: https://forum.rakwireless.com/ Email us: info@rakwireless.com...

This manual is also suitable for:

Rak7258

Table of Contents