RACOM M!DGE User manual

Operating manual
.
M!DGE
GPRS/UMTS/HSPA/LTE router
.
1.3
9/19/2013
www.racom.eu
RACOMs.r.o. •Mirova1283•59231NoveMestonaMorave•CzechRepublic
Tel.:[phone]•Fax:[phone]•E-mail: [e-mail]

Table of Contents
Important Notice .................................................................................................................................. 5
Getting started ..................................................................................................................................... 6
1. M!DGE router .................................................................................................................................. 7
1.1. Introduction ........................................................................................................................... 7
1.2. Key Features ........................................................................................................................ 7
1.3. Standards ............................................................................................................................. 8
2. M!DGE in detail ............................................................................................................................... 9
3. Implementation Notes ................................................................................................................... 11
3.1. Ethernet SCADA protocols ................................................................................................. 11
3.2. Serial SCADA protocols ..................................................................................................... 11
3.3. Centre of the network ......................................................................................................... 11
3.4. VPN tunnels ....................................................................................................................... 11
4. Product .......................................................................................................................................... 12
4.1. Dimensions ......................................................................................................................... 12
4.2. Connectors ......................................................................................................................... 12
4.3. Indication LEDs .................................................................................................................. 15
4.4. Technical specifications ...................................................................................................... 17
4.5. Model offerings ................................................................................................................... 19
4.6. Accessories ........................................................................................................................ 19
5. Bench test / Step by Step Guide ................................................................................................... 21
5.1. Connecting the hardware ................................................................................................... 21
5.2. Powering up your M!DGE ................................................................................................... 21
5.3. Connecting M!DGE to a programming PC ......................................................................... 21
5.4. Basic Setup ........................................................................................................................ 22
6. Installation ..................................................................................................................................... 23
6.1. Mounting ............................................................................................................................. 23
6.2. Antenna mounting .............................................................................................................. 23
6.3. Grounding ........................................................................................................................... 23
6.4. Power Supply ..................................................................................................................... 23
7. Web Configuration ......................................................................................................................... 24
7.1. HOME ................................................................................................................................. 24
7.2. INTERFACES ..................................................................................................................... 25
7.3. ROUTING ........................................................................................................................... 38
7.4. FIREWALL .......................................................................................................................... 42
7.5. VPN .................................................................................................................................... 46
7.6. SERVICES ......................................................................................................................... 54
7.7. SYSTEM ............................................................................................................................. 77
7.8. LOGOUT ............................................................................................................................ 93
8. Command Line Interface ............................................................................................................... 94
8.1. General Usage ................................................................................................................... 94
8.2. Print Help ............................................................................................................................ 95
8.3. Getting Config Parameters ................................................................................................. 96
8.4. Setting Config Parameters ................................................................................................. 96
8.5. Getting Status Information .................................................................................................. 96
8.6. Sending E-Mail or SMS ...................................................................................................... 97
8.7. Updating System Facilities ................................................................................................. 98
8.8. Restarting Services ............................................................................................................ 98
8.9. Resetting System ............................................................................................................... 99
8.10. Rebooting System ............................................................................................................ 99
8.11. Running Shell Commands ................................................................................................ 99
8.12. CLI–PHP .......................................................................................................................... 99
3© RACOM s.r.o. – M!DGEGPRS/UMTS/HSPA/LTE router

