Digi ConnectTank User manual

ConnectTank
Getting Started Guide
90001317_E
March 18, 2014

Digi ConnectTank Getting Started Guide
Page 2
© 2014 Digi International Inc.
All rights reserved.
Digi, Digi International, the Digi logo, a Digi International Company, the Digi web site, Digi ConnectTank
are trademarks or registered trademarks of Digi International Inc. in the United States and other countries
worldwide.
All other trademarks are the property of their respective owners.
Information in this document is subject to change without notice and does not represent a commitment on
the part of Digi International.
Digi provides this document “as is,” without warranty of any kind, either expressed or implied, including, but
not limited to, the implied warranties of tness or merchantability for a particular purpose. Digi may make
improvements and/or changes in this manual or in the product(s) and/or the program(s) described in this
manual at any time.
This product could include technical inaccuracies or typographical errors. Changes are periodically made to the
information herein; these changes may be incorporated in new editions of the publication.
No part of this document covered by copyright may be reproduced or copied in any form or by any means
graphic, electronic, or mechanical, including photocopying, recording, taping, or information and retrieval
systems without written permission of Digi International.
Disclaimer
Digi International makes no representations or warranties with respect to the contents or use of this manual,
any software drivers or associated application software provided with this product and specically disclaims
any expressed or implied warranties of merchantability or tness for any particular purpose.
Digi International reserves the right to modify or revise all or part of this document, its contents, and any
products described herein at any time without prior notication and shall not be responsible for any loss, cost
or damage, including consequential damage, caused by reliance on these materials.
Digi Technical Support Contact Information
United States: [phone] or [phone]
Other Locations: [phone] or [phone]
EMEA [phone]

Digi ConnectTank Getting Started Guide
Page 3
Safety Notices
1. Please read all instructions before installing and powering the unit. You should keep these instructions in
a safe place for future reference.
2. If the power supply shows signs of damage or malfunction, stop using it immediately, turn off the power
and disconnect the power supply before contacting your supplier for a repair or replacement.
3. Changes or modications not expressly approved by the party responsible for compliance could void the
user’s authority to operate the equipment. Use only the accessories, attachments, and power supplies
provided by the manufacturer – connecting non-approved antennas or power supplies may damage the
unit, cause interference or create an electric shock hazard, and will void the warranty.
4. Do not attempt to repair the product. The unit contains no electronic components that can be serviced or
replaced by the user. Any attempt to service or repair the unit by the user will void the product warranty.
WARNING - EXPLOSION HAZARDS
Digi International products are designed to the highest standards of safety and international standards
compliance for the markets in which they are sold. However, cellular-based products contain radio devices
that require specic consideration. Please take the time to read and understand the following guidance. Digi
International assumes no liability for an end user’s failure to comply with these precautions.
DIGI CONNECTTANK IS SUITABLE FOR USE IN CLASS I, DIVISION 2, GROUPS
D HAZARDOUS LOCATIONS, OR NONHAZARDOUS LOCATIONS ONLY.
THE UNIT CONTAINS INTERNAL BATTERIES. DO NOT OPEN EQUIPMENT
ENCLOSURE UNLESS THE AREA IS KNOWN TO BE FREE OF IGNITABLE
CONCENTRATIONS.
SUBSTITUTION OF ANY COMPONENT MAY IMPAIR SUITABILITY FOR CLASS
I, DIVISION II.
THIS MODEL UNIT SHALL BE INSTALLED ONLY TO PROCESS TANKS
CONTAINING NON-FLAMMABLE MATERIALS. BATTERY SHALL BE REPLACED
IN UNCLASSIFIED AREA ONLY. BATTERIES MUST ONLY BE CHANGED BY
DIGI or DIGI QUALIFIED TECHNICIAN.

