Adaptrackituserguide v1 2

Android AdapTrackIt
User's Guide
Version: 1.2
Date: 22 November 2015
Author: Simon Coulter
Table of Contents
1.Introduction.......................................................................................................................................4
2.Hardware Requirements....................................................................................................................4
3.Overview...........................................................................................................................................5
4.Portrait Mode.....................................................................................................................................7
5.GPS Nag Pop-Up Window................................................................................................................8
6.Configuration and Control.................................................................................................................9
6.1.Logging....................................................................................................................................10
6.2.Peak Values..............................................................................................................................11
6.3.Preferences...............................................................................................................................14
6.3.1.Colour Preferences...........................................................................................................15
6.3.2.Demo Mode......................................................................................................................17
6.3.3.Gauge Preferences............................................................................................................20
6.3.3.1.Main Gauge Preferences..........................................................................................20
6.3.3.2.Minor Gauge Preferences.........................................................................................22
6.3.4.Logging Preferences........................................................................................................26
6.3.5. Shift Light Preferences....................................................................................................30
6.3.6.Unit Preferences...............................................................................................................34
Page 2 of 34
AdapTrackIt User's Guide

Figure Index
Figure 1: USB 2.0 Type B and USB 2.0 Micro Type B Plugs..............................................................4
Figure 2: USB 2.0 Micro Type B Plug to USB 2.0 Type A Jack..........................................................4
Figure 3: AdapTrackIt App Main Screen (Landscape Mode)..............................................................5
Figure 4: Main Screen (Portrait Mode)................................................................................................7
Figure 5: Initial GPS Nag Pop-Up........................................................................................................8
Figure 6: AdapTrackIt App Main Screen Buttons................................................................................9
Figure 7: Logging Error......................................................................................................................10
Figure 8: Gauge Peaks........................................................................................................................11
Figure 9: Select Log File....................................................................................................................12
Figure 10: Log File Peaks...................................................................................................................13
Figure 11: Preferences Root Menu.....................................................................................................14
Figure 12: Colour Preferences............................................................................................................15
Figure 13: Colour Picker....................................................................................................................16
Figure 14: Demo Configuration.........................................................................................................17
Figure 15: Demo Update Rate............................................................................................................18
Figure 16: Gear used for Shift Light in Demo Mode.........................................................................19
Figure 17: Gauge Configuration.........................................................................................................20
Figure 18: Maximum RPM Configuration.........................................................................................21
Figure 19: RPM Redline Configuration.............................................................................................21
Figure 20: Speed Source Configuration.............................................................................................21
Figure 21: Minor Gauge Preferences.................................................................................................22
Figure 22: Minor Gauge Configuration..............................................................................................23
Figure 23: High Threshold "hit" indicators........................................................................................24
Figure 24: Minor Gauge Type Selection............................................................................................25
Figure 25: Main Logging Preferences Screen....................................................................................26
Figure 26: Select Logging Folder Screen...........................................................................................26
Figure 27: Logging Timestamp Preference........................................................................................27
Figure 28: Log Rate Preference..........................................................................................................27
Figure 29: Select Adaptronic Data Screen..........................................................................................28
Figure 30: Select GPS Data Screen....................................................................................................29
Figure 31: Shift Lights - Shift NOW..................................................................................................30
Figure 32: Shift Light Preferences.....................................................................................................31
Figure 33: First Shift Warning (Warning Threshold reached)............................................................32
Figure 34: Second Shift Warning.......................................................................................................32
Figure 35: Third Shift Warning (Shift Point Approaching)................................................................33
Figure 36: Fourth Shift Warning (SHIFT NOW!)..............................................................................33
Figure 37: Unit Preferences Screen....................................................................................................34
Page 3 of 34
1. Introduction
This document describes the Android AdapTrackIt App which can be used to display live
Adaptronic Select ECU values and log data for subsequent analysis.
2. Hardware Requirements
The following hardware is required to run the AdapTrackIt App:
Android 4.4 (KitKat) device (or later)

