RFI U-router NGW Reference Manual

RFI U-router NGW Reference Manual

Universal wireless iot data router supporting lte-m and gprs
Table of Contents

Advertisement

U-router NGW
Universal wireless IoT data router
supporting LTE-M and GPRS
Reference Guide
Author
Ivo van Ling
Hardware Release
2.2
Quick Install Guide Version
RefGuide_U-routerNGW_v1.01.docx
Date
9-11-2020
Covering Product codes
RE.45.HCRG and RE.45.HCPG

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the U-router NGW and is the answer not in the manual?

Questions and answers

Summary of Contents for RFI U-router NGW

  • Page 1 U-router NGW Universal wireless IoT data router supporting LTE-M and GPRS Reference Guide Author Ivo van Ling Hardware Release Quick Install Guide Version RefGuide_U-routerNGW_v1.01.docx Date 9-11-2020 Covering Product codes RE.45.HCRG and RE.45.HCPG...
  • Page 2: Table Of Contents

    INTRODUCTION ..................4 NGW F ................4 ROUTER EATURES ................4 ROUTER VARIANTS CHECK YOUR PACKAGE CONTENTS .............. 5 CONNECTORS AND STATUS LEDS ON THE U-ROUTER NGW ......6 ............... 6 ROUTER FRONT PANEL ................. 6 ROUTER REAR PANEL ................. 7 THERNET...
  • Page 3 The information contained in this document is subject to change. This document contains proprietary information, which is protected by copyright laws. All rights are reserved. No part of this document may be photocopied, reproduced or translated to another language or program language without prior written consent of RFI Engineering B.V. RefGuide_U-routerNGW_v1.01.docx...
  • Page 4 RFI Engineering B.V. or its suppliers have been advised of the possibility of such damages.
  • Page 5: Introduction

    The U-router NGW is a universal wireless IoT data router supporting the latest in wireless technology. The U-router NGW is designed for operation in LTE bands 2, 3, 4, 5, 8, 12, 13, 20 and 2G Quad- band. The carrier-grade U-router NGW features a low power relay for remote control of devices.
  • Page 6: Check Your Package Contents

    110-240VAC power supply with changeable heads for use in EU, UK, Australia, USA and Japan. This power supply connects to the micro USB port on the U-router NGW. The second variant (RE.45.HCPG and RE.45.HCPV) is an 48V Power-over-Ethernet variant and is powered by a single port PoE injector.
  • Page 7: Connectors And Status Leds On The U-Router Ngw

    4 Connectors and status LEDs on the U-router NGW This section provides an overview of the connectors and status LEDs on the U-router NGW unit. U-router NGW front panel Figure 1: U-router NGW front view 1 – Power Blue, Power LED.
  • Page 8: Ethernet Pin Assignments

    5.1V micro USB power supply AND the 48V PoE power supply simultaneously. The PoE variants of the U-router NGW contain a 48DC to 5V convertor/power supply that is internally connected to the 5V micro USB port of the router. Connecting both power supplies might result in damage to the power supply circuits of the U-router NGW with PoE.
  • Page 9: Serial Port (Rs232) Pin Assignments

    Serial Port (RS232) Pin Assignments The U-router NGW supports a serial port on an RJ45 connector on the front panel. The signal levels are compatible with TIA/EIA-232-F levels. The RS232 receiver has a typical threshold of 1.3 V, a typical hysteresis of 0.5 V, and can accept ±30-V inputs. The pinout of the RJ45 connector is such that a standard Ethernet cable can be used to connect a Cisco console port.
  • Page 10: Expansion Port Pin Assignments

    485 standard. This interface can be used to run a two-wire Modbus protocol or the RFI RIOT protocol. Pins 1 and 6 are not connected. They may be used in future hardware versions of the U-router NGW. Figure 7: Expansion port on RJ11 connector Please note: The relay is specified for low power devices only.
  • Page 11: Installation Overview

    In order to start using the U-router NGW you need to insert a miniature SIM card. Please make sure the SIM card is a data card. The SIM card holder is located inside to the U-router NGW and can only be accessed by unscrewing the four screws in the bottom of the unit using a Phillips screw driver.
  • Page 12: Connecting Power Using The Power Adapter

    6. Re-assemble the unit, taking the above steps in reverse order. Connecting Power using the Power Adapter Connect the supplied power adapter to the power port of the U-router NGW. The power port is labeled: “PWR”. The plug the power adapter into a power outlet.
  • Page 13: Accessing The U-Router Ngw Configuration Interface

    PC. When the U-router ships, the unit has been configured with a static IP address. In order to log in to the U-router NGW you can connect a laptop or desktop computer to the Ethernet port of the unit. In case you connect a computer directly to the U-router NGW please make sure you use a cross Ethernet cable.
  • Page 14: Accessing The U-Router Ngw Web Gui

    192.168.168.x subnet. Then launch your web browser. Type https://192.168.168.1 in the address field and press ENTER or RETURN. The login screen will appear. Enter rfi in the Username field and rfi123 in the password field of the login box.
  • Page 15: Dashboard

    The information contained in this document is subject to change. This document contains proprietary information, which is protected by copyright laws. All rights are reserved. No part of this document may be photocopied, reproduced or translated to another language or program language without prior written consent of RFI Engineering B.V. RefGuide_U-routerNGW_v1.01.docx...
  • Page 16: Showing Mobile Connection Information

    The information contained in this document is subject to change. This document contains proprietary information, which is protected by copyright laws. All rights are reserved. No part of this document may be photocopied, reproduced or translated to another language or program language without prior written consent of RFI Engineering B.V. RefGuide_U-routerNGW_v1.01.docx...
  • Page 17: Connecting The U-Router Ngw To The Mobile Network

    8 Connecting the U-router NGW to the Mobile Network In order to connect the U-router NGW to the mobile data network you will have to insert a SIM card as described in paragraph 5.1. In most cases, to configure your U-router NGW to connect to your mobile operator the only information required is the APN and sometimes a username and password –...
  • Page 18: User Management

    In fact, best practices dictate the use of as many user accounts as people needing access to the U-router NGW. At the same time, it is to be expected that two or more users may need to share access to certain system resources, such as directories, files and access to the console ports.
  • Page 19: User Shells

    User shells Users can have different shells on the U-router NGW system. For example, some users are not allowed to use SSH and then perform CLI commands. Other users are meant to have direct access to the Console port of the connected Enterprise Router. User can have 4 different shell types, dependent on their role.
  • Page 20: Time Synchronization

    The U-router NGW also contains an internal NTP server that is synchronized against the network time of the mobile network. Not all mobile networks support this time feature. The internal NTP server will only serve the time to the U-router NGW when the correct time is acquired from the mobile network.
  • Page 21: Connecting External Relay(S) To The Expansion Port

    Engineering’s Remote Power Switch: RE.99.R1NC. Figure 14: RE.99.R1NC Remote Power Switch The state of the relay in the Remote Power Switch follows that of the relay inside the U-router NGW. The internal relay of the U-router NGW will always show up as Relay#0.
  • Page 22 Please note: The Remote Power Switch: RE.99.R1NC works in reverse. This means, the relay in the RPSW is normally closed when not driven remotely. So, when the U-router NGW closes its internal relay the RPSW opens. This is indicated underneath the blue Edit button, where it reads: RPSW Connected –...
  • Page 23: Using Rs485 (Riot) Remote Power Switches With The U-Router Ngw

    When connected to a U-router NGW, the remote power switches will be found automatically. Each switch is identified by its RIOT address. In the user interface of the U-router the relays show up on the ‘Relays’ page. Below is an example of the WEB interface of a U-router NGW showing multiple connected RPSW’s.
  • Page 24: Led Indicators On The Rpsw

    RS485 network are unplugged or rebooted. For example; if you reboot the U-router NGW you don’t want your RPSW to momentarily be switched off during reboot, thereby causing a service disruption. Also, in case of power loss, the RPSW relay will return in the original position when power is restored.
  • Page 25: Connecting To Console Ports Of Remote Devices

    When the Serial port of the U-router NGW is connected you will have to set the communication parameters of the U-router NGW on the Settings page of the WEB UI. The console port of the remote device is then accessible through the WEB UI of the U-router NGW.
  • Page 26 The information contained in this document is subject to change. This document contains proprietary information, which is protected by copyright laws. All rights are reserved. No part of this document may be photocopied, reproduced or translated to another language or program language without prior written consent of RFI Engineering B.V. RefGuide_U-routerNGW_v1.01.docx...
  • Page 27: Connecting Ausb Console Port For Cisco Devices

    When the USB-B port of the U-router NGW is connected you will have to set the communication parameters of the U-router NGW on the Settings page of the WEB UI. The console port of the remote device is then accessible through the WEB UI of the U-router NGW.
  • Page 28 During reboot of the Cisco device the USB serial port will temporary disappear from the system since the USB port is also restarted. The U-router NGW will probe if the USB port re-appears and then re- connects your terminal session with the USB port.
  • Page 29: Connecting Ausb Console Port For Juniper Devices

    Figure 20: USB console connection to a Juniper device When the USB-B port of the U-router NGW is connected to a Juniper device you will have to set the communication parameters of the U-router NGW on the Settings page of the WEB UI. The console port of the remote device is then accessible through the WEB UI of the U-router NGW.
  • Page 30 The information contained in this document is subject to change. This document contains proprietary information, which is protected by copyright laws. All rights are reserved. No part of this document may be photocopied, reproduced or translated to another language or program language without prior written consent of RFI Engineering B.V. RefGuide_U-routerNGW_v1.01.docx...
  • Page 31: Accessing The Console Interface Of The Connected Device

    12.4.1 Console Access from the >_Terminal tab in the Web GUI When you are logged into the Web UI of the U-router NGW, clicking on the >_ Terminal tab in the menu will take you straight to the connected console port. Upon clicking the tab, the screen presents you with a little menu which shows the available commands.
  • Page 32 The information contained in this document is subject to change. This document contains proprietary information, which is protected by copyright laws. All rights are reserved. No part of this document may be photocopied, reproduced or translated to another language or program language without prior written consent of RFI Engineering B.V. RefGuide_U-routerNGW_v1.01.docx...
  • Page 33: Ssh Login With A User That Connects Straight To The Console Port

    Terminal. In the example below the user ‘rfi’ is set to ‘Terminal’. User ‘rfi’ can now login to the U-router NGW and will be connected straight to the console port of the connected enterprise router. For example: ivovanling@Ivos-MacBook-Pro-2 ~ % ssh rfi@192.168.168.1...
  • Page 34: Console Access From Command Line: Ngw-Term.sh

    12.4.3 Console Access from Command Line: ngw-term.sh Users on the U-router NGW that have shell access can still access the console port of the attached enterprise router by executing a shell command. This shell command is: ngw-term.sh To configure users to have shell access, go to the Users tab and configure a user to have ‘Bash’ as login option.
  • Page 35: Console Access From Command Line: Minicom

    Therefore, this feature is regarded as: advanced and minicom can only be executed as root user. To become root on the U-router NGW you need to issue the ‘su’ command. The su command switches to the super user – or root user – when you execute it with no additional options. Sudo runs a single command with root privileges.
  • Page 36: Cli Commands

    (CLI). The information in this chapter is intended for system administrators who are responsible for configuring and operating a network using the U-router NGW. To obtain the greatest benefit from this chapter, you should have a basic understanding of Linux and also have basic knowledge of Ethernet and networking concepts.
  • Page 37: Retrieving The Mobile Information Of The U-Router Ngw: Ngw-Client Mobile

    : RPSW Connected - mains on 13.6 Retrieving the Mobile Information of the U-router NGW: ngw-client mobile When ngw-client is called with the ‘mobile’ option, the command retrieves the status of the U- router mobile connection. As example: rfi@rfi-000102:~$ ngw-client mobile...
  • Page 38: Retrieving The Interfaces Of The U-Router Ngw: Ngw-Client Interface

    Retrieving the Relay Information of the U-router NGW: ngw-client relay When ngw-client is called with the ‘relay’ option, the command retrieves the state of the relay(s) connected to the U-router NGW. Furthermore, you can also operate any relay that is connected to the U-router NGW. As example:...
  • Page 39 When multiple relays are connected to the RS485 port of the U-router NGW, and they are set to communicate using the RFI Internet Of Things (RIOT) protocol you can retrieve the status of all connected relays. For example: rfi@rfi-000102:~$ ngw-client relay...
  • Page 40: Checking Time Server Information

    • 91.236.251.11, external time server on the Internet From the output of the command we can see that the system clock on the U-router NGW is synchronized with the mobile network time. Furthermore, the two remaining external time servers are not reachable.
  • Page 41: Api Reference

    14.1 Base URL The API can be found on the https interface of the U-router NGW. The default IP address of the U- router NGW is 192.168.168.1. In this manual we use the default IP address and the default user ‘rfi’...
  • Page 42: Available Endpoints

    Retrieve the list of users from the system POST Add, Change or Delete users on the system settings Retrieve the system settings for the U-router NGW, such as the RS232 serial port and speed. POST Change the system settings on the U-router NGW. Change the serial port, speed and port number.
  • Page 43: Status

    14.5 Status The ‘status’ endpoint provides information on the current status of the U-router NGW. Such as the connections status to the mobile network, signal levels and the status of the interfaces and relay. ENDPOINT GET /api/status For example: curl https://192.168.168.1/api/status -u rfi:rfi123 Returns: "system": {...
  • Page 44: Statistics

    14.6 Statistics The ‘status’ endpoint provides information on the current status of the U-router NGW. Such as the connections status to the mobile network, signal levels and the status of the interfaces and relay. ENDPOINT GET /api/statistics For example: curl https://192.168.168.1/api/statistics -u rfi:rfi123 Returns: "sysinfo": {...
  • Page 45 The information contained in this document is subject to change. This document contains proprietary information, which is protected by copyright laws. All rights are reserved. No part of this document may be photocopied, reproduced or translated to another language or program language without prior written consent of RFI Engineering B.V. RefGuide_U-routerNGW_v1.01.docx...
  • Page 46: Relay

    "relayState": "ON" "status": "OK" One or, more relays are returned, where each relay is identified by its ‘id’. On every U-router NGW the internal relay has id #0. When intelligent Remote Power Switches are connected (running the RIOT protocol) the ‘id’ of the Remote Power Switch is shown.
  • Page 47: Interface

    14.8 Interface The ‘interface’ endpoints provide information about all IP interfaces on the U-router NGW. You can retrieve or set the interface IP configuration for the Ethernet, mobile and virtual interfaces on the unit. ENDPOINTS GET /api/interface POST /api/interface You can use the endpoint to retrieve the status of the interfaces.
  • Page 48 Returns: "status": "OK" For example, to change the ‘metric’ on the ‘eth0’ interface: curl -X POST https://192.168.168.1/api/interface -u rfi:rfi123 -d "id=eth0&metric=121" Returns: "status": "OK" The information contained in this document is subject to change. This document contains proprietary information, which is protected by copyright laws.
  • Page 49: Mobile

    14.9 Mobile The ‘mobile’ endpoints provide information about the mobile connection on the U-router NGW. You can retrieve or set the mobile configuration, such as APN name, username and password associated with the mobile connection. Also, the information about the connected cell tower can be obtained.
  • Page 50 Returns: "status": "OK" As an example, to change the PIN code settings to access the SIM card: curl -X POST https://192.168.168.1/api/mobile -u rfi:rfi123 -d "simPin=1234" Returns: "status": "OK" The information contained in this document is subject to change. This document contains proprietary information, which is protected by copyright laws.
  • Page 51: User

    14.10 User The ‘user’ endpoints provide information about the users on the U-router NGW. You can retrieve a list of users or add, change and delete users. ENDPOINTS GET /api/user POST /api/user You can use the endpoint to retrieve a list of users on the system.
  • Page 52 The information contained in this document is subject to change. This document contains proprietary information, which is protected by copyright laws. All rights are reserved. No part of this document may be photocopied, reproduced or translated to another language or program language without prior written consent of RFI Engineering B.V. RefGuide_U-routerNGW_v1.01.docx...
  • Page 53: Settings

    14.11 Settings The ‘settings’ endpoints provide a list of settings on the U-router NGW. Such as the serial port speed and interface, USB power on/off and expansion port settings. ENDPOINTS GET /api/settings POST /api/settings You can use the endpoint to retrieve a list settings on the system.
  • Page 54 300 and 256000. For example: term_speed=9600 reboot When reboot=1 the U-router NGW will reboot immediately. flush_consolelog When flush_consolelog=1 the Serial Console log will be deleted and a new (empty) log file will be started.
  • Page 55: Openvpn

    The ‘config_txt’ element contains the complete list of OpenVPN settings. In the Web GUI you can paste your OpenVPN settings into a text box and upload this to the U-router NGW. On the API you can post the complete config in one go.
  • Page 56 The information contained in this document is subject to change. This document contains proprietary information, which is protected by copyright laws. All rights are reserved. No part of this document may be photocopied, reproduced or translated to another language or program language without prior written consent of RFI Engineering B.V. RefGuide_U-routerNGW_v1.01.docx...
  • Page 57: Timeserver

    1.debian.pool.ntp.org 2.debian.pool.ntp.org 3.debian.pool.ntp.org\n" "status": "OK" Time keeping on the U-router NGW is performed by the (see chapter:10). This systemd-timesyncd process attempts to synchronize the system clock with accurate clocks (NTP servers) on the Internet. When the NTP servers are not reachable, the system clock can also be synchronized to the clock of the mobile network.
  • Page 58 The information contained in this document is subject to change. This document contains proprietary information, which is protected by copyright laws. All rights are reserved. No part of this document may be photocopied, reproduced or translated to another language or program language without prior written consent of RFI Engineering B.V. RefGuide_U-routerNGW_v1.01.docx...

Table of Contents

Save PDF