Digi ConnectTank Getting Started Guide
Page 4
Table of Contents
Introduction to Digi ConnectTank ���������������������������������������������������������6
Digi ConnectTank Hardware Setup��������������������������������������������������������8
Digi ConnectTank Hardware Summary ........................................................................................8
Digi ConnectTank Device Installation ..........................................................................................9
Digi ConnectTank SIM Card Installation ......................................................................................9
Digi ConnectTank Wake-up Using Magnet ...................................................................................9
Digi ConnectTank Registration to Cellular Network..................................................................... 10
Uploading Digi ConnectTank Device Information to Device Cloud ............................................... 10
Digi ConnectTank Wake-up and Sleep Operation........................................................................ 11
Digi ConnectTank Management and Conguration�����������������������������12
Adding Digi ConnectTank to Device Cloud ................................................................................ 12
Digi ConnectTank Device Conguration Using Device Cloud ........................................................ 15
Digi ConnectTank Firmware Update����������������������������������������������������23
Digi ConnectTank Firmware Update Sequence ........................................................................... 23
Digi ConnectTank Online Firmware Update ............................................................................... 23
Digi ConnectTank Ofine Firmware Update................................................................................ 25
Verifying the Digi ConnectTank Firmware Update Version ........................................................... 26
Digi ConnectTank Specications and Certications ����������������������������27
Digi ConnectTank Hardware Specications ................................................................................ 27
Digi ConnectTank RF Exposure Statement ................................................................................. 28
Digi ConnectTank FCC Certications and Regulatory Information ................................................ 28
Important Digi ConnectTank Safety Information ...................................................................... 29
Digi ConnectTank Troubleshooting �����������������������������������������������������30
Digi ConnectTank Troubleshooting Resources ............................................................................ 30
Digi ConnectTank System Status LED ....................................................................................... 31
Digi ConnectTank Network Activation Troubleshooting .............................................................. 32
Digi ConnectTank Conguration Troubleshooting ..................................................................... 32

Digi ConnectTank Getting Started Guide
Page 5
Digi ConnectTank Maintenance �����������������������������������������������������������33
Appendix A: Digi ConnectTank Factory Default 34
Appendix B: Digi ConnectTank Attribute Names 35
Appendix C: Digi ConnectTank Model Specications 38

Digi ConnectTank Getting Started Guide
Page 6
Introduction to Digi ConnectTank
Digi ConnectTank offers a low cost and seamless solution to monitor remote single tank locations. It has a
proven built-in ultrasonic sensor that periodically monitors the tank liquid level and alerts the backend via
Device Cloud. Digi ConnectTank runs on internal battery and communicates through the cellular network,
thereby avoiding expensive and cumbersome cabling and maintenance.
Digi ConnectTank has the following features.
• Digi ConnectTank has a M300/150 sensor with the following specications:
◦150 kilohertz, 8 degree beam angle
◦Range of 10 centimeters to 2.5 meters (7 feet)
◦Resolution of 0.25 milimeters
• Digi ConnectTank has a M300/95 sensor with the following specications:
◦95 kilohertz, 8 degree beam angle
◦Range of 0.3 meters (1 foot) to 4 meters (13 feet)
◦Resolution of 0.25 milimeters
• Digi ConnectTank has a built-in temperature sensor.
• Digi ConnectTank comes with an internal battery with more than two-year battery life under
recommended operating conditions, such as tank liquid level measurement and pushing the measured
data to Device Cloud twice a day.
• Digi ConnectTank has six models based on cellular options. These models are described in Appendix C:
Digi ConnectTank Model Specications.
• Digi ConnectTank comes with internal cellular and GPS antennas.

Digi ConnectTank Getting Started Guide
Page 7
• Digi ConnectTank stores up to 96 sensor readings.
• Digi ConnectTank stores data in case of a network outage. Stored data is published when the network
becomes available.
• Digi ConnectTank is highly congurable, which avoids the need for custom programming and
development.
• Digi ConnectTank is easily congured and managed through Device Cloud:
◦Cellular settings
◦Device Cloud settings
◦Data collection period
◦Data reporting interval
◦Tank level alarms
• Digi ConnectTank data is transmitted using the following communication channels.
◦Data transmission using TCP/data path
◦Data transmission using SMS
• Digi ConnectTank has a failsafe OTA (Over The Air) device rmware upgrade mechanism.
• Digi ConnectTank has optional GPS for nomadic tanks.
• Digi ConnectTank has 1” NPT default mounting. 2” to 1” adaptor options are also available.
• Digi ConnectTank is UL CI D2 group D compliant.

Digi ConnectTank Getting Started Guide
Page 8
Digi ConnectTank Hardware Setup
Digi ConnectTank Hardware Summary
Cellular and GPS antenna
Gasket
Bottom cover
Ultrasonic sensor
Battery pack
Lid cover

Digi ConnectTank Getting Started Guide
Page 9
Digi ConnectTank Device Installation
Please refer to the Digi ConnectTank Quick Start Guide for installation instructions.
CAUTION: Mounting the device vertically ensures proper orientation. Cover screws are required
as part of the safety rating.
Digi ConnectTank SIM Card Installation
There is a SIM card holder in the device. Insert the SIM card into the SIM holder and lock it.
OPEN
LOCK
LOCK
OPEN
OPEN
LOCK
LOCK
OPEN
NOTE: You must install an activated SIM. The SIM card holder is installed on all versions, except the CDMA
versions.
Digi ConnectTank Wake-up Using Magnet
To wake up the Digi ConnectTank device using the magnet, follow the steps described below:
1. Bring the magnet close to the magnet sign on the Digi ConnectTank device to activate the Wake-up
button.
After several seconds, the LEDs will start blinking indicating that the device is up and running.
NOTE: Waking the device up using the magnet is the same as pressing the Wake-up button.
2. After wake-up, Digi ConnectTank sends the device conguration settings and data to Device Cloud.
)
)
)
DiGI International
www.digi.com
Battery LED Cellular LED

Digi ConnectTank Getting Started Guide
Page 10
3. After sending all conguration settings and data to Device Cloud, the device will enter sleep mode. The
device will be in sleep mode until the next scheduled wake-up or manual wake-up using the magnet.
For detailed LED sequence description, see the Digi ConnectTank System Status LED section.
Digi ConnectTank Registration to Cellular Network
Sprint Users
If you are a Sprint user, activate your module by contacting customer support and providing your ESN number.
AT&T and UMTS Users
AT&T and UMTS users should use activated SIM cards.
Verizon Users
To activate the Verizon module, use the hex ESN provided on the label and convert it using http://www.
esnconverter.com/. Use the decimal ESN in the Verizon portal.
Once your Verizon account is activated, you will need to register your device:
1. Press the Wake-up button followed.
2. Press the Factory Default button.
◦The cellular LED will blink red (2 seconds On and 2 seconds Off) until the authentication is done (ap-
proximately 10 minutes).
◦After authentication, the cellular LED will blink blue (2 seconds On and 2 seconds Off) for 30 seconds.
◦The device is now registered.
Uploading Digi ConnectTank Device Information to Device Cloud
Please follow the steps given below to register the device to Device Cloud whenever the unit is rst activated.
1. Reset the device using the Reset button, and wait for 30 seconds.
2. Press the Factory Default button to restore factory settings and register the device in Device Cloud.
3. Wait for the cellular LED to glow for 3 seconds.
NOTE: When you press the Factory Default button to upload device information to Device Cloud, the
device conguration is set to defaults.
Digi ConnectTank Cellular and GPS Antenna
Digi ConnectTank has internal antennas for cellular and GPS communications. There are no external antennas
required to operate the device. While installing the device, make sure that there is adequate network coverage
in the area by ensuring that the cellular LED is blinking blue. Good network coverage will help in reducing the
power consumption of the device, leading to improved battery life.
Unauthorized antenna modications and attachments will invalidate de and may violate local RF emission
regulations.

Digi ConnectTank Getting Started Guide
Page 11
Digi ConnectTank Wake-up and Sleep Operation
Digi ConnectTank is intended to run from the internal battery for two years under recommended operating
conditions. To achieve such an extended period of operation, Digi ConnectTank enters into sleep mode for the
maximum amount of time, thus reducing the power consumption to the lowest possible levels. The device
wake-up and subsequent operation is as follows:
• First time power-up/battery power connection: The device powers up, detects the battery and
then goes into sleep mode.
• Factory Default button: When you press the Factory Default button, the device performs the
following functions:
◦Sets the device conguration to defaults.
◦Sets the device time.
◦Uploads device information to Device Cloud.
• Manual device wake-up by user: Use the Wake-up button wake up the device from sleep. If the
enclosure is closed, you can use the magnetic sensor to wake up the device. On pressing the Wake-up
button or activating the magnetic switch, the device performs the following functions.
◦Sends a diagnostic record to Device Cloud with the following device information:
• Sensor connect status
• Measured distance reading
• Measured temperature reading
• GPS location (optional, based on conguration)
• Battery voltage (the current battery percentage remaining)
• Device congurations
• Cellular signal strength
◦Battery and network status LEDs glow indicating their respective functionalities. See the Digi Connect-
Tank System Status LED section for more information on the system status LED sequence.
◦The device then enters sleep mode.
• Timed wake-up for data acquisition and reporting: The device wakes up as per conguration
parameters to perform the following functions:
◦Monitor the tank liquid level
◦Report data to Device Cloud
◦Check for new conguration le from Device Cloud
◦Check tank level alerts
◦Check low battery alert
NOTE: Two year battery life assumes reading and reporting the tank levels twice a day. Battery life may be
signicantly shortened by reducing the interval, or lengthened by increasing the interval.

Digi ConnectTank Getting Started Guide
Page 12
Digi ConnectTank Management and
Conguration
This chapter describes conguration settings for Device Cloud.
Adding Digi ConnectTank to Device Cloud
Device Cloud is an on-demand service with no infrastructure requirements. Remote devices and enterprise
business applications connect to Device Cloud through standards-based web services.
Note that for initial test and development with the Digi ConnectTank, you can use a developer account. When
deploying Digi ConnectTank devices in the eld, you will need a premiere account to use all the features of
Digi ConnectTank.
For details on using Device Cloud as a management interface, see the Device Cloud User’s Guide.
To congure your Digi ConnectTank device to utilize Device Cloud, follow these steps:
1. Navigate to login.etherios.com.
2. To log in:
a. If you already have a Device Cloud account, log in with your existing user name and password.
b. If you are a new user, click the Are you a new user? link and follow the on-screen instructions to create
an account.
3. Once logged in, select the Devices menu from the Device Management tab.
4. On the top left of the page click Add Devices within to open the Add Devices page. On the Add
Devices page, click the Add Manually button.
Note that you cannot use the Discover button to discover your devices automatically, as they are not available
on the local network.
5. Enter the device number of your device into the eld provided. The device number is either Device ID#
or the IMEI#, depending upon your device model.

Digi ConnectTank Getting Started Guide
Page 13
NOTE:
◦For a CDMA device, select the Device ID from the drop down menu. For a UMTS device, select the
IMEI number from the drop down menu.
◦For a CDMA device, the device ID format is 00020000-00000000-00000000-XXXXXXXX. The 8 digit
ESN number is printed on the device label. For example, if the printed ID is 6C4A21EA, enter it using
the Device ID eld as 00020000-00000000-00000000-6C4A21EA.
◦For a UMTS device, add zero as the sufx of the IMEI number (format: XXXXXXXXXXXXXX0). For ex-or ex-
ample, if the IMEI number is 35642304400092, enter it using the IMEI eld as 356423044000920.
6. Click Add.

Digi ConnectTank Getting Started Guide
Page 14
7. Click OK.
The device is now connected as shown in the following image. In the following illustration, the smaller
circle highlights the device connection status indicator. The color of the indicator is blue when the device is
connected. When the device is disconnected, the color of the indicator turns red. Note that the connection
status is typically disconnected since the device is usually in sleep mode.
The larger circle highlights the device type, such as ConnectTank-MR, where MR stands for mid range sensor.
In ConnectTank-SR, SR stands for short range sensor.
CAUTION: Before completing the installation, make sure the Tank Upload Method matches your
cellular contract. Note that allowing SMS fallback on a cellular contract with a limited number of
SMS could lead to a high bill. Contracts that are SMS only should not allow TCP fallback.

Digi ConnectTank Getting Started Guide
Page 15
Digi ConnectTank Device Conguration Using Device Cloud
1. Double click the Devices ID to access device congurations.
NOTE: Conguration and Connection History tabs appear on the Home page.
2. To access conguration, expand the Conguration tab. The available conguration groups are:
◦Alarm Settings
◦Cellular Settings
◦Device Cloud Settings
◦Device Settings
3. Click the individual group to view congurable parameters of the particular group.

Digi ConnectTank Getting Started Guide
Page 16
Congurable Parameters Related to the Device Settings Group
The following table describes the congurable parameters of the Device Settings group.
Name Description Range Default
Read sensor every Based on this parameter
value, sensor reads liquid
level every x minutes.
15 minutes to 1440
minutes (24 hours)
720 minutes (12 hours)
Report sensor data
every
Based on this parameter
value and the Read
sensor every parameter
value, device publishes
data to Device Cloud.
Example: Read sensor
= 15 Report sensor =4
Sensor reading will be
published to Device Cloud
every 1 hour (15 minutes
x 4 times).
1 to 672 readings
Note: The sensor can
only store 96 readings.
Setting this value above
96 will lead to lost data.
1
First daily report at
HHMM
A value of 60 would be 1
hour after midnight GMT
(minutes from midnight
GMT).
0 to 1439 (minutes) 0
Send last Sends number of latest
readings. A value of 1
means only send the last
reading. This parameter
value must be less than
the Report sensor data
every value.
1 to 96 readings 1

Digi ConnectTank Getting Started Guide
Page 17
Name Description Range Default
Send location every Based on this parameter
value, the device sends
location data after every
set number of report
intervals.
1 to 96 readings 1
Tank upload method Mode of communication
from device to Device
Cloud.
0 - TCP/IP only
1 - SMS only
2 - TCP/IP with SMS
fallback
3 - SMS with TCP/IP
fallback
TCP/IP with SMS fallback
GPS enable Based on this setting,
location data collection is
enabled or disabled.
Off/ On Off
Waveform collection Based on the waveform
setting, data is collected
every report interval.
Note: Enabling this
parameter increases your
cellular data usage and
should only be used for
debugging purposes.
Waveform collection does
not work if you have set
the Tank upload method
to SMS only.
This should be turned
OFF when upgrading
Microcontroller code via
Device Dloud.
Off/ On Off
Last Reported UTC
time in YYYY-MM-
DD HH:MM:SS
Set date and time on the
device.
Note: Your device’s time
and date should be
updated automatically
from the network. You
typically do not need to
set this parameter.
1970-01-01-00:00:00
NOTE: Report Interval = Read sensor every x Report sensor data every.

Digi ConnectTank Getting Started Guide
Page 18
Device Cloud Settings Group Parameters
CAUTION: Device Cloud settings should not be changed without Digi Technical Support.
Name Description Value
Phone Number SMS will be published to this
number
43444
Service ID Blank if phone number is 43444;
IDGP if phone number is 32075
Server Name Device Cloud server name login.etherios.com
Cellular Settings Group Parameters
Name Description Value
APN Access Point Network of the
service provider.
Applicable only for UMTS devices.
apn.idigi.com

Digi ConnectTank Getting Started Guide
Page 19
Name Description Value
User name User name of the service provider
for data connectivity. This is
not required by most cellular
providers.
Password Password of the service provider
for data connectivity. This is
not required by most cellular
providers
Alarm Settings Group Parameters
NOTE: When you hover the mouse over the ? synmbol, help text pops up to provide more information on
the particular parameter.

Digi ConnectTank Getting Started Guide
Page 20
Name Description Range Default
High Alert When set to On, the device sends an alert when
liquid level is above the high threshold.
On/ Off Off
High Threshold This value indicates when to generate a high alert. 0.0-511.0 511.0
Low Alert When set to On, the device sends an alert when
liquid level is below the low threshold.
On/Off Off
Low Threshold This value indicates when to generate a low alert. 0.0 - 511.0 0.0
Delta Low Alert When set to On, the device sends an alert if the
liquid level decrease rate is more than delta low
threshold on consecutive read intervals.
On/Off Off
Delta Low Threshold This value indicates when to generate a delta low
alert.
0.0-511.0 511.0
Delta High Alert When set to On, the device sends an alert if
the liquid increase rate is more than delta high
threshold on consecutive read intervals.
On/Off Off
Delta High
Threshold
This value indicates when to generate a delta high
alert.
0.0-511.0 511.0
Hysteresis High alert does not retrigger until the liquid level
decreases below the difference between hysteresis
value and High Threshold values.
Low Alert does not retrigger until liquid level
increases above the difference between hysteresis
value and Low Threshold values.
1.0
Battery voltage Percentage at which the device generates a low
battery alert.
75-100 75
After changing the alarm settings, you can save or schedule the conguration.
1. Click Save to save the conguration in the device immediately if the device is connected.
2. Click Schedule to congure the device when it is not connected. This is the preferred way of
conguring since the device will be in sleep mode most of the time.
Selecting the Schedule Ofine checkbox allows the command to be executed for a device that is ofine.
NOTE: If a device becomes disconnected from Device Cloud for any reason during the execution of this
command, Device Cloud will retry the command when the device reconnects.