Ocea Soft OCEABridge User manual

USER GUIDE
OCEABridge
Installation and operation

Introduction
OCEABridge User Guide Page 2
User guide
Notices and safety
Disclaimer and limitation of liability
OCEASOFT assumes no responsibility for any loss or claims by third parties which may arise
through the use of this product. In particular, users must not use the product in any manner
not specifically indicated by OCEASOFT. OCEASOFT shall not be held liable for improper use
of this product. This document is non-contractual and subject to change without notice.
Safety instructions
IMPORTANT: Do not use this product for protection or as part of an automated emergency
system or as for any other application that involves protecting people and/or property.
Customers and users of OCEASOFT products are responsible for making sure that the product
is fit for the intended usage. Do not open the product casing and do not disassemble or
modify internal components in any manner. OCEASOFT products do not contain any internal
components that require user intervention or repair. If the device shows signs of improper
operation, disconnect it immediately from its power source or remove the battery and
contact OCEASOFT technical services.

Introduction
OCEABridge User Guide Page 3
User guide
Standards and approvals
Bluetooth®:
•EC
•FCC: QOQBLED112
•IC: 5123A-BGTBLED112
•KCC (Korea): KCC-CRM-BGT-BLED112
•MIC (Japan): 003WWA111471
WiFi:
•EC
•FCC: ZHZHEe
Cellular data:
•ANATEL
•AT&T, EC, FCC, IC, JATE, NBTC, PTCRB, RCM, Rogers, TELEC
EC:
•EMC: EN 301 489-17 V.3.1.1 in compliance with EN 301 489-1 V2.1.1.
•RF radiation: EN 300 328 V2.1.1
Safety:
•EN 60950-1:2006 + A11:2009 + A1:2010 + A12:2011 + A2:2013
Caution: Any changes or modifications not expressly approved by OCEASOFT could void the
user’s authority to operate the equipment.

Introduction
OCEABridge User Guide Page 4
User guide
Environmental protection
Please respect local regulations concerning disposal of packaging, unused
wireless devices and their accessories, and promote their recycling.
RoHS compliance
The wireless device is in compliance with the restriction of the use of
certain hazardous substances in el
ectrical and electronic equipment
Directive 2002/95/EC (RoHS Directive). Do not dispose of this product
with household trash. OCEASOFT recycles this product under certain
conditions. Please contact us for more information.
Europe
North America
OCEASOFT SA
720 rue Louis Lépine
34000 Montpellier
Tel: [phone]
Fax: [phone]
France
OCEASOFT, Inc.
250 Phillips Boulevard
Ewing, NJ 08618
Tel: [phone]
Fax: [phone]
USA
© 2018 OCEASOFT S.A. All rights reserved. OCEASOFT, the OCEASOFT logo, OCEABridge, OCEASOFT Emerald,
OCEASOFT Atlas, and OCEAView are the exclusive property of OCEASOFT. All other brands mentioned are the
property of their respective owners. This is a non-contractual document. Product photos
and features may vary.
November 2018 Ref: ING-INS-179-EN Rev. 01

Introduction
OCEABridge User Guide Page 5
User guide
Contents
1Introduction.................................................................................................... 7
1.1 OCEABridge™ solution overview................................................................................. 7
Main features......................................................................................................... 7
Architecture ........................................................................................................... 8
Package contents ................................................................................................... 9
1.2 Gateway presentation............................................................................................... 10
Overhead/front view ........................................................................................... 10
Front view ............................................................................................................ 11
Side view (right-hand side) .................................................................................. 12
Back/bottom ........................................................................................................ 12
2Starting the gateway ..................................................................................... 13
2.1 Prerequisites ............................................................................................................. 13
2.2 Plugging in OCEABridge............................................................................................. 14
2.3 Connecting to the configuration application ............................................................ 15
2.4 Gateway properties................................................................................................... 16
2.5 Gateway settings....................................................................................................... 17
Cloud server ......................................................................................................... 17
Operating mode................................................................................................... 18
3Wireless network management ..................................................................... 20
3.1 Connecting to a WiFi network................................................................................... 20
3.2 Adding a wireless network........................................................................................ 22
3.3 Configuring WiFi connection..................................................................................... 22
3.4 Enabling an existing wireless network ...................................................................... 23
3.5 Configuring a 3G/4G connection............................................................................... 24
3.6 Configuring the network LED .................................................................................... 27
4Managing network interfaces ........................................................................ 28
4.1 WAN and WLAN interface......................................................................................... 29
General Setup ...................................................................................................... 29
Advanced Settings................................................................................................ 30
4.2 Cellular data interface............................................................................................... 32

