EmeraldView

EmeraldView
EmeraldView™
Emerald software and
wireless module user guide
Notices
Battery warning
OCEASOFT Emerald products contain a non-rechargeable lithium battery. Make sure you
observe polarity (+/-) when inserting batteries into Emerald devices. Reversing polarity by
inserting the batteries incorrectly can cause the product to heat up and may lead to a
battery liquid leak. Use only batteries recommended by OCEASOFT. Battery life depends on
target temperatures. Removing the battery erases data contained in module memory. See
Appendix 1 for more details on battery life.
FCC statements
This device complies with Part 15 of the FCC Rules. Operation is subject to the following two
conditions:
(1) This device may not cause harmful interference.
(2) This device must accept any interference received, including interference that may
cause undesired operation.
FCC RF Radiation Exposure Statement:
This equipment complies with FCC radiation exposure limits set forth for an uncontrolled
environment. End users must follow the specific operating instructions for satisfying RF
exposure compliance. This transmitter must not be co-located or operating in conjunction
with any other antenna or transmitter.
IC Statements
This device complies with Industry Canada license-exempt RSS standard(s). Operation is
subject to the following two conditions: (1) this device may not cause interference, and (2)
this device must accept any interference, including interference that may cause undesired
operation of the device.
Under Industry Canada regulations, this radio transmitter may only operate using an
antenna of a type and maximum (or lesser) gain approved for the transmitter by Industry
Canada. To reduce potential radio interference to other users, the antenna type and its gain
should be so chosen that the equivalent isotropically radiated power (e.i.r.p.) is not more
than that necessary for successful communication.
2 | Getting started
CE
OCEASOFT Emerald (Bluetooth component BLE112-A) is in conformity with the essential
requirements and other relevant requirements of the R&TTE Directive (1999/5/EC). The
product is conformity with the following standards and/or normative documents.

EMC (immunity only) EN 301 489-17 V.1.3.3 in accordance with EN 301 489-1
V1.8.1

Radiated emissions EN 300 328 V1.7.1

Safety EN60950-1:2006+A11:2009+A1:2010+A12:2011
KCC (Korea)
OCEASOFT Emerald (Bluetooth component BLE112-A) is KCC certified with following
certification number:

KCC-CRM-BGT-BLE112-A
© 2015 OCEASOFT S.A. All rights reserved. OCEASOFT, the OCEASOFT logo, OCEASOFT
Emerald, and OCEASOFT EmeraldView are the exclusive property of OCEASOFT. All other
brands mentioned are the property of their respective owners. . iPhone and iPad are
trademarks of Apple, Inc., registered in the U.S and other countries. Android is a trademark
of Google Inc. The Bluetooth® word mark and logos are owned by the Bluetooth® SIG, Inc.
Specifications subject to change without notice. Mobile device not included. Images are noncontractual.
March 2015
Ref: ING-INS-130-EN
Rev 01
Getting started | 3
Contents
Getting started................................................................................................ 6
Introduction ................................................................................................ 6
About iOS® and Android® versions of this application ............................... 7
Main application features........................................................................... 7
Inserting the battery ................................................................................... 8
Install EmeraldView on your smartphone or tablet ................................. 10
Using the magnet ..................................................................................... 12
Using EmeraldView ....................................................................................... 14
EmeraldView home screen ....................................................................... 14
Scanning for nearby Emerald modules ..................................................... 15
Configuring missions..................................................................................... 17
Setting up Cloud access ............................................................................ 18
Assign cloud account in EmerldView ........................................................ 18
Starting a new mission.............................................................................. 19
Selecting the start mode .......................................................................... 21
Setting high and low limits ....................................................................... 22
Password-protection ................................................................................ 23
Viewing a currently-running mission ........................................................ 26
Saving and sending data from the current mission .................................. 28
Looking up data from previous missions .................................................. 29
Settings ......................................................................................................... 30
Monitoring with Watch Mode (iOS only) ..................................................... 31
Requirements for using Watch Mode with an iOS device ........................ 31
Watch Mode settings ............................................................................... 32
4 | Getting started
Appendix 1 – Battery considerations ........................................................... 34
Emerald -20°C to +60°C and -200° to +200°C modules ............................ 34
Emerald -40°C to +85°C modules ............................................................. 36
Appendix 2 – Advanced module settings ..................................................... 38
Getting started | 5
Getting started
Welcome to the OCEASOFT EmeraldView application for
smartphones and tablets. This guide shows you how to use the
software to configure, read, and manage your OCEASOFT Emerald
temperature monitoring modules.
Introduction
Emerald is a Bluetooth® Smart enabled module that records ambient
temperature at regular intervals and stores the information in its memory.
This type of device is also known as a datalogger.
The EmeraldView application on your smartphone enables you to read the
device wirelessly via Bluetooth at any time. You may also choose to upload
the information to the Cloud* where other people can access it.
* Requires OCEACloud subscription and EmeraldView PC
desktop application for configuration.
Emerald
temperature tracker
6 | Getting started
About iOS® and Android® versions of this application
This User Guide describes the EmeraldView application for
supported iOS® and Android® devices. All features are identical
with the exception of Watch Mode, which is only supported on
iOS devices at this time. You will see a note mentioning “For iOS
only” where applicable.
Main application features