9. Troubleshooting ........................................................................................................................... 103
9.1. Common Errors ................................................................................................................ 103
9.2. Messages ......................................................................................................................... 103
9.3. Troubleshooting tools ....................................................................................................... 104
10. Safety, environment, licensing ................................................................................................... 105
10.1. Safety Instructions .......................................................................................................... 105
10.2. Warranty ......................................................................................................................... 106
A. Glossary ...................................................................................................................................... 107
Index ................................................................................................................................................ 109
B. Revision History .......................................................................................................................... 111
List of Figures
1. Router M!DGE UMTS and M!DGE LTE .......................................................................................... 6
2.1. Front panel and terminal panel of M!DGE .................................................................................... 9
4.1. Dimensions in milimetres ........................................................................................................... 12
4.2. Antenna connectors SMA ........................................................................................................... 12
4.3. 2× Eth RJ45 Plug - pin numbering ............................................................................................. 13
4.4. USB connector ........................................................................................................................... 13
4.5. Screw terminal ............................................................................................................................ 14
4.6. Indication LEDs .......................................................................................................................... 15
4.7. Flat bracket ................................................................................................................................. 19
4.8. Demo case ................................................................................................................................. 20
6.1. Grounding ................................................................................................................................... 23
List of Tables
4.1. Pin assignment Ethernet Interface ............................................................................................. 13
4.2. USB pin description .................................................................................................................... 13
4.3. Pin assignment of screw terminal .............................................................................................. 14
4.4. Digital inputs levels ..................................................................................................................... 14
4.5. Digital outputs parametres ......................................................................................................... 14
4.6. M!DGEs interfaces and status indicators ................................................................................... 16
4.7. Technical specifications .............................................................................................................. 18
M!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.4
M!DGE
GPRS/UMTS/HSPA/LTE router

Important Notice
Copyright
© 2013 RACOM. All rights reserved.
Products offered may contain software proprietary to RACOM s. r. o. (further referred to under the ab-
breviated name RACOM). The offer of supply of these products and services does not include or infer
any transfer of ownership. No part of the documentation or information supplied may be divulged to
any third party without the express written consent of RACOM.
Disclaimer
Although every precaution has been taken in preparing this information, RACOM assumes no liability
for errors and omissions, or any damages resulting from the use of this information. This document or
the equipment may be modified without notice, in the interests of improving the product.
Trademark
All trademarks and product names are the property of their respective owners.
Important Notice
• Due to the nature of wireless communications, transmission and reception of data can never be
guaranteed. Data may be delayed, corrupted (i.e., have errors), or be totally lost. Significant delays
or losses of data are rare when wireless devices such as the M!DGE are used in an appropriate
manner within a well‐constructed network. M!DGE should not be used in situations where failure
to transmit or receive data could result in damage of any kind to the user or any other party, including
but not limited to personal injury, death, or loss of property. RACOM accepts no liability for damages
of any kind resulting from delays or errors in data transmitted or received using M!DGE, or for the
failure of M!DGE to transmit or receive such data.
• Under no circumstances is RACOM or any other company or person responsible for incidental,
accidental or related damage arising as a result of the use of this product. RACOM does not provide
the user with any form of guarantee containing assurance of the suitability and applicability for its
application.
• RACOM products are not developed, designed or tested for use in applications which may directly
affect health and/or life functions of humans or animals, nor to be a component of similarly important
systems, and RACOM does not provide any guarantee when company products are used in such
applications.
5© RACOM s.r.o. – M!DGEGPRS/UMTS/HSPA/LTE router
Important Notice