Adaptronic Select ECU
On-The-Go (OTG) USB cable
The Adaptronic ECU has a USB 2.0 Type B Jack so requires a USB 2.0 Type B plug (see
left connector in Figure 1 below).
Most Android devices have a USB 2.0 Micro Type B Jack so require a USB 2.0 Micro Type
B plug (see right connector in Figure 1 below).
Figure 1: USB 2.0 Type B and USB 2.0 Micro Type B Plugs
Finding an OTG USB cable with these connectors has proved difficult however OTG USB
adapters can be used with the more commonly available USB 2.0 Type B to USB 2.0 Type
A cables:
Figure 2: USB 2.0 Micro Type B Plug to USB 2.0 Type A Jack
Page 4 of 34
3. Overview
The design goal of the AdapTrackIt App was to replace the instrument cluster and present
as much information as possible to the driver whilst still being readable at a glance while
driving.
Figure 3: AdapTrackIt App Main Screen (Landscape Mode)

Table 1 below describes the layout of the Main Screen; the IDs correspond to the
annotations above and are referred to throughout the document in parenthesis.
Different users have different requirements so apart from the main RPM (3) and Speed (4)
gauges, six minor configurable gauges are supported.
The six minor configurable gauges are those in the bottom half of the screen, gauges one
to three in column one and gauges four to six in column two; these are described in
section 6.3.3.2. The minor gauge labels (9) are small because most users will know their
selected gauge layout and rarely change it; it's more important to make their values (8)
and corresponding levels (10) as easy to read as possible.
Page 5 of 34
ID
Description
Notes
ECU Connection Icon
Red=Not Connected, Orange=Connecting,

Green=Connected
GPS Connection Icon
Red=Not Connected, Orange=Connecting,

Green=Connected
RPM Indicator
Maximum value, normal colour and red-line colour are

configurable (see section 6.3.3.1).
Speed Indicator
Colour is configurable (all dynamic numeric values shown

in same colour, see section 6.3.1).
Speed Source
Vehicle or GPS, configurable (see section 6.3.3.1).
Speed Units
km/h or MPH, configurable (see section 6.3.6).
Logging Indicator
Red=Not Logging, Green=Logging (see section 6.1).
Minor Gauge Value
Gauge Type is configurable (see section 6.3.3.2).
Minor Gauge Label
Gauge label text is configurable (see section 6.3.3.2).
Minor Gauge Level
Gauge level minimum, maximum, low threshold and high

thresholds are configurable (these dictate the colour
displayed in the gauge level).
10 (Linear representation of Gauge levels in the left column grow from left to right.
the Gauge Value)
Gauge levels in the right column grow from right to left.
Refer to section 6.3.3.2 for details.
11 Shift Warning Lights
RPM+Gear-based indicators used to indicate when to upshift; the indicator is mirrored on either side of the RPM
gauge.
Refer to section 6.3.5 for details.
These indicators appear in the minor gauge level if the

gauge has a configured High Threshold and it has been
High
Threshold
Indicator
12
hit.
Refer to section 6.3.3.2 for details.
Table 1: Main Screen Description
Page 6 of 34
4. Portrait Mode
The App also supports Portrait mode, where the six minor gauges are displayed in a single
column:
Figure 4: Main Screen (Portrait Mode)

The figure on the left is using GPS-sourced speed (5) and is displayed in km/h (6).
The figure on the right is using vehicle-sourced speed (5) and is displayed in MPH (6).
Portrait mode is most useful when configuring the App or viewing of Log File peak values,
see section 11, since it minimises the amount of scrolling required.
Page 7 of 34
5. GPS Nag Pop-Up Window

When the App is started, if GPS is not enabled, the following Nag Pop-Up is displayed to
inform the user that GPS isn't enabled:
Figure 5: Initial GPS Nag Pop-Up

If the user doesn't care about GPS data, selecting Continue will execute the App but no
GPS data will be presented or logged.
If the user does require GPS data, they should select the Exit option to exit the App, then
enable GPS and re-start the App.
This nag pop-up was added so that users don't unintentionally forget to enable GPS
when they log a track session.
Page 8 of 34
6. Configuration and Control

The App is displayed in full-screen mode to maximise the information that can be
presented; tapping the screen displays control buttons on the bottom of the screen:
Figure 6: AdapTrackIt App Main Screen Buttons

These buttons are used to control the behaviour of the App:
Start Logging starts logging (the label changes to Stop Logging when logging is
in progress). See section 6.1 for details.
Show Peaks displays the peak data for the displayed gauges (a sub-screen
allows these peaks to be reset and also allows the peaks from a selected log file to
be displayed). See section 6.2 for details.
Settings displays a sub-menu that allows the App to be configured (display and
log units, colours, minor configurable gauges, data is to be logged, define whether
vehicle or GPS speed should be displayed, etc). See section 6.3 for details.
Page 9 of 34
6.1. Logging
The Start Logging button is used to start logging data and is only available if the ECU is
connected, otherwise the following pop-up error message is displayed:
Figure 7: Logging Error

By default, no data is selected for logging and the user must select the required Adaptronic
and GPS data (see section 6.3.4) to be logged, otherwise a pop-up dialog indicates this.
Logging preferences are preserved so this only needs to be done once unless additional
changes are required.
When the ECU is connected, Logging preferences have been defined and the Start
Logging button is selected:
The button's label changes to Stop Logging
The Logging Indicator icon (7) changes from red to green
A new log file is created in the selected logging folder with a name in the format
YYYYMMDD_hhmmsslog.csv
The log file is created in .csv format, where each line contains all data delimited by
commas and the first line contains the column headings and their units.
The actual data logged depends on what the user has selected for logging, see section
6.3.4, and the units are logged in the user's configured units, see section 6.3.6.
Page 10 of 34

Logging is terminated when the ECU is connected, the App is exited, or the user selects
the Stop Logging button.:
The button's label changes to Start Logging
The Logging Indicator icon (7) changes from green to red
The log file is closed.
6.2. Peak Values

The gauge peak values and peak values recorded in log files can be displayed by tapping
the Show Peaks button on the Main screen:
I
Figure 8: Gauge Peaks

Initially the gauge peak values are displayed in user-defined units and the minor gauges
are labelled with their user-defined label. Depending on the nature of the configurable
gauge, the peak value may or may not be meaningful.
Tapping the Clear Peaks button resets the peak values to zero, as shown above, and will
also reset/clear the High Threshold Indicators (12) in the minor gauge level indicators.
Peak values can also be displayed for logged data by tapping the Show Log Peaks
button; initially the user-defined log folder, see section 6.3.4, is presented and log files are
displayed with a LOG icon on their left:
Page 11 of 34
Figure 9: Select Log File

Navigation to another folder can be achieved by selecting the Parent Folder icon or
another folder icon (the above figure has no child directories under the current folder,
/sdcard/LogFiles).
Selecting a log file displays the peak values for the data logged in that file:
Page 12 of 34
Figure 10: Log File Peaks

Peak values for the logged data are displayed in alphabetical order, in user-defined units,
see 6.3.6. The labels correspond to the headings in the logging file.
These values are best viewed in Portrait mode since there will assumedly be a lot of
entries which can be scrolled through.
Tap the Back button to return to the Gauge Peaks screen (Figure 7).
Page 13 of 34
6.3. Preferences
Tapping the Settings button presents the Preferences root menu which allows the App to
be configured.
Figure 11: Preferences Root Menu

These menus are described in the following sections.
Tapping the Back button returns the user to the Main Screen; this can take a few seconds
since the static components of the Landscape and Portrait Main screens need to be
redrawn based on the user-preferences.
Page 14 of 34

6.3.1.Colour Preferences
The colours used by the App can be configured via the Colour Preferences screen:
Figure 12: Colour Preferences

Layout Colour Used to draw the Main screen's static data (RPM ticks and labels, Speed
units (6) and the minor gauge's labels (9) and level bounding boxes (10)).
Dynamic Text Used to draw the RPM level (3), speed (4) and minor gauge values (8).
Gauge Normal Colour Used to fill a minor gauge level indicator (10) when its value
falls within its normal operating range; this is the default colour for the gauge level.
See section 6.3.3.2 for details regarding gauge level colours and thresholds.
Low Threshold Colour - Used to fill a minor gauge level indicator when its value falls
below a user-defined threshold (eg. for an AFR gauge, a Lean threshold can be
defined).
High Threshold Colour - Used to fill a minor gauge level indicator when its value exceeds
a user-defined threshold (eg. for an AFR gauge, a Rich threshold can be defined; for
a WATer temperature gauge, a high temperature warning threshold can be defined).
Note: The Shift Light indicator (11) colours are configured via the Shift Light Preferences
(see section 6.3.5).
Tapping one of these values allows its colour to be changed via the Colour Picker screen:
Page 15 of 34
Figure 13: Colour Picker