Monitor temperature-sensitive goods during shipment and view
temperature readings stored on your Emerald modules

Program high and low temperature limits, read frequency, and delays

Replicate data in secure Cloud storage*

Map read locations using your device’s location services

An easy solution for monitoring temperature in packages, refrigerated
trucks, laboratories, storage facilities, and more

Supports Bluetooth Smart, with a wireless range of approximately 30
meters (98 feet)
For iOS only:
 Monitor your modules continually using Watch Mode for timely alerts
* Requires OCEACloud subscription and EmeraldView PC desktop application
for configuration.
Getting started | 7
Inserting the battery
To get started, first insert the battery into your Emerald module.
-20°C / +60°C and -200° / +200°C (Pt100) modules
The Lithium
battery is
provided in the
product box.
Unscrew the
three screws
on the back of
the module
(turn counterclockwise).
Remove the
screws.
Place the
battery in the
slot, with the
plus sign (+)
facing up.
Replace screws
(turning them
clockwise).
Ensure that the
rubber seal is
well seated.
That’s all.
Your module
is now ready
to use.
Inserting the battery in your Emerald
-20°C / +60°C and -200° / +200°C (Pt100) modules
8 | Getting started
-40°C / +85°C modules
The Lithium
battery is
provided in the
product box.
Unscrew the
three screws
on the back of
the module
(turn counterclockwise).
Remove the
screws.
Place the
battery in the
slot, making
sure to
respect
polarity.
Replace screws
(turning them
clockwise).
Ensure that the
rubber seal is
well seated.
That’s all.
Your module
is now ready
to use.
Inserting the battery in your Emerald
-40°C / +85°C modules
Getting started | 9
Install EmeraldView on your smartphone or tablet
You may download and upgrade EmeraldView using your mobile device
directly. After installing the application, you will be notified automatically
when upgrades are made available.
There are two ways to proceed with installation.
Option 1: use QR code to access the OCEASOFT site
1. To go to the OCEASOFT web site, you may use your mobile device
to scan the QR code provided on the back of your Emerald module
or on the product box.
Scan QR code links to open the
OCEASOFT application download page
2. Scroll down to the EmeraldView application link and tap to
proceed with the download via the appropriate online store.
On the OCEASOFT site, you will also find EmeraldView PC, the
Windows companion application for your mobile software.
EmeraldView PC enables you to view data stored by your mobile
device on the Cloud and to manage the vouchers needed for
Cloud access.
10 | Getting started
Option 2: access online stores directly
iOS
Android
For iOS devices, tap on
the App Store icon on
your device:
For Android devices,
tap on the Play Store
icon on your device:
Alternatively, you may open
the Apple App Store web site
directly and download the
application via iTunes.
Alternatively, you may
install the application via
Google Play web site.
1. Search for “EmeraldView” on the appropriate store page.
2. Select the OCEASOFT EmeraldView application to proceed with
installation.
3. Login to your account (or create one) and follow the installation
instructions.
4. When installation is complete, tap on the
EmeraldView icon to open the application on
your smartphone or tablet.
EmeraldView
application icon
Getting started | 11
Using the magnet
Emerald includes a magnet that
can be used both for mounting
the module onto a magnetic
surface, and to trigger selected
actions.
The provided magnet has a
“weak” and a “strong” side. The
metal ring is close to the edge
on the “weak” side of the magnet.
The deeper recess on the other side
indicates “stronger” side.
Metal ring close to the edge on
magnet’s “weak” side. Deeper
recess indicates “stronger” side.
Mounting Emerald with the magnet
You may fix the magnet to a metallic wall or insert a screw to fix it onto
other types of surfaces. Simply place the module onto the magnet as shown
below:
Mount Emerald on magnet
12 | Getting started
Starting a mission with the provided magnet
You may trigger the start of a mission by mounting the module on the
magnet (typically screwed into a wall or placed onto a magnetic surface).
Enable this option in EmeraldView  New Mission  Start mode  On
contact with magnet
Use the magnet to check Emerald status
You may also hold the magnet over an Emerald module to check its status.
Face the magnet’s “strong” side towards the module to do this. The
magnet’s presence causes the LED on the front of the module to blink as
follows (identically to the software button Blink LED to identify module in
EmeraldView):
Blue
New, not programmed
Blue/Red
Module en mission (Collecte non démarrée)
Green
On a mission, no alarm
Red
Currently in alarm state
Green / Red
Datalogging on, at least one alarm recorded
Check status by holding
magnet over module
Getting started | 13
Using EmeraldView
EmeraldView home screen
The home screen shown here opens
when you first start the application. The
colored zones indicate where to tap to:
1. Scan the area for nearby Emerald
modules (Bluetooth must be
activated on your smartphone). If
Bluetooth is not activated, you will be
prompted to turn it on.
2. Run EmeraldView in demonstration
mode without actually connecting to
any modules.
EmeraldView home
screen (upon first start)
The four tabs, Scan, History, Settings, and
About, are present throughout the
application, and are described in
detail in the following sections.
Note: The first time you launch EmeraldView, the
application will request your authorization to access
geolocation features. If you would like to include details
location information with your readings, you must allow
access.
14 | Using EmeraldView
Scanning for nearby Emerald modules
On the Scan tab, tap the scan/refresh icon to discover and list the Emerald
modules within range.
The icon colors are as follows in this
mode (referred to as “Discovery
mode”):
Indicates a programmed
module that has not
exceeded its limit values
during the current
mission (no alarms).
Indicates a programmed
module on which one or
more alarms have been
detected during the
current mission.
Indicates an idle module
(not running, ready-touse).
List of Emerald modules
after scanning
Module signal strength
Tap anywhere on one of these lines to manage the selected Emerald
module and access module details.
Using EmeraldView | 15
Returning to the home screen
Press the Back button if you want to
return to the previous screen in the
application.
Blink module LED
When several Emerald modules are
present, you might not always know
which one you are working with in
EmeraldView. If you are unsure,
simply tap on Blink LED to identify
module, and a light on the front of
the module will blink for a few
seconds.
The LED blinks different colors
depending on the module’s status
Accessing and configuring
your module
Blue: New, not programmed.
Green: On a mission, no alarm.
Red = Currently in alarm state.
Green / Red = Datalogging on, at
least one alarm recorded.
On-demand reading
Click on Read current temperature to display the ambient temperature
where the Emerald module is located.
16 | Using EmeraldView
Configuring missions
One of the main features about Emerald is its ability to record temperature
data intelligently (datalogging) during “missions.”
To begin datalogging, you must create a mission for the module.
A mission is a set of configuration options that apply to an Emerald module.
Mission parameters include:
1. A name for the module and how often temperature is read
2. How and when the module should begin tracking data
3. High and low alarm limits
4. Whether or not data should be pushed to the Cloud
5. Password protection to stop a module currently on a mission
Configuring missions | 17
Setting up Cloud access
Before using this feature, you must create one or more Cloud
users with the EmeraldView PC application (available free of
charge on www.oceasoft.com/obt).
EmeraldView PC requires you to enter a voucher number to
grant access to a specific number of Emerald modules for a
specific period of time. Please contact your sales representative
for more information on vouchers.
After setting up your OCEASOFT Cloud account and ID, you may use your
mobile device to push Emerald data to the Cloud so that other users may
access it over the Internet from the EmeraldView PC application.
Assign cloud account in EmerldView
For the mission use the Cloud, the person programming or stopping a
mission must configure Cloud access information in EmeraldView. Other
users reading the Emerald module, for example at intermediary locations
during the mission, may remain “anonymous” and do not need to be taken
into consideration when setting up the mission.
Assign the Cloud account to your mobile device (one account per device):
1. In Settings  Cloud account,
enter the same Email address and
Password that you configured in
EmeraldView PC for your Cloud
account.
2. Tap on Assign
3. Proceed with Starting a new
mission (next page).
18 | Configuring missions
Starting a new mission
to
1. In the Home screen, tap
refresh the list of Emerald modules.
You may define and start a mission
.
for modules with a gray icon
Red or Green icons indicate that the
module is already on a mission.
2. Tap to select the module you want
to configure  Set up new mission
3. Fill in the information on the
General tab (shown here).
Load a template
You may load an existing mission template (if there
are any) by tapping in the field and choosing a name
from the pull-down list.
Module name
Enter a name to use for the module during this
mission (up to 18 characters). This name is
displayed throughout the application when
referring to the module.
General mission settings
Configuring missions | 19
Reading interval
Set the frequency with which the module reads and
records temperature from its sensor. Choose values
in minutes or seconds by tapping on the minutes
field.
Note: To activate Low/High delays in the Alarms
tab, Reading interval must be set in minutes (see
below).
Datalogging…
Up to 4,000 readings can be stored in module
memory. To continue datalogging after this limit is
reached, the oldest readings can be overwritten by
new readings if you select Datalogging in
continuous loop. Otherwise, datalogging stops
when the limit of 4,000 readings is reached.
Save as template
When you are done adjusting the settings, you may
tap on Save as template at the bottom of the
screen if you want to save the current mission as a
template for future use.
20 | Configuring missions
Selecting the start mode
There are several ways to start
datalogging on your Emerald module,
depending on your needs.
Adjust the following options in the Start
mode tab as necessary. All options
other than Immediately may be
combined for use together.
Immediately
Datalogging begins when the module
receives its programming information.
Delayed for…
Datalogging begins after the specified
number of minutes (after mission has
started). Tap in the field to change the
number.
Mission start options
On contact with magnet
Datalogging begins when the Emerald module comes into contact with its
magnet. For example, you could start datalogging when you mount the
Emerald on a magnet installed in a refrigerated truck.
Temperature below/ Temperature above
Datalogging begins when Emerald module detects the specified
temperature (one or the other). This is useful for automatically starting
datalogging when the module is placed in the environment to be
monitored, such as in a cooler when it is ready for transportation.
Configuring missions | 21
Setting high and low limits
If you would like to ensure that the
temperature in the container or
environment you are monitoring
remains within a specific range, you
may set high and low limits in the
Alarms tab.
The default values in the fields show the
module’s available temperature range.
Tap on checkboxes to enable options
and in fields to adjust settings.
Low limit: the lowest acceptable
temperature reading.
High limit: the highest acceptable
temperature reading.
Low delay: how long the reading is
lower than the Low limit (multiple of
the reading interval, in minutes only).
High and low temperature
range limits
High delay: How long the reading is
higher than the High limit before
triggering an alarm (multiple of the
reading interval, in minutes only).
Alarm condition indicated
by red icon
If an alarm conditions arises at any
point since the start of the mission, the module shows an alarm on the
home screen (unless Watch Mode is activated. See Monitoring with Watch
Mode, page 31).
22 | Configuring missions
Note: High delay and Low delay appear when the Reading interval is set in
minute.
Password-protection
EmeraldView enables you to assign a
password to prevent other users from
stopping an Emerald module that is
currently on a mission. To do this, tap
on the Security tab.
Password required to stop mission:
requires a user to enter the password
configured here to stop this mission
after it has been started.
Important: If you forget your
password, please contact OCEASOFT
technical support.
Protecting Emerald mission
with a password
Tap in the Password field to enter the
password. The checkbox to the right of
this field shows or hides the password
characters.
Configuring missions | 23
Pushing mission data to the Cloud
To push Emerald data to the Cloud during a mission, you must
have assigned your Cloud ID and password in Settings, as
mentioned earlier).
To push Emerald data to the Cloud:
1. Tap on the Cloud tab
2. Select Use Cloud for this mission
Data is pushed by your mobile device at
specific moments:

When datalogging starts

When the module is read during
the mission

When the mission ends
Pushing data to the Cloud
upon mission start, read,
and stop
Use the EmeraldView PC application for Windows to configure Cloud access
and view module data from your computer.
24 | Configuring missions
Starting the mission
After you have finished defining the various settings in General, Start
mode, Alarms, and Security, you may save this configuration as a template
for future use if you want (return to the General tab).
to transmit your settings to the module. A
Then tap on
confirmation message is displayed in EmeraldView and the module is
displayed with a green
icon on the Home page (or red
module already has an alarm).
if the
Configuring missions | 25
Viewing a currently-running mission
General information
When a module is activated and
configured for a mission, you may view,
store, and email various details.
1. Tap on the module name in the
home screen  Show current
mission.
2. General information about the
mission is displayed.
3. You may tap on Stop to terminate
the mission if appropriate.
Access detailed information and maps
Tap on Mission details for more
complete information regarding the
Emerald module on its mission. If the
Cloud option is activated for the mission:
Summary of current mission
1. When you tap on Mission details, data is pushed to the Cloud before
refreshing the screen. Any user in the field can push data to the Cloud,
even if no Cloud account is assigned in that user’s EmeraldView
application. This “anonymous” push enables people reading the module
at remote locations to update the data on the Cloud without
configuring their application.
2. If you tap on Stop, the module must be linked and connected to your
Cloud account, and the Cloud account configured in the application.
26 | Configuring missions
Graph
Tap on the graph tab to see a
summary graph of the readings in
the current mission.
Zoom in by swiping diagonally (left
to right) with your finger anywhere
in the graph. Zoom out by swiping
diagonally right to left.
Data
For a list of all the
readings, events, and
alarms related to the
current mission, tap on
Data.
Map
If the option Location
Services is enabled on
your iPhone (Settings
 Restrictions), the