Introduction
OCEABridge User Guide Page 6
User guide
5OCEABridge maintenance.............................................................................. 34
5.1 Changing the password............................................................................................. 34
5.2 Updating OCEABridge data collection firmware....................................................... 34
5.3 Backing up and updating system firmware............................................................... 35
Archiving your data.............................................................................................. 35
Restoring an archived backup.............................................................................. 36
Complete firmware upgrade................................................................................ 36
5.4 Restarting OCEABridge.............................................................................................. 37
6Diagnostics and statistics............................................................................... 38
6.1 Platform information ................................................................................................ 38
6.2 Module statistics ....................................................................................................... 39
6.3 Real-time network traffic .......................................................................................... 41
6.4 Start log ..................................................................................................................... 43
7Annexe 1 – Technical specifications ............................................................... 44

Introduction
OCEABridge User Guide Page 7
User guide
1Introduction
Congratulations and thank you for choosing the OCEABridge™ wireless gateway solution.
This guide provides a general description of the OCEABridge solution as well as practical
instructions for installation and easy setup of your device.
OCEABridge is designed to interact with the following OCEASOFT products and applications:
•Emerald™ modules: Bluetooth-enabled data loggers for monitoring temperature
during shipping.
•Atlas™ modules: limited duration Bluetooth™- enabled data logger for monitoring
the cold chain on-the-go.
•OCEAView: Web application dedicated to OCEASOFT’s Bluetooth™-enabled Atlas™,
Emerald™, and Phoenix™ solutions.
For more information about these products (sold separately), please read the specific
instructions provided with each one.
1.1 OCEABridge™ solution overview
Main features
•Ethernet wired or WiFi wireless connectivity
•Optional 3G/4G cellular data connectivity
•Automatic detection of compatible OCEASOFT data loggers within Bluetooth®
coverage zone
•Data collected and sent automatically to OCEACloud Cloud platform
•Integrated web interface for easy OCEABridge gateway configuration
•Unlimited storage for sensor readings on OCEACloud

Introduction
OCEABridge User Guide Page 8
User guide
Architecture
The OCEABridge™ Bluetooth® gateway automatically detects all compatible OCEASOFT data
logger within wireless range and collects the data stored in their memory.
The gateway is continually connected via the Internet to the OCEACloud platform, where
data is transferred and available to users with the OCEAView™ web application.
The diagram below shows the how the OCEABridge™ gateway functions:
Figure 1 – Data flow from wireless modules to OCEACloud via OCEABridge™
Step
Description
•Simply install your OCEABridge gateway in a loading or unloading zone, or
product handling area.
•Use the embedded web application to set up your OCEABridge gateway.
Data is collected automatically and sent to the server.
•Whenever OCESOFT Bluetooth-enabled data loggers pass withing range,
OCEABridge retrieves their stored data wirelessly.
•Data on the OCEACloud platform is accessible using the OCEAView
application.
1
2
3
4

Introduction
OCEABridge User Guide Page 9
User guide
Package contents
•OCEASOFT OCEABridge™ gateway
•AC power adapter
•Bluetooth dongle
To be ordered separately (depending on your gateway model):
•OCEASOFT wireless data loggers
•3G/4G cellular data module
•Micro SIM card for cellular data