Getting started
M!DGE Wireless Routers will only operate reliably over the cellular network if there is a strong signal.
For many applications a flexible stub antenna would be suitable but in some circumstances it may be
necessary to use a remote antenna with an extension cable to allow the antenna itself to be positioned
so as to provide the best possible signal reception. RACOM can supply a range of suitable antennas.
1. Install the SIM card
Insert a SIM card into the SIM socket. Make sure the SIM is suitable for data transmission.
2. Connect the GSM/UMTS antenna
Fit a GSM/UMTS antenna. 1. If needed, contact RACOM for suitable antennas and other details.
3. Connect the LAN cable
Connect one M!DGE Ethernet port to your computer using an Eth cat.5 cable
4. Connect the power supply
Connect the power supply wires to the M!DGE screw terminals. Enable the power supply.
5. Setting of IP address of the connected computer
By default the DHCP server is enabled, thus you can allow the Dynamic Host Configuration Protocol
(DHCP) on your computer to lease an IP address from the M!DGE. Wait aproximatelly 20 seconds
until your computer has received the parameters (IP address, subnet mask, default gateway, DNS
server).
As an alternative. you can configure a static IP address on your PC (e.g. 192.168.1.2/24) so that
it is operating in the same subnet as the M!DGE. The M!DGE default IP address for first Eth interface
is 192.168.1.1, the subnet mask is 255.255.255.0.
6. Start setting up using web browser
Open a web browser such as Internet Explorer or Firefox. In the address field of the web browser,
enter default IP address of M!DGE (i.e. http://192.168.1.1); initial screen will appear. Follow the
instructions and use the M!DGE/MG102 Web Manager to configure the device. For more datails
see chap. 7. Web Configuration
Fig. 1: Router M!DGE UMTS and M!DGE LTE
M!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.6
Getting started

1. M!DGE router
1.1. Introduction
Although M!DGE wireless routers have been specifically designed for SCADA and telemetry, they are
well suited to variety of wireless applications. M!DGE HW and SW are ready to maintain reliable and
secure connections from an unlimited number of remote locations to a central server. Both standard
Ethernet/IP and serial interfaces are available. Moreover, two digital inputs and two digital outputs can
be used for direct monitoring and control of application devices.
M!DGE versatility is further enhanced by two independent Ethernet ports. These can be configured to
either support two independent LANs (e.g. LAN and WAN settings), or simply connect two devices
within one LAN (effectively replacing an Eth switch). M!DGE software is based on proven components,
including an Embedded Linux operating system and standard TCP/IP communication protocols.
Combining M!DGE with an MG102 two-SIM router in one network is quite straightforward because of
fully compatible interface settings and behaviour on all HW interfaces. Thanks to the compact size and
versatility of M!DGE, wireless routers prove indispensable in many SCADA and telemetry, as well as
POS, ATM, lottery and security/surveillance applications.
M!DGE together with RACOM RipEX radio router offers an unrivalled solution for combining GPRS
and UHF/VHF licensed radio in a single network. Even a single RipEX in the centre of a M!DGE network
allows for efficient use of addressed serial SCADA protocols.
1.2. Key Features
Mobile Interface Parameters
• Mobile Connection HSDPA, HSUPA, UMTS, EDGE, GPRS, GSM and LTE
• Global connectivity
• Transparent hand-over between 2G and 3G (M!DGE UMTS) or 2G, 3G and 4G (M!DGE LTE)
Power supply
• Redundant dual power input pins
• Input voltage: 10.2 – 57.6 VDC
• Max. power consumption: 5 W
Services /Networking
• Fallback Management
• Connection supervision
• Automatic connection recovery
• OpenVPN, IPsec, PPTP, NAPT
• VRRP
• DHCP server, DNS proxy server, DNS update agent
• Telnet server, SSH server, Web server
• NTP
• COM server, Modbus gateway
• Port Forwarding
• Firewall, Access Control Lists
7© RACOM s.r.o. – M!DGEGPRS/UMTS/HSPA/LTE router
M!DGE router

Interfaces
• 2 Ethernet ports: LAN, WAN/LAN
• RS232
• 2× DI, 2× DO
• USB host
Diagnostic and Management
• Web interface, CLI available
• File configuration
• OTA SW update
• Advanced troubleshooting
• SMS remote control, SMS and E-mail notification
• SNMP
1.3. Standards
EN 301 489-1 V1.7.1EMC
EN 301 489-7 V1.3.1
EN 61 000-6:2005
EN 50 121-3-2:2006
EN 50 121-4:2006
EN 60950-1:2006Electrical Safety
IP40IP rating
IEEE 802.3iETH
IEEE 802.3u
IEEE 802.3af
M!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.8
M!DGE router

2. M!DGE in detail
Fig. 2.1: Front panel and terminal panel of M!DGE
All M!DGE/MG102 Wireless Routers run M!DGE/MG102 Software. Software offers the following key
features:
• Interfaces and Connection Management (section Section 7.2, “INTERFACES”)
○ Dial-out (on demand, permanent)
○ Connection Monitoring
○ Fallback to backup profile or SIM
○ SIM and PIN management
○ Automatic or manual network selection
• Routing (section Section 7.3, “ROUTING”)
○ Static Routing
○ NAPT / Port Forwarding
• Security / Firewall (section Section 7.4, “FIREWALL”)
○ NAPT / Port Forwarding
○ Access Control Lists
○ Stateful Inspection Firewall
• Virtual Private Networking (VPN) (section Section 7.5, “VPN”)
○ OpenVPN Client
○ PPTP Server
○ IPsec Peer
○ Dial-in Server
• Services (section Section 7.6, “SERVICES” )
○ COM Server (Tunneling of the serial line over IP)
○ Modbus-RTU to Modbus-TCP Gateway
○ DHCP Server
○ DNS Proxy Server
○ Dynamic DNS Client
○ E-mail Client
○ Notification via E-mail and SMS
9© RACOM s.r.o. – M!DGEGPRS/UMTS/HSPA/LTE router
M!DGE in detail

○ SMS Client
○ SSH Server
○ SNMP Agent
○ Telnet Server
○ Unstructured Supplementary Service Data (USSD)
○ Web Server
○ GPS Daemon (MG102-xGx only)
• System Administration (section Section 7.7, “SYSTEM”)
○ Configuration via Web Manager
○ Configuration via Command Line Interface (CLI) accessible via Secure Shell (SSH) and telnet
○ Batch configuration with text files
○ User admnistration
○ Troubleshooting tools
○ Over the air software update
M!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.10
M!DGE in detail

3. Implementation Notes
3.1. Ethernet SCADA protocols
SCADA equipment with an Ethernet protocol behave as standard Ethernet equipment from a commu-
nications perspective . Thus the communication goes transparently through the GPRS//UMTS/LTE
network. The implementation requires a heightened caution to IP addressing and routing. NAPT func-
tionality should be used frequently.
3.2. Serial SCADA protocols
A SCADA serial protocol typically uses simple 8 or 16 bit addressing. The mobile network address
scheme is an IP network, where range is defined by service provider (sometimes including individual
addresses, even in the case of a private APN). Consequently, a mechanism of translation between
SCADA and the IP addresses is required. To make matters worse, IP addresses may be assigned to
GPRS (EDGE, UMTS, etc.) devices dynamically upon each connection.
Please read the application note SCADA applications and M!DGE/MG1021which describes how to
efficiently solve this problem using RACOM routers.
3.3. Centre of the network
In every network, the centre plays a key role and has to be designed according to customer's require-
ments. Several possible solutions are described in the application note M!DGE/MG102 CENTRE –
Application note2.
3.4. VPN tunnels
security of customer's data arriving through the mobile network is often very important. Private APN is
the basic security requirement, but not safe enough for such applications.
VPN tunnels solution is closely connected with the centre. The solution is mentioned in application note
M!DGE/MG102 CENTRE – Application note3, details for the elemental solution are described in the
application note SCADA applications and M!DGE/MG1024.
1http://hnilux.racom.cz:3004/download/hw/midge/free/cz/midge-app-en.pdf
2http://hnilux.racom.cz:3004/download/hw/midge/free/cz/midge-app-en1.pdf
3http://hnilux.racom.cz:3004/download/hw/midge/free/cz/midge-app-en1.pdf
4http://hnilux.racom.cz:3004/download/hw/midge/free/cz/midge-app-en.pdf
11© RACOM s.r.o. – M!DGEGPRS/UMTS/HSPA/LTE router
Implementation Notes

4. Product
4.1. Dimensions
Fig. 4.1: Dimensions in milimetres
4.2. Connectors
4.2.1. Antenna SMA
Fig. 4.2: Antenna connectors SMA
The UMTS model has one SMA an-
tenna connector.
The LTE model is equipped with two
antenna connectors. The ANT connect-
or (above) serves as a main antenna
connection, the second connector is
auxiliary and serves for better commu-
nication with BTS (diversity).
M!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.12
Product

4.2.2. 2× Eth RJ45
Fig. 4.3: 2× Eth RJ45 Plug - pin numbering
Tab. 4.1: Pin assignment Ethernet Interface
ETH (Ethernet 10Ba-
seT and 100BaseT)
RJ-45
Socket
signalpin
TX+1
TX−2
RX+3
RX−6
4.2.3. USB
M!dge uses USB 1.1, Host A interface. USB interface is wired as standard:
Fig. 4.4: USB connector
Tab. 4.2: USB pin description
wiresignalUSB pin
red+5 V1
whiteData(−)2
greenData (+)3
blackGND4
4.2.4. Screw terminal
Screw terminal plug type Stelvio Kontek CPF5/15 or MRT3P/15V01 can be used.
13© RACOM s.r.o. – M!DGEGPRS/UMTS/HSPA/LTE router
Product

Fig. 4.5: Screw terminal
Tab. 4.3: Pin assignment of screw terminal
signalpin descriptionpin
Ground internally connected with casing groundVGND 1
Dual power input - not connected with pin 4: 12–48 VDC
(–15% +20%) = 10.2–57.6 VDC
V+ (12–48 V=)
2
Ground internally connected with casing groundVGND 3
Dual power input– not connected with pin 2: 12–48 VDC
(–15 % +20 %) = 10.2–57.6 VDC.
V+ (12–48 V=)
4
RS232 – RxDRxD5
RS232 – RxDTxD6
RS232 – RxDGND7
Digital output. Dry contact relay. Normally open with M!DGE
without powering
DO1:
8
9
Digital output. Dry contact relay. Normally open with M!DGE
without powering. See section Section 7.2.6, “Digital I/O”
for detailes.
DO2:
10
11
Digital input 1 See section Section 7.2.6, “Digital I/O”DI1−12
Digital input 1DI1+13
Digital input 2DI2−14
Digital input 2DI2+15
Tab. 4.4: Digital inputs levels
0 to 5.6 VDClogical level 0
7.2 to 40 VDClogical level 1
Note: Negative input voltage is not recognised.
Tab. 4.5: Digital outputs parametres
1 AMaximal continuous current
60 VDC, 42 VAC (Vrms)Maximal switching voltage
60 WMaximal switching capacity
M!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.14
Product

4.2.5. Reset button
The Reset button is placed close to the screw terminal and it is labelled "Reset". Use a blunt tool with
1 mm in diameter (e.g. paper clip) to press the button.
Keep it pressed for at least 3 seconds for reboot and at least 10 seconds for a factory reset. The start
of the factory reset is confirmed by all LEDs lighting up for one second. The button can be released
afterwards.
4.3. Indication LEDs
Fig. 4.6: Indication LEDs
15© RACOM s.r.o. – M!DGEGPRS/UMTS/HSPA/LTE router
Product

Tab. 4.6: M!DGEs interfaces and status indicators
FunctionStateLabel
Start up, maintenanceblinking slowly
Status Readysolid
Right side descriptiongreen color
Left side descriptionyellow color
Excellent GSM signalgreen on
Connect
Medium GSM signalyellow on
Weak GSM signalred on
Mobile interface enabled but not connectedred blinking
Connectedred continually
VPN connection is upgreen on
VPN VPN connection is enabled and not connectedgreen blinking
Closedyellow on
DO1 Openedyellow off
Closedyellow on
DO2 Openedyellow off
Input setyellow on
DI1 Input not setyellow off
Input setyellow on
DI2 Input not setyellow off
M!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.16
Product

4.4. Technical specifications
17© RACOM s.r.o. – M!DGEGPRS/UMTS/HSPA/LTE router
Product

Tab. 4.7: Technical specifications
Mobile Interface UMTS
Multimode HSDPA, HSUPA, UMTS, EDGE, GPRS and GSM
3G–UMTS, HSDPA, HSUPA, UMTS: 850/900/1900/2100 MHz
2G–EDGE, GPRS, GSM: 850/900/1800/1900 MHz
Data rates: max. 7.2 Mbps downlink / 5.76 Mbps uplink
Mobile Interface LTE
Multimode LTE, HSPA+, UMTS, EDGE, GPRS, GSM
4G–LTE: 800/900/1800/2100/2600 MHz
3G–UMTS/HSPA+: 900/2100 MHz
2G–GSM/GPRS/EDGE: 900/1800/1900 MHz
Data rates up to 100 Mbps downlink / 50 Mbps uplink
2× Ethernet 10/100 Base-T, Auto MDX, 2× RJ45, bridged or routedEthernet
1× 3-wire RS232 on 15-pin screw terminal blockSerial Interface
2 digital inputs
Digital I/O
0–5.6 VDC level 0
7.2–40 VDC level 1, maximum voltage 40 VDC
2 digital outputs
Relay outputs 1st NO, 2nd NC
Limiting continuous current 1 A
Max. switching voltage 60 VDC, 42 VAC (Vrms)
Maximum switching capacity 60 W on 15-pin ter-
minal block
USB service interface USB host interface supporting memory devices
USB type A connector
50 ΩImpedance:
Antenna Interface SMA femaleConnector:
10.2–57.6 VDC (12–48 VDC –15 % / +20 %)Input voltage:
Power Supply Power consumption: Rx max. 3.2 W
Tx max. 5 W
Environmental Conditions
For indoor use only, IP40
Metal casing, DIN rail mounting kit included
–25 to +70 °C (–13 to +158 °F)Temperature range:
0 to 95 % (non condensing)Humidity:
IIOvervoltage Category:
2Pollution Degree:
DIN rail mountingMounting
125 × 45 × 110 mm, 450 g (1 lbs)Dimensions / Weight
CE, R&TTE (see EC Declaration of Conformity)Type Approval
Options
Various antennas suitable for your application are availableAntennas
Flat bracket mounting kitMounting kit
M!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.18
Product

4.5. Model offerings
M!DGE-
UMTS
GPRS/EDGE/UMTS/HSPA router, 2Eth, RS232, 2DI, 2DO
DIN rail holder included
M!DGE-LTE GPRS/EDGE/UMTS/HSPA+/LTE router, 2Eth, RS232, 2DI, 2DO
DIN rail holder included
SW feature keys
The SW feature key should be added to a new or running system via adding a licence: menu SYSTEM
– Licensing (see Section 7.7.7, “Licensing” ).
Mobile IP This key allows building a MobileIP VPN tunnel. See http://en.wikipedia.org/wiki/Mo-
bile_IP for short explanation.
Server Ext. OpenVPN server extension - without this key the maximum number of connected
clients shall reach 10. This key extends the number to 25.
4.6. Accessories
4.6.1. F bracket
Fig. 4.7: Flat bracket
Flat-bracket
Installation bracket for flat mounting. For details on use see chapter Mounting and chapter Dimensions.
19© RACOM s.r.o. – M!DGEGPRS/UMTS/HSPA/LTE router
Product

4.6.2. Demo case
A rugged plastic case for carrying up to three RipEX's and one M!DGE 3G SCADA router. It also contains
all the accessories needed to perform an on-site signal measurement, complete application bench-test
or a functional demostration of both radiomodems and the 3G router. During a field test, units can be
powered from the backup battery and external antenna can be connected to one of the RipEX units
through the „N“ connector on the case.
Fig. 4.8: Demo case
Contents:
• Brackets and cabling for installation of three RipEXes and one M!DGE (units are not part of the
delivery)
• 1× power supply Mean Well AD-155A (100-240 V AC 50-60 Hz/13.8 V DC)
• 1× Backup battery (12V/5Ah, FASTON.250), e.g. Fiamm 12FGH23
• 1× Power cable (European Schuko CEE 7/7 to IEC 320 C13)
• 1× Ethernet patch cable (3 m, UTP CAT 5E, 2× RJ-45)
• Quick start guide
RipEX accessories:
• 3× Dummy load antennas
• 1× L-bracket, 1x Flat-bracket samples
• 1× Fan kit
• 1× X5 – ETH/USB adapter
M!DGE accessories:
• Whip antenna (900–2100 MHz, 2.2 dBi, vertical)
• Externel dimensions: 455 × 365 × 185 mm
• Weight approx. 4 kg (excluding RipEXes and M!DGE)
M!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.20
Product