location is stored when
EmeraldView reads the
Emerald module.
Tap on Map to view a Google Map
showing the locations at which the
Configuring missions | 27
Emerald module was programmed, read, and stopped.
Saving and sending data from the current mission
You may save or store data at any
time during a mission by tapping
icon.
on the
Save in memory: saves up to five
missions in your smartphone’s
memory. If you save the current
mission more than once, an
additional line is added to the list.
Send by email: sends all stored readings and the graph from the current
mission to an email address that you specify. This action requires email
functionality and Internet (or Wi-Fi) access to be operational on your
smartphone.
28 | Configuring missions
Looking up data from previous missions
Tap on History to see stored
information from Emerald missions.
Configuring missions | 29
Settings
The Settings tab contains various
options for configuring EmeraldView
behavior.
Temperature unit: choose to display
values in Celsius (°C) or Fahrenheit
(°F).
Show data with GMT time: data is
always stored using GMT time. This
option lets you display the data with
GMT time or the smartphone’s
current local time.
Show wireless signal strength:
Enabling this option displays signal
strength (in %) in the module list on
the home screen.
Prompt to save after viewing mission
details: when viewing mission details (tap module in home screen  Show
current mission  Mission details), current data is downloaded
temporarily to your smartphone for display purposes. You may save it or
send it by email if you want. This option simply serves to remind you at that
time.
30 | Settings
Monitoring with Watch Mode (iOS only)
With iOS devices, EmeraldView’s Watch
Mode enables you to monitor Emerald
modules on an ongoing basis, and
upload the data to the Cloud
automatically. When activated, Watch
Mode displays the latest reading for all
modules within range.
Requirements for using Watch
Mode with an iOS device
1. The Emerald module must be
programmed, with datalogging
active. Modules that are not on a
mission do not monitor
temperature and therefore are not
applicable to Watch Mode
2. The EmeraldView application must remain in the foreground on your
iOS device (it must be the active application).
3. Autolock must be turned off on your iPhone so that EmeraldView stays
open in order to scan nearby Emerald devices.
Monitoring with Watch Mode (iOS only) | 31
Watch Mode settings
Automatic start: not available
Manual start: enables you to
activate Watch Mode from the Scan
tab. With this option selected, an
ON/OFF button is displayed on the
Scan screen.
Slide the button to the right to activate Watch Mode (
).
Disabled: Watch Mode is disabled by default. Tap on Manual start to
activate this function.
With Watch Mode activated, the
latest temperature reading is
updated once per minute and
displayed in the list on the Scan tab.
When Watch Mode is activated, the colored icons on the Scan tab have a
slightly different meaning than for “Discover mode.”
Indicates a programmed module whose last-read value has not
exceeded its limit value (not currently in an alarm state).
Indicates a programmed module whose last-read value has
exceeded its limit value (currently in an alarm state).
EmeraldView plays an alarm sound once a minute, for several
seconds, if the latest reading on one or more Emerald modules
has exceeded a programmed limit.
32 | Monitoring with Watch Mode (iOS only)
Indicates either a non-programmed module or one on which
there was an error reading the sensor (i.e. the current reading
is not available). The text beneath the module name shows the
status (“Not started” or “Last reading N/A”).
Pushing readings to Cloud automatically
If you selected Use Cloud for this
mission, the latest readings in the
module memory is uploaded to the
Cloud at the interval you specify in
Automatic Cloud push interval.
Your mobile device must be
connected to the Internet to push
data to the cloud. Also, a valid
Cloud user e-mail and password
must be entered in Settings 
Cloud account
Testing the alarm sound
You may test the alarm sound be tapping on the Test button. The alarm
sounds for approximately 8 seconds, enabling you to adjust the volume as
necessary.
Monitoring with Watch Mode (iOS only) | 33
Appendix 1 – Battery considerations
Emerald module battery life varies with the ambient temperature,
and thus varies with the different available models. Generally
speaking, batteries last less long in colder environments. This
information provides some general battery information.
Emerald -20°C to +60°C and -200° to +200°C modules
Note: these two modules use the same battery and thus
exhibit the same performance with respect to duration.
Battery specifications:
Diameter (A):
min 0.95 in (24.2 mm)
max 0.96 in (24.5 mm)
Height (B):
min 0.18 in (4.6 mm)
max 0.2 in (5.0 mm)
Type Number:
6450
IEC designation: CR2450
System:
Li-Manganese dioxide
/ Organic Electrolyte
The chart below shows estimated battery life (in weeks) at various
temperatures for these two modules, with the temperature
representing the module’s operating (ambient) temperature.
34 | Appendix 1 – Battery considerations
This information is based on one data download per day (regardless
of the number of sensor readings recorded during that day).
Weeks
Battery life estimation for -20°C to +60°C and
-200° to +200°C modules
Appendix 1 – Battery considerations | 35
Emerald -40°C to +85°C modules
Battery specifications:
Diameter (A):
min 0.55 in (14 mm)
max 0.55 in (14.6 mm)
Height (B):
min 0.95 in (24.1 mm)
max 0.99 in (25.1 mm)
Shoulder Diameter [L]:
min 0.16 in (4.1 mm)
max 0.18 in (4.5 mm)
Shoulder Height [M]:
min 0.03 in (0.8mm)
max 0.05 in (1.2 mm)
Type Number:
ER 1/2 AA
CEI designation: 14250
System:
Primary Li-Thionyl
Chloride / LiSOCI2
36 | Appendix 1 – Battery considerations
The chart below shows estimated battery life (in weeks) at various
temperatures for this module, with the temperature representing the
module’s operating (ambient) temperature. This information is based
on one data download per day (regardless of the number of sensor
readings recorded during that day).
Weeks
Battery life estimation for -40°C to +85°C module
Appendix 1 – Battery considerations | 37
Appendix 2 – Advanced module settings
Several advanced options are
available from the Module details
screen by tapping on the More
button.
Radio tools
To see the Emerald module’s battery
level, tap on Get Current. To reset
the counter to 100% (only after
changing the battery), tap on Reset.
To see wireless signal strength or the
module’s firmware version, tap on
the appropriate Get Current
buttons.
38 | Appendix 2 – Advanced module settings
Settings
You may view the current A and B
calibration parameters of your Emerald
module by tapping on Get current.
To protect the Emerald module from
unwanted programming, you may
protect it with a password.
4. Tap on Enable to enter a password.
5. Tap on Disable to remove the
password.
Advanced
You must contact technical support to
use these options. They enable you to
unblock and/or completely reset your
Emerald module.
Appendix 2 – Advanced module settings | 39
40 |
www.oceasoft.com | support@oceasoft.com
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF

advertising