Introduction
OCEABridge User Guide Page 10
User guide
1.2 Gateway presentation
Overhead/front view
Figure 2 – OCEABridge gateway overhead view
1.2.1.1 Description of status LEDs
The OCEABridge gateway has 6 LEDs with colors and blinking patterns that vary with the
device’s status and network traffic:
LED Description
WLAN. Indicator for WiFi or 3G/4G wireless activity (see section 0
Configuring the network LED, page 27).
WAN. RJ-45 port for sending information.
LAN. RJ-45 port for OCEABridge configuration.
System. This LED blinks while OCEABridge is booting (about 15 seconds) and
remains on during normal operation.
Status LED
3G/4G antenna (for
use with optional
d)

Introduction
OCEABridge User Guide Page 11
User guide
Heartbeat (not used).
Power indicator.
Green light remains on, indicating power on.
Front view
Figure 3 – Front view of OCEABridge gateway
1. Power port for provided power adapter
2. WAN RJ-45 port for data transmission to Cloud
3. LAN RJ-45 port for device configuration
1
2
3

Introduction
OCEABridge User Guide Page 12
User guide
Side view (right-hand side)
You must use a Bluetooth® dongle for Bluetooth® connectivity between OCEASOFT
modules and OCEABridge.
Insert the dongle into the USB port located on the right-hand side of the gateway.
Figure 4 – USB port for Bluetooth dongle
Back/bottom
The OCEABridge gateway may be placed on a flat surface or mounted using the mounting
holes under the casing.
Figure 5 – Back/bottom view of OCEABridge gateway
USB port
Mounting
holes

Starting the gateway
OCEABridge User Guide Page 13
User guide
2Starting the gateway
There are no switches or control buttons on the OCEABridge gateway. All settings are
configured using the embedded web application.
You must use the configuration interface to determine how OCEABridge connects to the
Internet via Ethernet, WiFi, or a cellular data connection.
This section describes how to set up your OCEABridge gateway.
2.1 Prerequisites
•Internet connectivity (type depends on your needs):
oEthernet network
oWiFi network
oCellular data service
•Cloud access requires the purchase of an OCEACloud subscription for Emerald
modules. Atlas modules are activated for use on the Cloud by default.
•Network disconnection: Do not disrupt the OCEABridge gateway’s
Internet connection during use. Module data and alarms cannot be
sent to the Cloud without an Internet connection.
•Power outage:Data and alarm transmission is interrupted if the
device’s power is turned off or disconnected. We highly recommend
that you use an uninterruptible power supply (UPS). When power is
restored after an outage or disconnection, OCEABridge connects to
wireless modules within range to collect any data that may have
been missed.

Starting the gateway
OCEABridge User Guide Page 14
User guide
2.2 Plugging in OCEABridge
1. Insert the power adapter plug into the power port on the front of the device:
Figure 6 – Plugging in power cable
2. Plug the power adapter into a wall outlet to turn on your gateway. When the device
is ready for us, the green light turns on and remains on. The system LED blinks during
OCEABridge startup.
The first step in configuration is to access the OCEABridge web application from your
computer using an Ethernet cable.
1. Disconnect your computer from the regular network to avoid any IP address conflict
when connecting to OCEABridge.
2. Plug one end of an Ethernet cable into the RJ-45 LAN port on the front of the
gateway. This port is only used to configure OCEABridge using the embedded web
Interface.
Figure 7 – Inserting the Ethernet cable into the LAN port

Starting the gateway
OCEABridge User Guide Page 15
User guide
3. Plug the other end of the cable into your computer.
The WAN Ethernet connector is configured as a DHCP client by default.
If your network has a DHCP server, you may plug in a second Ethernet
cable to the WAN port and connect the other end to your network in order
to access OCEACloud immediately.
Attention: The subnet LAN interface address is 192.168.1.0/24. If your
network is also set to use 192.168.1.0/24, do not plug the WAN Ethernet
cable into OCEABridge while you are setting up the device via the LAN
connection.
2.3 Connecting to the configuration application
OCEABridge is delivered with a fixed IP address. To access the
configuration interface, the computer you are using for the connection will
automatically obtain an IP address via DHCP. That address will be within
same address range as that used by OCEABridge.
1. On your computer, use a web browser to access this address: http://192.168.1.1.
Figure 8 – Connecting to the OCEABridge configuration interface
2. Enter the default user name and password:
oUsername: root
oPassword: root

Starting the gateway
OCEABridge User Guide Page 16
User guide
2.4 Gateway properties
After you connect, OCEABridge properties are displayed on the screen:
Figure 9 – OCEABridge gateway properties
Change this information as necessary:
Local time The device’s internal clock adjusts automatically to
network time.
Host name Enter a name for your OCEABridge gateway. This
name is displayed in the upper left-hand corner of the
screen. If the WAN interface is set as a DHCP client,
this name is provided to the DHCP server. If allowed
by your network equipment, the name will also be
recorded in the domain name server (DNS), which
makes it easier to locate your gateway on the
network.
Time zone Select the time zone according to your geographical
region.
Language You may change the OCEABridge display language at
any time. Choose the language you want from the
drop-down list.

Starting the gateway
OCEABridge User Guide Page 17
User guide
2.5 Gateway settings
In the main menu, click on GatewaySettings for Cloud settings and OCEABridge gateway
operation.
Cloud server
Adjust settings for accessing the server on the Cloud Server tab:
Figure 10 – Cloud server settings
Server URL Address used by OCEABridge to access the OCEACloud
platform. The default address is www.oceaview.com.
Server port Port number used to access the OCEACloud server.
The default value is 8080.

Starting the gateway
OCEABridge User Guide Page 18
User guide
Operating mode
Click on the Operating mode tab to determine how the gateway will operate.
Figure 11 – Setting the OCEABridge operating mode
Use the Mode drop-down list to select the operating mode you want for your OCEABridge
gateway:
•Read data and send to server
By default, OCEABridge collects the data stored in data logger memory (for data
loggers within about wireless range of about 10 m / 30 ft) and sends it automatically
to the Cloud.
You may limit data reading to only include specific modules by entering their serial
numbers (located on their casing) in the List of modules to process text field, with
each serial number separated by a semi-colon (;). This white list enables you to
choose which modules OCEABridge is authorized to handle, while excluding all
others.
•Module factory reset
This operating mode restores factory settings in modules discovered by the
OCEABridge gateway.
This is controlled by the option Send latest data to server before stopping module:
oActivated: ensures that all the data stored on the module has indeed been
uploaded to the Cloud before reinitializing the module.
oDeactivated: reinitializes modules without verifying whether all the data has
been uploaded to the server.

Starting the gateway
OCEABridge User Guide Page 19
User guide
By default, OCEABridge reinitializes all discovered modules.
You may limit reinitialization only to specific modules by entering
their serial numbers in the List of modules to process text field, with
each serial number separated by a semi-colon (;). Only those
modules listed will be reset to factory settings.
The following options are common to both operating modes. You may modify them to meet
your needs:
•Fast data download: this option downloads all data from modules and uploads it
directly to the Cloud, whether or not that same information is already on the server.
This option can be particularly useful if you would like to quickly collect all the data
from a palette arriving at the warehouse.
•Send operating information to the server: specific option for diagnostic purposes,
generating detailed event logs. The log files contain information about connected
modules, including detected errors.
This option should only be activated when requested by the OCEASOFT support
team.
•Folder name for operating information: enter the name of the log file folder
provided by the OCEASOFT support team.

Wireless network management
OCEABridge User Guide Page 20
User guide
3Wireless network management
Integrating with wireless networks, OCEABridge uploads readings it collects from
OCEASOFT Bluetooth®-enabled data loggers to the Cloud for a fully wireless solution.
3.1 Connecting to a WiFi network
To connect OCEABridge™ to your WiFi network, click on Network Wireless.
The WiFi Overview screen is displayed on the screen:
Figure 12 – Wireless network detection
1. Click on the Scan button to detect nearby wireless networks.
2. Then click on Join Network to associate OCEABridge with the chosen wireless
network:
Figure 13 – List of wireless networks
1
2
2
1