MISA OPTION CloudGate Guide
CloudGate
Technical documentation
Copy taken from CloudGate Universe on: 14/05/2014
Table of contents
User Guide ................................................................................................................................................. 1
Introducing the CloudGate ...................................................................................................................... 2
Base Unit Hardware ........................................................................................................................... 4
Expansion Cards ................................................................................................................................. 6
CloudGate Universe ............................................................................................................................ 9
Custom Developer Images ................................................................................................................ 10
Network Interfaces ........................................................................................................................... 11
Installing the CloudGate ....................................................................................................................... 13
Attaching the Antennas .................................................................................................................... 16
Installing the SIM ............................................................................................................................. 17
Activating the CloudGate .................................................................................................................. 18
Powering On the CloudGate ............................................................................................................. 22
Selecting a Wireless Provider ........................................................................................................... 23
Installing Expansion Cards ............................................................................................................... 26
Mounting the CloudGate ................................................................................................................... 28
Configuring the Base Unit ..................................................................................................................... 30
Logging On to the Base Unit ............................................................................................................ 32
Home Tab .......................................................................................................................................... 33
Interfaces Tab ................................................................................................................................... 36
Ethernet Tab ................................................................................................................................ 37
3G Connection Tab ....................................................................................................................... 41
Ethernet Switch ............................................................................................................................ 49
WLAN Access Point ...................................................................................................................... 52
WLAN Client ................................................................................................................................. 53
Firewall Tab ...................................................................................................................................... 54
Connection Persistence .................................................................................................................... 61
Provisioning Tab ............................................................................................................................... 64
System Tab ....................................................................................................................................... 66
Configuring the VPN ......................................................................................................................... 73
Configuring Expansion Cards ................................................................................................................ 77
Configuring the WLAN Card ............................................................................................................. 78
WLAN Access Point Tab ............................................................................................................... 79
WLAN Client Tab .......................................................................................................................... 83
Hardware Guide ...................................................................................................................................... 87
Mechanical Drawings ............................................................................................................................ 88
IP-65 requirement ............................................................................................................................. 90
Front and Back Panels .......................................................................................................................... 92
LED Descriptions ................................................................................................................................... 95
Main Board Specifications .................................................................................................................... 98
Expansion Card Specifications ............................................................................................................ 100
WLAN Card Specifications .............................................................................................................. 101
Low Cost Serial Card Specifications ............................................................................................... 103
Industrial Serial Card Specifications .............................................................................................. 105
Basic Ethernet Switch Specifications ............................................................................................. 108
PoE Ethernet Switch Specifications ............................................................................................... 110
Developer Card Specifications ........................................................................................................ 113
HDK Card ........................................................................................................................................ 114
Telematics Card .............................................................................................................................. 115
RF Specifications ................................................................................................................................. 126
Antenna Recommendations ............................................................................................................ 130
Ethernet Specifications ....................................................................................................................... 132
Environmental Specifications .............................................................................................................. 135
Power Requirements ........................................................................................................................... 136
Internal Power Circuits ................................................................................................................... 138
SIM Card Requirements ...................................................................................................................... 140
Certification and Operator Approvals ................................................................................................. 141
CloudGate 3G Americas .................................................................................................................. 144
CloudGate 3G EMEA ....................................................................................................................... 147
CloudGate 3G JP/APAC ................................................................................................................... 149
CloudGate Ethernet ........................................................................................................................ 152
Certification of third-party expansion cards ................................................................................... 155
CloudGate Universe Guide .................................................................................................................. 159
Introducing the CloudGate Universe .................................................................................................. 160
Creating an Account ............................................................................................................................ 161
Activating a CloudGate Using CloudGate Universe ............................................................................ 163
Logging on to CloudGate Universe ..................................................................................................... 166
Editing Your User Profile .................................................................................................................... 167
Quick Tour ........................................................................................................................................... 169
Updating Devices ................................................................................................................................ 172
Displaying and Sorting the Device List ........................................................................................... 173
Setting the Check-In Frequency ..................................................................................................... 175
Enabling Automatic Update ............................................................................................................ 177
Disabling Automatic Update ........................................................................................................... 179
Changing the Device Name and Description .................................................................................. 180
Deactivating Devices ...................................................................................................................... 181
Managing Images ................................................................................................................................ 182
Managing CloudGate Firmware ...................................................................................................... 183
Managing Developer Images .......................................................................................................... 184
Managing Configurations ............................................................................................................... 185
Creating config files ................................................................................................................... 186
Uploading a Config File .............................................................................................................. 188
Managing Gobi Firmware ............................................................................................................... 190
Downloading Images ....................................................................................................................... 191
Managing Groups of Devices ............................................................................................................... 193
Creating Groups .............................................................................................................................. 194
Adding Devices to a Group ............................................................................................................. 196
Creating Default Releases .............................................................................................................. 197
Displaying Group Content ............................................................................................................... 199
Managing Users and Group Administrators ................................................................................... 200
Assigning Users to a Group ........................................................................................................ 201
Creating a Group Admin ............................................................................................................ 203
Removing Users from a Group ................................................................................................... 204
Troubleshooting ................................................................................................................................... 205
How does connection priority work in conjunction with connection persistence ............................... 206
How to configure CloudGate to switch automatically to 3G when the fixed DSL connection is ......... 207
offline?
Priority Order Between Remote Login, DMZ, and Port Forwarding Rules ......................................... 209
When Do Automatic Updates Occur? .................................................................................................. 211
Why Does the Page Display Incorrectly? ............................................................................................. 213
Licenses ................................................................................................................................................. 214
LIBJSON .............................................................................................................................................. 215
1 / 215
Option CloudGate - Last updated on 14/05/2014
User Guide
Welcome!
The CloudGate User Guide explains how to install and activate your CloudGate base unit, install
custom expansion cards, and configure your device for use.
This guide is designed for:
Distributors
●
System integrators
●
Field engineers
●
CloudGate hardware specifications and technical information are available in the Hardware Guide.
Information about deploying CloudGate firmware, configuration and software updates is available in
the Provisioning Server Guide.
Option also licences the CloudGate design to third party hardware and software developers who want
to create custom expansion cards and software images for specific needs. For information on the
developer program, contact Option Customer Support.
2 / 215
Option CloudGate - Last updated on 14/05/2014
Introducing the CloudGate
The CloudGate M2M Gateway from Option provides LAN to WWAN routing and GPS functionality in a
simple, cost-effective base unit. The CloudGate can be configured locally or remotely from a PC,
tablet, or smartphone, and is certified on all major U.S. cellular operators (CDMA/EvDO and
WCDMA/HSPA+).
With two expansion card slots for additional radio and wired interfaces, customizable software and
configuration images, and a cloud-based provisioning system, the CloudGate is a flexible, intelligent
platform for wireless M2M connectivity.
Base Unit Design
The CloudGate base unit design features LAN-to-WWAN and GPS interfaces and advanced error
detection and repair watchdogs. When a component or software process loses connectivity, the
device automaticaly resets or repowers itself. You can also schedule the device to reset at specific
intervals to ensure daily, error-free operation.
Finally, CloudGates can be monitored and provisioned remotely, which vastly reduces the technician
time on site, and enables firmware updates and new software features to be deployed quickly and
efficiently.
Expansion Slots
To expand the capabilties of the base unit, you can add up to two expansion cards and deploy
customized software, or developer images. Option offers several expansion cards with WLAN and Serial
interfaces and a hardware development kit for system integrators to develop their own cards. Likewise,
a software development kit is available to partners who need custom software for a site-specific
application.
For more information on the CloudGate developer program, contact Option Customer Support.
Feature Overview
Reliability and Security
Software and hardware watchdogs continually monitor for loss of connectivity and will repair the
●
problem if detected
3 / 215
Option CloudGate - Last updated on 14/05/2014
Software and configuration images are protected with digital signatures
●
Secure, redundant firmware and configuration images ensure the unit can revert to previous working
●
settings if a problem is detected
Management functions are protected by certificate or password and applied over encrypted links
●
Flexibilty
Two hardware expansion slots allow for additional radio and/or wired interfaces
●
Expansion cards are designed with board-edge connectors for easy installation and replacement in
●
the field
Hardware and software development kits are available to partners for developing custom expansion
●
cards and software images
Provisioning
The CloudGate Universe allows for efficient deployment of firmware, configuration file and developer
●
image updates to mutliple CloudGates at once
More Resources
Introduction Video
CloudGate Datasheet (US)
CloudGate Datasheet (WCDMA)
CloudGate Datasheet (Japan)
CloudGate Portfolio
CloudGate Accessories
CloudGate Universe
CloudGate for developers
4 / 215
Option CloudGate - Last updated on 14/05/2014
Base Unit Hardware
The mechanical housing for each base unit is identical. The bottom front and bottom back panels can
be customized to accomodate different expansion cards and interfaces. Internally, the main board is
also identical and is designed around a WWAN module1 and Ethernet interface.
The base unit incorporates two hardware expansion slots for additional radio and wired interfaces.
Option offers a range of expansion cards but also licenses the expansion card format and connector
details so that third parties can design their own expansion cards to fit specific needs.
The CloudGate base unit consists of:
Light weight aluminum housing with DIN rail and wall mounting options
●
Customizable bottom front and bottom back panels
●
Two SMA-type antenna interfaces: WWAN Main and WWAN Div/GPS1
●
WLAN, GPS, System, and WWAN LEDs showing system status and signal strength1
●
10/100 MB/s RJ-45 Ethernet interface
●
9-33 VDC power in with Micro-Fit™, dual row, 4-circuit connector
●
Two hardware expansion slots for additional radio or wired interfaces
●
Internal main board with WWAN module, Ethernet interface and GPS1
●
Freescale i.MX280 450MHz Processor
❍
64 MB Ram
❍
128 MB Flash
❍
GTM68X WWAN module1
❍
Base Unit Versions
Three versions of the base unit exist:
CG0192
●
5 / 215
Option CloudGate - Last updated on 14/05/2014
Contains the GTM689 which can handle CDMA/EVDO and WCDMA technology.
❍
Used in the U.S. and Canada and has the correct certification and approvals for these countries.
❍
CG0112
●
Contains the GTM681 which can handle only WCDMA technology.
❍
Used in Europe and has the correct certification and approvals for these countries.
❍
CG0102
●
Does not contain a WWAN module.
❍
Can be used in Europe, US and Canada
❍
Note 1:
Note 1:
The CG0102 is a CloudGate without a WWAN module. The front plate will have no RF connectors
The CG0102 is a CloudGate without a WWAN module. The front plate will have no RF connectors
and it will have no GPS functionality.
and it will have no GPS functionality.
Related Topics
Expansion Cards
Mounting the CloudGate
Mechanical Drawings
Front and Back Panels
6 / 215
Option CloudGate - Last updated on 14/05/2014
Expansion Cards
Option offers a several expansion cards. For custom solutions, Option also licenses a hardware
development kit. Third parties can design their own expansion cards to fit specific needs.
The expansion cards offered by Option include:
WLAN expansion card (CG2101)
●
Low cost serial card (CG1101)
●
Industrial serial card (CG1102)
●
PoE Ethernet switch (CG1103)
●
Basic Ethernet switch (CG1104)
●
Developer card (CG1105)
●
WLAN Expansion Card - CG2101
Provides 802.11abgn
●
Simultaneous Access Point and Station mode for providing service or connection as a wireless LAN
●
Failover to WLAN client for WAN connectivity
●
Dual SSID
●
Low Cost Serial Card - CG1101
7 / 215
Option CloudGate - Last updated on 14/05/2014
Provides a single RS-232, 921.6Kbaud maximum speed.
●
Industrial Serial Card - CG1102
One RS-232 port with 921.6 Kbaud maximum speed.
●
2 KV isolated RS-485 serial port, 921.6 kbaud, full duplex or half duplex; 2 wire or 4 wire with switchable
●
termination.
Basic Ethernet Switch - CG1104
4-port 10/100Base-T
●
µSD card
●
PoE Ethernet Switch - CG1103
8 / 215
Option CloudGate - Last updated on 14/05/2014
Power over Ethernet board. (requires special power supply)
●
4-port 10/100Base-T with 2 ports class 4 or 4 ports up to class 3 PoE
●
µSD card
●
Developers Expansion Card - CG1105
Extended format with headers on all interfaces to attach to development equipment
●
Pre-wired RS-232 port, GPIO connected temperature sensor, a relay and SD card slot.
●
Related Topics
Installing Expansion Cards
Configuring Expansion Cards
9 / 215
Option CloudGate - Last updated on 14/05/2014
CloudGate Universe
The CloudGate Universe is the configuration and deployment mechanism for the CloudGate. From the
factory, CloudGate base units have no customization.
On power-up, the CloudGate connects to the CloudGate Universe over the wired Ethernet port and
automatically downloads the appropriate update. If the Ethernet interface is unavailable, then the
CloudGate uses the WWAN interface to download the updates.
Tip: You can set the CloudGate Universe enable or disable the automatic downloads.
Tip: You can set the CloudGate Universe enable or disable the automatic downloads.
The CloudGate downloads the following files from the CloudGate Universe:
CloudGate firmware: device firmware provided by Option.
●
CloudGate developer image: customized software that provides additional functionality to the
●
CloudGate or controls third-party expansion cards.
CloudGate config file: configuration settings that can be applied to one or more CloudGates
●
CloudGate GOBI firmware image: software that updates changes to wireless operator firmware
●
Related Topics
CloudGate Universe Guide
3G Connection Tab
10 / 215
Option CloudGate - Last updated on 14/05/2014
Custom Developer Images
To extend the base unit functionality provided by the CloudGate firmware, you can install developer
software images onto an overlay file system and adapt the CloudGate to specific needs. Developer
images can be created for custom applications and middleware, and to control third-party expansion
cards.
Option licenses a software development kit which allows third parties to design developer images. For
information on the CloudGate developer program, contact Option Customer Support.
Related Topics
CloudGate Universe
11 / 215
Option CloudGate - Last updated on 14/05/2014
Network Interfaces
For connecting to the Internet, the CloudGate base unit comes with an Ethernet interface and a
WWAN1 (3G) interface. An optional WLAN interface is available only when the WLAN expansion card is
installed.
While the WWAN1 network interface is always a direct connection to the Internet, or WAN, the Ethernet
interface and optional WLAN interface can act as either a WAN or a local Area Network (LAN). The
LAN interface allows local devices to connect to the Internet through the CloudGate.
The network interfaces available on the CloudGate are:
Ethernet interface: can be a WAN or LAN connection depending on the behavior of the WAN/LAN
●
switchover feature at start-up or can be set manually.
WWAN1 interface: always a WAN connection because it connects directly to the internet.
●
WLAN interface: optional WLAN expansion card can be configured as either a WLAN client, which will
●
act as a WAN interface, or as a WLAN access point, which will act as a LAN interface.
Choosing a WAN or LAN Interface
The CloudGate can have only one WAN connection at a time. However the CloudGate can be
connected to several different LAN networks simultaneously.
In choosing the network interface, you can specify:
Manual: the network interface is selected through the on device web interface on the Home page.
●
Automatic: a priority list defines which network interface to use to connect to the WAN/internet. The
●
network interface at the top of the list will try to connect to the WAN/internet first. If this succeeds then
the CloudGate continues to use this network interface to connect to the WAN/internet. If the
connection to the internet fails, the CloudGate tries the second interface in the priority list and so on.
The priority list is defined in the on device web interface on the Home page.
Warning:
Warning: In firmware versions 1.12.0 and older, the ability to choose between automatic mode
In firmware versions 1.12.0 and older, the ability to choose between automatic mode
and manual mode and to set a connection priority list are not available. These firmware versions
and manual mode and to set a connection priority list are not available. These firmware versions
always try to connect to the internet over the Ethernet interface first. When this interface is not
always try to connect to the internet over the Ethernet interface first. When this interface is not
able to connect to the internet, the CloudGate will try to connect to the internet via the WWAN
able to connect to the internet, the CloudGate will try to connect to the internet via the WWAN
interface.
interface.
Note1
Note1
The CG0102 has no WWAN module!
The CG0102 has no WWAN module!
13 / 215
Option CloudGate - Last updated on 14/05/2014
Installing the CloudGate
To install the CloudGate base unit out of the box, review the installation requirements and then follow
the installation steps listed below. For information about customizing the base unit, learn about installing
expansion cards and provisioning the device with a custom developer image.
Installation Requirements
CloudGate base unit
●
Power supply between 9V and 33V DC with the correct Micro-Fit™ connector. See Power
●
Requirements.
Two WWAN1 antennas. See Antenna Recommendations.
●
Ethernet cable
●
Web browser on a laptop or smartphone.
●
A service plan from a wireless service provider.1
●
One of the next US wireless service providers:
❍
Sprint
■
Verizon Wireles
■
AT&T (requires SIM)
■
T-Mobile (requires SIM)
■
For non US wireless service providers, any WCDMA based network will work.1
❍
14 / 215
Option CloudGate - Last updated on 14/05/2014
Browser Requirements
For the Provisioning Server:
Chrome 27.0(.1453.110 m)
●
Firefox 21.0
●
Internet Explorer 9(.0.8112.16421)
●
Internet Explorer 10(.0.9200.16540)
●
For the CloudGate one-device web interface:
Internet Explorer 9
●
Safari 5.1
●
Firefox (Windows 21.0, Mac 12.0)
●
Chrome (Windows 27.0.1453.110, Mac 26.0.1410.65)
●
Opera (Windows 12.02, Mac 12.10)
●
Installation Overview1
Before installing your CloudGate device, read the
Before installing your CloudGate device, read the safety guidelines
safety guidelines carefully. Not following these
carefully. Not following these
guidelines can cause harm to the CloudGate, yourself or other persons.
guidelines can cause harm to the CloudGate, yourself or other persons.
To install the CloudGate base unit:
Attach the antennas.1.
Install the SIM, if your wireless operator is using a SIM card, or make sure that a service plan is2.
associated with your device (for Sprint and Verizon).
Register the CloudGate on the Provisioning Server.3.
Power on the CloudGate.4.
Connect the CloudGate to a laptop and log in to the on-device web interface.5.
Select a wireless operator in the 3G Connection tab.6.
For operators using a SIM card, the network settings will populate automatically for most SIM cards.
●
Check the settings of the APN , Username and Password. Update them if appropriate. Click Save
changes. Learn more about 3G network settings
For CDMA based operators (for Sprint or Verizon, no SIM card is required), click Start programming to
●
start the activation sequence. Learn more about CDMA network settings
Note1
Note1
15 / 215
Option CloudGate - Last updated on 14/05/2014
The CG0102 has no WWAN module!
The CG0102 has no WWAN module!
16 / 215
Option CloudGate - Last updated on 14/05/2014
Attaching the Antennas
The CloudGate base unit has two SMA-female antenna connectors on the front panel.
Before attaching the antennas, make sure they meet these RF specifications. Also refer to these
antenna recommentations for a list of specific models.
For example, the following base unit is installed with two hinged, SMA antennas from Taoglas (Taoglas
TG.09.0113 - DigiKey)
Related Topics
Front and Back Panels
RF Specifications
17 / 215
Option CloudGate - Last updated on 14/05/2014
Installing the SIM
For some UMTS and 3G operators, such as AT&T, T-Mobile and European operators, you must install a
SIM card associated with the service plan.
TIP For other wireless operators, such as Sprint or Verizon Wireless, makes sure a service plan is
TIP For other wireless operators, such as Sprint or Verizon Wireless, makes sure a service plan is
associated with the device before continuing the installation.
associated with the device before continuing the installation.
To install the SIM:
Using a T6 Torx screwdriver, remove the four screws from the top plate on the back panel, and then1.
remove the plate.
Insert the SIM into the SIM slot.2.
Re-assemble the top cover plate and screws.3.
Related Topics
Selecting a Wireless Operator
SIM Card Requirements
Table of contents
