Campbell Scientific LoggerLink Mobile App for Android User Manual

LoggerLink
Mobile App for
Android
Revision: 3/14
Copyright © 2012- 2014
Campbell Scientific, Inc.
Introduction ..................................................................................... 1
Requirements ................................................................................... 1
Getting Started ................................................................................ 1
Datalogger Setup ........................................................................... 2
TCP Connection ...................................................................... 2
Bluetooth Connection ............................................................. 3
Connecting .................................................................................... 5
Connected ...................................................................................... 6
Disconnecting ................................................................................ 6
Datalogger Setup—Settings ............................................................ 7
Connecting ...................................................................................... 9
Current ............................................................................................. 9
Status ............................................................................................. 12
Historic .......................................................................................... 18
Collect Data ................................................................................... 21
Files ............................................................................................... 24
Settings .......................................................................................... 27
Disconnect ..................................................................................... 28
Off-line Files ................................................................................. 28
LoggerLink Settings ...................................................................... 29
End User License Agreement (EULA) for Mobile Applications . 31
i
TOC

Introduction

Please read the End User License Agreement (EULA).
LoggerLink for Android™ is a simple yet powerful tool that lets you communicate directly with your IP-enabled or Bluetooth­enabled CR3000, CR1000, CR800-Series, and CR200-Series dataloggers from your Android device. The app lets you perform field maintenance tasks such as viewing and collecting data, setting the clock, and downloading programs.

Requirements

LoggerLink for Android runs on Android 2.2 or greater. Bluetooth communication requires Android 4.0.3 (Ice Cream Sandwich) or greater.

Getting Started

When LoggerLink is launched, you can add new dataloggers by tapping the “+” button in the upper right corner of the screen.
Note that to use a TCP connection, your Android device must be connected to a network through which you can reach your datalogger. To use a Bluetooth connection, you must have an RS-232 to Bluetooth adapter connected to your datalogger’s RS-232 port.
Some LoggerLink functions are accessed from your Android device’s Menu button. If your device does not have a Menu
1
TOC
button, these functions can be accessed from the menu button on the right end of the action bar at the top of the LoggerLink screen.

Datalogger Setup

Note that you can only specify a TCP or a Bluetooth connection for a single datalogger. If you enter information in the TCP Settings, any previous Bluetooth Settings will be cleared. If you select a Bluetooth connection, any previous TCP Settings will be cleared.

TCP Connection

Depending on how your datalogger is connected to the Internet, you may be able to use the UDP or PB discovery buttons to set up your datalogger.
If your network supports UDP, simply tap the UDP discovery
button next to the TCP Address field. LoggerLink will return a list of PakBus dataloggers that it discovers. Tap a datalogger in the list to have its settings automatically filled in to the Datalogger Setup screen. After manually filling in any additional settings, tap the Save button to add the datalogger.
If your network does not support UDP, you may be able to use
the PakBus discovery button to set up your dataloggers.
2
Simply type in the IP Address and Port, and then tap the PB discovery button next to the PakBus Address field. LoggerLink will return a list of PakBus dataloggers that are
TOC
reachable from that IP address. Tap a datalogger in the list to have its settings automatically filled in to the Datalogger Setup screen. After manually filling in any additional settings, tap the Save button to add the datalogger.
If you are not able to use UDP or PakBus discovery, you will need to manually enter the information about how LoggerLink will connect to your datalogger.

Bluetooth Connection

Press the Bluetooth button at the top of the screen. LoggerLink should automatically search for Bluetooth devices. If not, press the discovery button next to the Bluetooth Name field. It can take up to 12 seconds for device names to be returned. Select the Bluetooth device from the list returned by LoggerLink. Note that you cannot manually enter the Bluetooth settings. A device must be selected from the list returned by LoggerLink.
Note that Bluetooth connectivity is supported only in Android versions 4.0.3 (Ice Cream Sandwich) and higher. The baud rate of the RS-232-Bluetooth adapter must match that of the datalogger. Handshaking should be disabled in the adapter. (If that is not possible, handshaking must be enabled in the datalogger.) Depending on the adapter, there may be other settings that need to be set correctly for proper communication.
3
TOC
See the Datalogger Setup section for an explanation of each field on the Datalogger Setup screen.
After you have finished setting up a datalogger, it will show up in the list of dataloggers when LoggerLink is launched. You can view a datalogger’s settings by tapping on the “i” button on the right side of the datalogger. You can edit a datalogger’s settings by tapping the “i” button, and then tapping the pencil icon on the upper right. You can delete a datalogger by tapping the “i” button, tapping your device’s Menu button, and then selecting Delete Datalogger.
4
TOC

Connecting

To connect to a datalogger, simply tap on it in the list of dataloggers.
5
TOC

Connected

After you have connected with your datalogger, a set of tabs will appear at the top of the screen. Tapping on these tabs will allow you to perform different operations on your datalogger such as viewing data in a tabular or graphical format, monitoring status, and collecting data.
If you leave LoggerLink or your device goes to sleep while connected to a datalogger, you will be automatically disconnected from the datalogger 10 minutes after any background processes (such as data collection) complete. Note that if you have Prevent Sleep enabled (see the LoggerLink
Settings section) your device will not automatically go to sleep
while you are connected to a datalogger. You must put the device to sleep manually or disconnect from the datalogger.

Disconnecting

When you are finished interacting with your datalogger, tap your device’s Menu button and select Disconnect (or simply tap your device’s back button) to disconnect and return to the list of dataloggers.
6
TOC

Datalogger Setup—Settings

TCP Settings
Address
The TCP/IP Address of the device you will be communicating with.
Port
The TCP/IP Port the device is accepting connections on. This defaults to 6785.
Bluetooth Settings
Note that the Bluetooth Name and Address must be selected from the list that LoggerLink returns after searching for Bluetooth devices. They cannot be entered manually.
Name
The Name of the Bluetooth device you will be communicating with.
Address
The Bluetooth Address of the device you will be communicating with.
Datalogger Settings
Type
The Type of the datalogger you will be communicating with.
7
TOC
Name
The Name used to identify this datalogger in LoggerLink. Data files collected from this datalogger will be stored in a sub-directory with this name.
PakBus Settings
Address
The PakBus Address of the datalogger you will be connecting to. The valid range is 1 through 4094. However, PakBus addresses greater than 3999 are typically reserved for PakBus routing devices and ports.
Neighbor
The PakBus address of the neighbor you will go through to connect to your datalogger. A value of 0 means you will connect directly to your datalogger.
Security Code
The Security Code is only required if security has been enabled on your datalogger. In order for LoggerLink to connect to a security-enabled datalogger, the security code of at least level 3 is required. The level 3 security code allows you to check the clock and collect data. The level 2 security code is required to set the clock or change public variables. The level 1 security code unlocks the highest level of security and allows you to change or retrieve the program as well as change status table variables.
8
TOC
TCP Password
If you are trying to connect via TCP to a datalogger with a TCP Password enabled, you must enter the password in order for any communications to occur with the datalogger.
Encryption Key
This setting specifies text that will be used to generate the key for encrypting PakBus messages sent or received by this datalogger. The key entered here must match the PakBus Encryption Key setting in the device.

Connecting

To connect to a datalogger, simply tap on the datalogger in your list of dataloggers or tap the Connect button while viewing the datalogger’s settings. When connecting to a datalogger, a clock check is sent to see if communications can be established. On the first connection, table definitions are retrieved and stored. Table definitions are only retrieved again, if a change is detected.

Current

The current page displays the current data record for the selected table.
9
TOC
Tap the icon in the upper right corner to select and configure a different table.
10
Loading...
+ 27 hidden pages