net.studioblueplanet.tomtomwatch

Class CommunicationProcess

java.lang.Object

net.studioblueplanet.tomtomwatch.CommunicationProcess

All Implemented Interfaces:

ProgressListener

public class CommunicationProcess
extends Object
implements ProgressListener

This class executes the commands involving communication to the device. The commands are processed in a separate thread

Author:

jorgen.van.der.velde

Field Summary

Fields

Modifier and Type	Field and Description
static int	MAXROUTES

Constructor Summary

Constructors

Constructor and Description
CommunicationProcess(WatchInterface watchInterface, Executor executor, TomTomReader ttbinReader, GpxReader gpxReader) Constructor.

Method Summary

Modifier and Type	Method and Description
void	addRouteFile(String name, String file, int index) This method loads and adds a route file to the array with route files
void	clear() Removes any track data.
void	deleteAllRouteFiles() Remove all route files from the array
void	deleteRouteFile(int index) Remote selected route from the array
ActivityData	getActivityData(int index) Get the ActivityData based on the index in the array
String	getDeviceName() Returns the device name
UsbFile	getRouteFile(int index) Returns route from array at given index.
boolean	isConnected() Indicates whether a watch is connected or not
void	pushCommand(ThreadCommand command) Push a command for executing on the command queue
void	reportReadProgress(int bytesRead) This method reports the progress file reading
void	reportWriteProgress(int bytesWritten) This method reports the progress file writing
void	requestDeleteDeviceFileFromWatch(int fileId) Deletes the file from the watch.
void	requestLoadActivityFromTtbinFile(String fileName) Loads the activity from a ttbin file on disk
void	requestSetNewDeviceName(String name) Writes a new device name to the watch.
void	requestShowFile(int fileId) This method requests to display the contents of indicated file.
void	requestStop() Stop the process.
void	requestUploadFile(String fileName) Request the upload of a file from disk to the watch
void	requestUploadWorkouts(String fileName) Request the upload of the workouts defined in the JSON file
void	requestWriteDeviceFileToDisk(int fileId) Writes a file from the watch as binary file to disk.
void	setReadExpectedBytes(int bytes) Sets the number of expected bytes to be read
void	setTrackCompression(boolean enabled, double maxError) This method sets the track compression.
void	setTrackSmoothing(boolean enabled, float qFactor) This method sets the track smoothing.
void	setWriteExpectedBytes(int bytes) Sets the number of expected bytes to be writen
void	startProcess(TomTomWatchView view) Set the view and start the processing

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

MAXROUTES

public static final int MAXROUTES

See Also:

Constant Field Values

Constructor Detail

CommunicationProcess

public CommunicationProcess(WatchInterface watchInterface,
                            Executor executor,
                            TomTomReader ttbinReader,
                            GpxReader gpxReader)

Constructor. Initializes the instance

Parameters:

watchInterface - Interface to the watch to use

executor - Executor to use to execute subsequent requests to the watch in a serialized order

ttbinReader - The reader/decoder to use for TTBIN files

gpxReader - The reader to use for GPX files

Method Detail

startProcess

public void startProcess(TomTomWatchView view)

Set the view and start the processing

Parameters:

view - TomTomWatchView instance

requestStop

public void requestStop()

Stop the process. The request is processed asynchronously by the thread.

pushCommand

public void pushCommand(ThreadCommand command)

Push a command for executing on the command queue

Parameters:

command - Command to push on the queue

requestSetNewDeviceName

public void requestSetNewDeviceName(String name)

Writes a new device name to the watch. The request is processed asynchronously by the thread.

Parameters:

name - The new name

requestLoadActivityFromTtbinFile

public void requestLoadActivityFromTtbinFile(String fileName)

Loads the activity from a ttbin file on disk

Parameters:

fileName - THe file to load

requestWriteDeviceFileToDisk

public void requestWriteDeviceFileToDisk(int fileId)

Writes a file from the watch as binary file to disk. The request is processed asynchronously by the thread.

Parameters:

fileId - Id of the file

requestUploadFile

public void requestUploadFile(String fileName)

Request the upload of a file from disk to the watch

Parameters:

fileName - The file to upload

requestDeleteDeviceFileFromWatch

public void requestDeleteDeviceFileFromWatch(int fileId)

Deletes the file from the watch. The request is processed asynchronously by the thread.

Parameters:

fileId - Id of the file

requestShowFile

public void requestShowFile(int fileId)

This method requests to display the contents of indicated file. The request is processed asynchronously by the thread.

Parameters:

fileId - ID of file to show

requestUploadWorkouts

public void requestUploadWorkouts(String fileName)

Request the upload of the workouts defined in the JSON file

Parameters:

fileName - The file defining the workouts, JSON format

getActivityData

public ActivityData getActivityData(int index)

Get the ActivityData based on the index in the array

Parameters:

index - Array index

Returns:

The data or null if not found

isConnected

public boolean isConnected()

Indicates whether a watch is connected or not

Returns:

True if connected, false if not

getDeviceName

public String getDeviceName()

Returns the device name

Returns:

The device name or null if not connected

setTrackSmoothing

public void setTrackSmoothing(boolean enabled,
                              float qFactor)

This method sets the track smoothing. Call before downloading TTBINs

Parameters:

enabled - Indicates whether smoothing is enabled

qFactor - The Q Factor for smoothing

setTrackCompression

public void setTrackCompression(boolean enabled,
                                double maxError)

This method sets the track compression. Call before downloading TTBINs

Parameters:

enabled - Indicates whether compression is enabled

maxError - The maximum error for Douglas-Peucker compression method

addRouteFile

public void addRouteFile(String name,
                         String file,
                         int index)

This method loads and adds a route file to the array with route files

Parameters:

name - Name of the route

file - File name of the route gpx file

index - Location in the array to add the route file to

deleteAllRouteFiles

public void deleteAllRouteFiles()

Remove all route files from the array

deleteRouteFile

public void deleteRouteFile(int index)

Remote selected route from the array

Parameters:

index - Location of the route file

getRouteFile

public UsbFile getRouteFile(int index)

Returns route from array at given index.

Parameters:

index - Location of the route file in the array

Returns:

The route file as UsbFile instance

clear

public void clear()

Removes any track data. Erase acitivities, clear the list

setReadExpectedBytes

public void setReadExpectedBytes(int bytes)

Description copied from interface: ProgressListener

Sets the number of expected bytes to be read

Specified by:

setReadExpectedBytes in interface ProgressListener

Parameters:

bytes - Number of bytes

setWriteExpectedBytes

public void setWriteExpectedBytes(int bytes)

Description copied from interface: ProgressListener

Sets the number of expected bytes to be writen

Specified by:

setWriteExpectedBytes in interface ProgressListener

Parameters:

bytes - Number of bytes

reportReadProgress

public void reportReadProgress(int bytesRead)

This method reports the progress file reading

Specified by:

reportReadProgress in interface ProgressListener

Parameters:

bytesRead - Number of bytes that have been written

reportWriteProgress

public void reportWriteProgress(int bytesWritten)

This method reports the progress file writing

Specified by:

reportWriteProgress in interface ProgressListener

Parameters:

bytesWritten - Number of bytes that have been written