Use the right and left colour scales to define the required colour.
To apply the required colour, tap the bottom right colour panel (the bottom left panel shows
the current colour).
Page 16 of 34

6.3.2.Demo Mode
The App comes with a Demo mode that is useful to test configuration of the colours and
labels, Shift Lights (11), as well as demonstrate the App without it being connected to an
Adaptronic ECU.
Figure 14: Demo Configuration

Checking the Enable Demo mode box will commence Demo mode when the user
returns to the Main screen.
In Demo mode, gauge values will increment by random amounts up to their maximum
values, then decrement by random amounts to their minimum values and repeat the cycle.
Page 17 of 34

The rate of gauge value and screen updates in Demo mode can be configured by
tapping the Demo Update Rate preference and selecting the required rate:
Figure 15: Demo Update Rate

This preference was added to debug the App but it's also useful to slow things down
when playing around with preferences to see changes which can be missed when running
at full-speed.
Page 18 of 34

The Gear (used for Shift Lights) preference is used to define which gear will be used to
control the Shift Lights (11) behaviour in Demo mode. Shift Light behaviour depends on
the RPM shift point which is defined per gear. Refer to section 6.3.5 for Shift Light
details.
Figure 16: Gear used for Shift Light in Demo Mode
Page 19 of 34

6.3.3.Gauge Preferences
This preference allows the displayed gauges to be configured.
Figure 17: Gauge Configuration
6.3.3.1. Main Gauge Preferences

These preferences allow the main gauges, RPM (3) and Speed (4), to be configured.
Maximum RPM Defines the maximum RPM value that is displayed on the RPM gauge.
RPM Redline Defines the RPM redline. The RPM level is displayed in the High
Threshold colour, see section 6.3.1, when the RPMs exceed this value.
The RPM redline is defined via numeric entry to give the user the ability to define a
specific value (if this value exceeds the Maximum RPM value it will be truncated to the
Maxim RPM value).
Page 20 of 34

Speed Source Defines whether the Vehicle or GPS Speed should be displayed. The
Speed Source icon (5) on the Main screen indicates the source of the speed displayed,
a car for Vehicle and satellite for GPS. The displayed speed is defined by the Speed
units, see section 6.3.6, using the Unit Preferences screen.
If GPS is selected but GPS speed is unavailable, it will revert to the Vehicle's speed
and the icon is updated accordingly; when GPS speed becomes available it will switch
to GPS.
Figure 18: Maximum RPM Configuration
Figure 19: RPM Redline Configuration
Figure 20: Speed Source Configuration

Page 21 of 34

6.3.3.2. Minor Gauge Preferences
The six minor gauges can be configured by tapping the required gauge number on the
Gauge Preferences screen; the last gauges can be accessed by scrolling the screen to
access them. The gauge type and its minimum..maximum values are displayed under the
gauge number.
Figure 21: Minor Gauge Preferences

When a minor configurable gauge is tapped, its current values are displayed (ie, type,
label, minimum, maximum, low threshold and high threshold):
Page 22 of 34
If the Low Threshold matches the Minimum value,

the Low Threshold field is blank.
If the High Threshold matches the Maximum value,
the High Threshold field is blank.
Figure 22: Minor Gauge Configuration
The gauge values and labels can be edited by

tapping the required field and saved by tapping the
Save button.
In this AFR gauge example, both Low and High thresholds have been defined:
When the AFR value lies between the Minimum and Low Threshold values, the
Gauge level is displayed in the Low Threshold colour.
When the AFR value lies between the Low Threshold and High Threshold values,
the Gauge level is displayed in the Normal colour.
When the AFR value lies between the High Threshold and Maximum values, the
Gauge level is displayed in the High Threshold colour.
Page 23 of 34

If a High Threshold value is defined for a minor gauge and the threshold is hit at any
time, a High Threshold Hit indicator (12) is displayed in the minor gauge level next to the
value/label:
Figure 23: High Threshold "hit" indicators

