background image

Digi ConnectTank Getting Started Guide

Page 39

Long Name

Short name

Comments/Semantics

Alarm enable mask (8 bits)

aem

Enable bit for various alarms from LSB to MSB 

(1 is enabled)
0 - Alarm high enable - alh
1 - Alarm low enable - all
2 - Alarm delta low enable - adl
3 - Alarm delta high enable - adh
4-7 - Reserved for future use 

Alarm hysteresis

ahy

-/+ ahy from high/low alarms respectively.  

Alarms high and low do not retrigger until 

condition is not true for 1 reading outside of 

hysteresis.  

Alarm reason mask (8 bits)

arm

Bits from LSB to MSB (1 means the alarm was 

tripped):
0 - Alarm high 
1 - Alarm low 
2 - Alarm delta low 
3 - Alarm delta high 
4 - Manual upload
5 - Low battery alert
6-7 - Reserved for future use 

Alarm battery

abt

Send battery channel alarm, when battery <= 

abt
Default to 75 (75%)

Hardware version (e.g., PCB version)

hwv

String that returns the hardware version. 

Firmware version (e.g., PIC code version)

fwv

Recommend major.minor.maint.build (for 

example, 1.0.0.101).

Software version (e.g., Digi BREW code 

version)

swv

Recommend major.minor.maint.build (for 

example, 1.0.0.101).

SMS version

smsv

SMS extension version. Recommend major.

minor.maint.build (for example, 1.0.0.101).

I2C version

i2cv

I2C extension version.  Recommend major.

minor.maint.build (for example, 1.0.0.101).

GPS feature

gps

GPS ON/OFF feature.
0 – GPS Off, 1 – GPS On.

POSIX time

tim

Set current POSIX time. 
Epoch time from Jan 1 1970 (in seconds).

Summary of Contents for ConnectTank

Page 1: ...C o n n e c t Ta n k Getting Started Guide 90001317_E March 18 2014 ...

Page 2: ...ally 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 make...

Page 3: ...d 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 specific consideration Please take the tim...

Page 4: ...nectTank Device Configuration Using Device Cloud 15 Digi ConnectTank Firmware Update 23 Digi ConnectTank Firmware Update Sequence 23 Digi ConnectTank Online Firmware Update 23 Digi ConnectTank Offline Firmware Update 25 Verifying the Digi ConnectTank Firmware Update Version 26 Digi ConnectTank Specifications and Certifications 27 Digi ConnectTank Hardware Specifications 27 Digi ConnectTank RF Expo...

Page 5: ...tTank 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 Specifications 38 ...

Page 6: ...fications 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 specifications 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 ...

Page 7: ... 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 firmware upgrade mechanism Digi ConnectTank has optional GP...

Page 8: ...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 ...

Page 9: ...st 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 tha...

Page 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 first activated 1 Reset the device using the Reset button and wait for 30 seconds 2 Press the Factory Def...

Page 11: ...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 configuration Battery voltage the current battery percentage remaining Device configurations...

Page 12: ...rface see the Device Cloud User s Guide To configure 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 se...

Page 13: ...D 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 field as 00020000 00000000 00000000 6C4A21EA For a UMTS device add zero as the suffix of the IMEI number format XXXXXXXXXXXXXX0 F or ex ample if the IMEI number is 35642304400092 enter it using the IMEI field as 356423044000920...

Page 14: ... 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 fal...

Page 15: ...s device configurations NOTE Configuration and Connection History tabs appear on the Home page 2 To access configuration expand the Configuration tab The available configuration groups are Alarm Settings Cellular Settings Device Cloud Settings Device Settings 3 Click the individual group to view configurable parameters of the particular group ...

Page 16: ...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 mi...

Page 17: ...f 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 U...

Page 18: ...port 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 ...

Page 19: ...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 ...

Page 20: ...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 Percent...

Page 21: ...ll take you to the Data Services page as shown in the image above 2 Click Data Streams to view data reported by all devices listed in the current Device Cloud account 3 To view the data sent by a specific device use the search option and type in the device identity number 4 Click Last Updated to sort the device sent data by date The image above shows data reported by device identity number 0001000...

Page 22: ...i ConnectTank Getting Started Guide Page 22 Click the Raw Data tab to view tank liquid level values NOTE The distance value shown for the tank level is the distance between the sensor and the liquid level ...

Page 23: ...ated the device restarts and connects to Device Cloud 2 Update the microcontroller by following steps provided in the Digi ConnectTank Online Firmware Update or the Digi ConnectTank Offline Firmware Update sections Alternatively you can manually wake up the device using the magnet for updating the cellular module or follow the Digi ConnectTank Offline Firmware Update instructions to schedule firmw...

Page 24: ...Tank image in the device click Browse and enter the cellular module firmware path that contains the 82003325_RevX bin file 6 To load the microcontroller image in the module click Browse and enter the microcontroller firmware path that contains the Tank_MCU_Firmware bin file ...

Page 25: ...etherios com 2 Log in to your Device Cloud account using your login credentials 3 Select the Devices menu within the Device Managment tab 4 Locate your device within the Device list then right click the device ID Select Firmware then Update Firmware 5 Select the Schedule Offline check box to update the firmware The firmware will be updated as soon as the device is connected to Device Cloud ...

Page 26: ...e instructions mentioned in the Digi ConnectTank Offline Firmware Update section Verifying the Digi ConnectTank Firmware Update Version After updating the microcontroller send a configuration message to the device For more instructions see the Digi ConnectTank Device Configuration Using Device Cloud section After sending the configuration message the device will acknowledge with device data You ca...