These High Threshold Hit indicators (12) provide immediate feedback that a High
Threshold has been hit regardless of the minor gauge's current value, the user doesn't
need to visit the Show Peaks screen, see section 6.2, to determine this.
The colour of the indicator will be the High Threshold colour if the gauge is not currently at
or above the gauge's High Threshold (as shown in the Boost gauge level above) and
black otherwise (as shown in the AFR and Water Temp gauge levels above).
The High Threshold Hit indicators can be cleared/reset by tapping the Show Peaks
Clear Peaks button (see section 6.2).
Page 24 of 34

The gauge type can be changed by tapping the gauge type text (eg. tapping Air/Fuel
Ratio (AFR) in Figure 22). This presents the Select Gauge Type preference screen:
Figure 24: Minor Gauge Type Selection

Tapping the required gauge type returns the user to the Gauge Configuration
preferences screen and updates the minor gauge configuration with default values for that
gauge type which the user can update as required.
Multiple gauges are available, these are displayed in alphabetical order and can be
scrolled through to find the required gauge type.
Page 25 of 34

6.3.4.Logging Preferences
The log file, log rate, data to be logged and timestamp format can be configured via the
Logging Preferences screen.
Figure 25: Main Logging Preferences Screen
Log folder selection is achieved by navigating

to the required folder on the Select Logging
Folder screen.
The current folder is shown below the Select
Current Folder label; tapping this line selects
the current folder as the logging folder.
Tapping a folder icon descends into that
folder.
Tapping the Parent Folder icon ascends to
the current folder's parent.
Figure 26: Select Logging Folder Screen
Note: The file icons are NOT selectable,

these are only presented to provide additional
context regarding the contents of the current
folder.
Page 26 of 34
All data recorded in the log file is timestamped

and multiple timestamp formats are supported:
Figure 27: Logging Timestamp Preference
The log rate can also be configured.

GPS data in Android phones is typically
updated at 1Hz however a faster rate is often
preferred if the logged data is being used to
overlay information onto corresponding video
(gauges will be smoother at higher rates).
Figure 28: Log Rate Preference
Keep in mind that faster logging rates will

result in larger log files (eg. At 10 Hz, there
will be ten times as much data logged as
there would have been at 1Hz over the same
period).
The Adaptronic data to be logged can be defined using the Select Adaptronic Data
preference, scrolling through it and checking the box corresponding to the required data to
be logged.
Page 27 of 34

At least one item must be selected to
start logging (otherwise there's no
point in logging!).
The values logged are in the units
defined in the Unit Preferences
(6.3.6).
If EGT, Ignition Timing, or Injector
Pulse Widths is checked, all four
values in that category are recorded
(ie. If EGT is checked, EGT1, EGT2,
EGT3 and EGT4 values are logged).
The following values that can be
logged define multiple states (ie.
ON/OFF states) and are logged in
hexadecimal format:
Cutting State
Digital Inputs
Digital Outputs
Flags
Learning State
Safety Cut Functions
Figure 29: Select Adaptronic Data Screen
Page 28 of 34

GPS data can also be logged and the
required log data is configurable via
the Select GPS Data preference.
Speed is logged in the units defined in

the Unit Preferences (6.3.6).
Figure 30: Select GPS Data Screen
Page 29 of 34
The Latitude/Longitude format

recorded in the Log file can be
configured via the Lat/Long Format
option:

6.3.5. Shift Light Preferences
Shift Light indicators (11) are displayed based on the current RPMs, the RPM Shift Point
configured for the current Gear and the configured Shift Warning Threshold.
The Shift Warning Threshold is an RPM delta; when the current RPMs reach the current
Gear's Shift Point minus this RPM delta, Shift Lights are displayed.
Users MUST configure the RPM Shift Points for each Gear to suit their vehicle since
optimum Shift Points depend on the vehicle's engine and gearing.
When Shift Lights are enabled, shift light indicators are mirrored on either side of the
tachometer, as shown in the yellow in the Figure below:
Figure 31: Shift Lights - Shift NOW

When the Shift Warning Threshold is reached, a single Shift Light is displayed on either
side of the tachometer.
As the RPMs approach the current Gear's Shift Point, additional shift lights are displayed
(maximum of four).
When the Shift Point is reached, the Shift Lights will strobe SHIFT UP NOW!
Page 30 of 34

Shift Light Preferences dictate the behaviour of the Shift Lights:
Figure 32: Shift Light Preferences

Enable Shift Lights enables or disables the display of Shift Lights. Defaults to Disabled.
Warning Threshold (RPM) is an RPM delta; when the current RPMs reach the current
Gear's Shift Point minus this RPM delta, Shift Lights are displayed.
RPM SHIFT POINTS These settings allows the RPM Shift Point per Gear to be
configured.
Users MUST configure these values based on vehicle gearing, the default values
are NOT real-world values.
Page 31 of 34

Warning Colour defines the colour used to display the Shift Lights when above 50% of
the Warning Threshold (ie. when one or two Shift Lights are displayed). Defaults to Cyan.
Shift Colour defines the colour used to display the Shift Lights when below 50% of the
Warning Threshold (ie. when three or four Shift Lights are displayed). Defaults to Yellow.
Figure 33: First Shift Warning (Warning Threshold reached)
Figure 34: Second Shift Warning
Page 32 of 34
Figure 35: Third Shift Warning (Shift Point Approaching)
Figure 36: Fourth Shift Warning (SHIFT NOW!)
Page 33 of 34

6.3.6.Unit Preferences
The values displayed and logged are in configurable units and can be defined via the Unit
Preferences.
Tapping a unit preference displays the corresponding pop-up window that allows the unit to
be selected from the displayed options.
Figure 37: Unit Preferences Screen
Page 34 of 34

Adaptrackituserguide v1 2

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Adaptrackituserguide v1 2

Uploaded by

Copyright:

Available Formats

Android AdapTrackIt

AdapTrackIt User's Guide

AdapTrackIt User's Guide

Android 4.4 (KitKat) device (or later)

AdapTrackIt User's Guide

Figure 3: AdapTrackIt App Main Screen (Landscape Mode)

AdapTrackIt User's Guide

ECU Connection Icon

Red=Not Connected, Orange=Connecting,

GPS Connection Icon

Red=Not Connected, Orange=Connecting,

Maximum value, normal colour and red-line colour are

Colour is configurable (all dynamic numeric values shown

Vehicle or GPS, configurable (see section 6.3.3.1).

km/h or MPH, configurable (see section 6.3.6).

Red=Not Logging, Green=Logging (see section 6.1).

Minor Gauge Value

Gauge Type is configurable (see section 6.3.3.2).

Minor Gauge Label

Gauge label text is configurable (see section 6.3.3.2).

Minor Gauge Level

Gauge level minimum, maximum, low threshold and high

11 Shift Warning Lights

These indicators appear in the minor gauge level if the

AdapTrackIt User's Guide

Figure 4: Main Screen (Portrait Mode)

AdapTrackIt User's Guide

5. GPS Nag Pop-Up Window

Figure 5: Initial GPS Nag Pop-Up

AdapTrackIt User's Guide

6. Configuration and Control

Figure 6: AdapTrackIt App Main Screen Buttons

AdapTrackIt User's Guide

Figure 7: Logging Error

AdapTrackIt User's Guide

6.2. Peak Values

Figure 8: Gauge Peaks

AdapTrackIt User's Guide

Figure 9: Select Log File

AdapTrackIt User's Guide

Figure 10: Log File Peaks

AdapTrackIt User's Guide

Figure 11: Preferences Root Menu

AdapTrackIt User's Guide

Figure 12: Colour Preferences

AdapTrackIt User's Guide

Figure 13: Colour Picker

AdapTrackIt User's Guide

Figure 14: Demo Configuration

AdapTrackIt User's Guide

Figure 15: Demo Update Rate

AdapTrackIt User's Guide

Figure 16: Gear used for Shift Light in Demo Mode

AdapTrackIt User's Guide

Figure 17: Gauge Configuration

6.3.3.1. Main Gauge Preferences

AdapTrackIt User's Guide

Figure 18: Maximum RPM Configuration

Figure 19: RPM Redline Configuration

Figure 20: Speed Source Configuration

AdapTrackIt User's Guide

Figure 21: Minor Gauge Preferences

AdapTrackIt User's Guide