Page 27: ...1 6W EDGE 25 29 dBm 0 32W 0 8W UMTS 23 dBm 0 2W Receiver sensitivity 107 dBm GSM 109 dBm typ EDGE 105 5 dBm min UMTS 108 dBm to 110 dBm typ Antenna Built in SIM slots Not used 1x Built in Sensor Sensor Massa M 300 150 Massa M 300 95 Massa M 300 150 Massa M 300 95 Type Ultrasonic built in temperature sound speed compensation Ultrasonic built in temperature sound speed compensation Range 4 inches 10...

Page 28: ...e rating NEMA 4X Mounting 1 NPT Regulatory approvals Safety Class I Division 2 CID2 Group D Battery UL 1642 standard ATEX under progress Emissions Immunity FCC Part 15B CE Immunity ESD IEC 61000 4 2 Level 4 Air discharge 15KV Contact discharge 8KV EMI Radiated field immunity IEC 61000 4 3 Level 3 10V m EMI Magnetic field immunity IEC 61000 4 8 Level 3 10A m Other EN 60068 2 31 Drop fall from 1 met...

Page 29: ...le is installed must also display a label referring to the enclosed module FCC ID Modifications FCC 15 21 Changes or modifications to this equipment not expressly approved by Digi may void the user s authority to operate this equipment CE Certifications Europe only Digi ConnectTank complies with European union CE marking requirements Important Digi ConnectTank Safety Information 1 Please read all ...

Page 30: ...ions This built in recovery mechanism enables you to restore your device to the original functionality Reset button The hard reset button wakes up the product if the device does not respond to timed wake up the Wake up button or use of the wake up magnet Upon hard reset the device boots up and then enters sleep mode You will need to wake up the device either by pressing the Wake up button or using...

Page 31: ...ink blue Battery level more than 25 Blink red Battery level less than 25 Cellular LED Blink blue 1 second On 1 second Off Registered to the cellular network Blink red Not registered to the cellular network registration failed Glow blue for 3 seconds Diagnostic record has been successfully sent to Device Cloud Cellular LED During Verizon activation Blink red 2 seconds On 2 seconds Off Authenticatio...

Page 32: ...ntract Digi ConnectTank Configuration Troubleshooting While setting the new device configuration in Device Cloud ensure that you press the Refresh button to fetch the latest values stored on the device Since the device is in sleep mode most of the time Device Cloud s scheduled offline operations are best suited for configuring the device parameters Changing APN for Digi ConnectTank UMTS Models Dig...

Page 33: ...ted Guide Page 33 7 Click OK 8 Click Examples and navigate to SCI SMS User Request 9 Replace my_target with apn and my user message with the service provider apn For example if you are using a Vodafone apn enter wap vodafone co uk ...

Page 34: ...ing up the new APN NOTE You should change the APN when the device is in wake up mode If you change the APN when the device is in sleep mode the changes are delivered to device on the next wake up cycle Also ensure that the SIM details are available in Device Cloud ...

Page 35: ...ttery pack 4 The battery connector is polarized follow the polarizing notch and connect the new battery 5 Press the Wake up button and ensure that the battery LED is glowing blue NOTE Replace the battery in non hazardous and unclassified areas only Only trained technicians should replace the Lithium Thionyl Chloride batteries used in Digi Connect Tank Remove the device from the installation area b...

Page 36: ... Phone Number 43444 Service ID SMS Feature State 1 Restrict Sender 0 Restrict Reply 1 Tank Type 0 Sensor Type 1 Send Count 1 Send Start Time 0 Alarm High 511 0 Alarm Low 0 Alarm Delta Low 0 Alarm Delta High 511 0 Alarm Mask 0 Alarm Hysteresis 1 0 Alarm Battery 75 GPS feature 0 GPS interval 1 Waveform 0 CAUTION Mounting the device vertically ensures proper orientation Cover screws are required as p...

Page 37: ...x type fix 0 no fix 1 valid fix 2 invalid fix GPS interval gin Interval for GPS information The range is 1 96 battery level bat The charge remaining in the battery reported in percentage apn apn apn idigi com sensor type sty 1 M300 150 2 M300 95 tank type tty Reserved for future use Initialize to 0 The tank type channel has application defined values but is intended for user application It is not ...

Page 38: ...nected 1 Sensor connected Device wake type dwt 2 Normal record 3 Alarm record 8 Wakeup record Send count sdc Send the last N readings 1 N 96 using smaller value of N to ensure room to grow PIC code Default should be 1 Implementation note This is essentially the size of the round robin buffer where samples should be stored Alarm high alh Alarm high means alarm when the val alh calculated from the s...

Page 39: ...Alarm delta low 3 Alarm delta high 4 Manual upload 5 Low battery alert 6 7 Reserved for future use Alarm battery abt Send battery channel alarm when battery abt Default to 75 75 Hardware version e g PCB version hwv String that returns the hardware version Firmware version e g PIC code version fwv Recommend major minor maint build for example 1 0 0 101 Software version e g Digi BREW code version sw...

Page 40: ... ConnectTank short range ultrasonic sensor UMTS HSPA ATT and Global CTANK M510 12 ConnectTank short range ultrasonic sensor UMTS HSPA ATT and Global 12 unit bulk pack CTANK M120 ConnectTank mid range ultrasonic sensor Sprint CTANK M120 12 ConnectTank mid range ultrasonic sensor Sprint 12 unit bulk pack CTANK M220 ConnectTank mid range ultrasonic sensor Verizon CTANK M220 12 ConnectTank mid range u...

Page 41: ...Digi International 11001 Bren Road East Minnetonka MN 55343 952 912 3444 or 877 912 3444 ...

Reviews: