T8 Suite user manual 1.2.

T8 SUITE USER MANUAL

Document created by Dilemma 2011 1/33

T8 Suite user manual 1.2.6

TABLE OF CONTENTS

Table of contents................................................................................................................................................................ 2

Purpose and scope ............................................................................................................................................................. 5

References ......................................................................................................................................................................... 5

General information ........................................................................................................................................................... 5

File menu ........................................................................................................................................................................... 6

File actions – Open a binary file ..................................................................................................................................... 6

File actions – Exit T8Suite............................................................................................................................................... 7

File actions – Save as ..................................................................................................................................................... 7

File actions – Export to S19 ............................................................................................................................................ 7

File actions – Create a backup file .................................................................................................................................. 7

File actions – Show vector information........................................................................................................................... 7

File actions – Import XML descriptor .............................................................................................................................. 7

File actions – Import tuning package .............................................................................................................................. 7

File actions – Edit a tuning package ................................................................................................................................ 7

File actions – Settings – Application settings................................................................................................................... 8

File actions – Settings – Application settings – Auto size new mapwindows..................................................................... 8

File actions – Settings – Application settings – Auto size columns in mapviewer .............................................................. 8

File actions – Settings – Application settings – Show graphs in mapviewer ...................................................................... 8

File actions – Settings – Application settings – Show addresses in hex ............................................................................. 8

File actions – Settings – Application settings – Auto load last file on start-up................................................................... 8

File actions – Settings – Application settings – Fancy docking.......................................................................................... 9

File actions – Settings – Application settings – Auto dock maps from same file ................................................................ 9

File actions – Settings – Application settings – Auto dock maps with same name............................................................. 9

File actions – Settings – Application settings – New panels are floating ........................................................................... 9

File actions – Settings – Application settings – Auto update checksum ............................................................................ 9

File actions – Settings – Application settings – Synchronize mapviewers ......................................................................... 9

File actions – Settings – Application settings – Default view size for maps ....................................................................... 9

File actions – Settings – Application settings – Default view type for maps ...................................................................... 9

Document created by Dilemma 2011 2/33

T8 Suite user manual 1.2.6

File actions – Settings – Application settings – Request a note on changes ...................................................................... 9

File actions – Settings – Application settings – Project folder .......................................................................................... 9

File actions – Settings – Application settings – Auto generate LogWorks file after session ............................................... 9

File actions – Settings – Application settings – CANBus interface..................................................................................... 9

File actions – Toggle full screen .................................................................................................................................... 10

File projects – Create a project ........................................................................................................................... 11

File projects – Open a project ............................................................................................................................. 11

File projects – Close project ................................................................................................................................ 12

File projects – Show transaction log ................................................................................................................... 13

File projects – Roll back/undo ............................................................................................................................. 13

File projects – Roll forward/redo ......................................................................................................................... 13

File projects – Rebuild file ................................................................................................................................... 13

File projects – Edit project ................................................................................................................................... 13

File projects – Add note to project...................................................................................................................... 14

File projects – Show project logbook .................................................................................................................. 14

File projects – Produce latest binary ................................................................................................................... 14

Actions menu............................................................................................................................................................. 15

Actions menu – Verify checksum ........................................................................................................................ 15

Actions menu – Firmware information ................................................................................................................ 15

Actions menu – Firmware information – Engine type.................................................................................................... 16

Actions menu – Firmware information – Software version ............................................................................................ 16

Actions menu – Firmware information – Immobilizer code ........................................................................................... 16

Actions menu – Firmware information – Chassis ID ...................................................................................................... 16

Actions menu – Browse axis information............................................................................................................ 16

Actions menu – VIN decoder ............................................................................................................................... 17

Actions menu – Compare with another binary ................................................................................................... 17

Actions menu – Transfer maps to another binary.............................................................................................. 18

Actions menu – Binary compare ......................................................................................................................... 18

Actions menu – Export map to excel .................................................................................................................. 19

Actions menu – Import map from excel ............................................................................................................. 19

Actions menu – Import SRAM file (not implemented yet) ................................................................................ 19

Document created by Dilemma 2011 3/33

T8 Suite user manual 1.2.6

Actions menu – Extract symboltable ................................................................................................................... 19

Actions menu – View file in hex .......................................................................................................................... 19

Actions menu – Search map content .................................................................................................................. 20

Actions menu – Show airmass result .................................................................................................................. 21

Tuning menu ............................................................................................................................................................. 23

Actions menu – Tune me up ............................................................................................................................... 23

Actions menu – maps .......................................................................................................................................... 23

Real-time menu ......................................................................................................................................................... 24

Real-time – Toggle real-time panel..................................................................................................................... 24

Real-time – Export file to LogWorks ................................................................................................................... 25

Real-time – Write log marker .............................................................................................................................. 26

Real-time – Get SRAM snapshot ......................................................................................................................... 26

Real-time – Download binary from ECU ............................................................................................................. 26

Real-time – Flash ECU ......................................................................................................................................... 26

Help menu ................................................................................................................................................................. 27

Selecting symbols ............................................................................................................................................................. 28

Searching for information in the views .............................................................................................................................. 28

Filtering information......................................................................................................................................................... 29

Sorting information .......................................................................................................................................................... 30

Editing maps .................................................................................................................................................................... 31

hexadecimal mode ...................................................................................................................................................... 31

Color indicators ........................................................................................................................................................... 31

Adjusting values in a map ............................................................................................................................................ 33

Document created by Dilemma 2011 4/33

T8 Suite user manual 1.2.6

PURPOSE AND SCOPE

By using this document users are assured to use the correct functionality of the software. The
information from this document should be followed as stated and compared with expected output
from the software.

REFERENCES
This section references, by identity and title, documents that facts in this document depend upon.
Those documents are not necessarily the latest version.

Document Title Rev

Analyzing Trionic 8 with T8Suite Trionic 8 1.03

G ENERAL INFORMATION
Thank you for downloading and installing T8Suite. In this manual you will find an overview of the
most commonly used functions. After starting T8Suite a splash screen will be displayed and after all
components are loaded and the application is initialized the main screen will be displayed.

Document created by Dilemma 2011 5/33

T8 Suite user manual 1.2.6

The top menu is a ribbon style menu also found in the latest Microsoft Office environments. It allows
you to navigate through the available options quickly and easily. This first chapter will show you
around the available options one by one.

FILE MENU

FILE ACTIONS – OPEN A BINARY FILE

This option allows you to open a binary file. T8Suite will automatically extract all the relevant
information from the file after selecting it in the open file dialog.

Once the file is opened and all information is extracted the symbol list on the left hand side of the
main screen will be filled with information.

Note that by default there is a filter active on the view, showing only the symbol that are actually
stored in flash memory (e.g. flash address > 0). You can disable this filter by clicking the little cross in
the bottom left hand side of the symbollist.

Document created by Dilemma 2011 6/33

T8 Suite user manual 1.2.6

FILE ACTIONS – EXIT T8S UITE

Exits the application in a safe manner.

FILE ACTIONS – SAVE AS

This lets you choose a different location and/or filename for the binary file you currently have open.

FILE ACTIONS – EXPORT TO S19

This allows you to save the binary file in Motorola S19 format which can be used to program the ECU
with a BDM interface.

FILE ACTIONS – CREATE A BACKUP FILE

Lets you create a backup file for the binary at this point. It is wise to create backups before you start
to make big changes to your file. If a project is opened, the backup file will be stored within the
project folder otherwise it will be stored in the folder where the bin file is located.

FILE ACTIONS – SHOW VECTOR INFORMATION

This is a little tool for techies. It shows the start-up vector information for the Motorola MC68337
microprocessor.

FILE ACTIONS – IMPORT XML DESCRIPTOR

Lets you import a symboltable from an existing XML file. Binaries without a symboltable can be user-
described and if you have an XML file for your binary file you can import it with this function.

FILE ACTIONS – IMPORT TUNING PACKAGE

Lets you import a tuning package which holds generic map information.

FILE ACTIONS – EDIT A TUNING PACKAGE

If you want to remove maps from a tuning package or you want to add maps, you can edit the tuning
package with this option.

Document created by Dilemma 2011 7/33

T8 Suite user manual 1.2.6

FILE ACTIONS – SETTINGS – A PPLICATION SETTINGS

This will show the options screen for T8Suite.

FILE ACTIONS – SETTINGS – A PPLICATION SETTINGS – A UTO SIZE NEW MAPWINDOWS

Determines whether or not new map windows will automatically be resized to fit their respective
contents.

FILE ACTIONS – SETTINGS – A PPLICATION SETTINGS – A UTO SIZE COLUMNS IN MAPVIEWER

Determines whether or not the map viewers should try to resize the columns they contain to make the
content fit. As you can imagine ignition advance for example expressed in whole and fractional
degrees takes more space than a simple decimal number ranging from 0-10.

FILE ACTIONS – SETTINGS – A PPLICATION SETTINGS – S HOW GRAPHS IN MAPVIEWER

To gain performance in lightweight computers you can switch off the graphical display in the
mapviewer altogether with this option.

FILE ACTIONS – SETTINGS – A PPLICATION SETTINGS – S HOW ADDRESSES IN HEX

T8Suite can display addresses and lengths of symbols in decimal form or in hexadecimal form. This
option allows you to switch between the two.

FILE ACTIONS – SETTINGS – A PPLICATION SETTINGS – A UTO LOAD LAST FILE ON START-UP
If you work on one file for a prolonged period of time you might want T8Suite to reopen the last file
automatically when you start it. This option allows you to control that behaviour. If the last opened
item was a project, T8Suite will automatically reopen that project for you at start-up.

Document created by Dilemma 2011 8/33

T8 Suite user manual 1.2.6

FILE ACTIONS – SETTINGS – A PPLICATION SETTINGS – FANCY DOCKING

If the dragging and docking of windows (map viewers) is slow or causes issues, please turn this
option off.

FILE ACTIONS – SETTINGS – A PPLICATION SETTINGS – A UTO DOCK MAPS FROM SAME FILE
If you open more than one map from the same file (for example fuel and ignition maps) you can
choose to have those docked together using this option. If the option is turned off, windows will be
tiled next to each other.

FILE ACTIONS – SETTINGS – A PPLICATION SETTINGS – A UTO DOCK MAPS WITH SAME NAME
If you open the same maps from different files (for example the main ignition map from 2 files) you
can choose to have those docked together using this option. If the option is turned off, windows will
be tiled next to each other.

FILE ACTIONS – SETTINGS – A PPLICATION SETTINGS – N EW PANELS ARE FLOATING

Upon opening a new mapviewer you can choose to have this window docked in the main screen or
have it floating.

FILE ACTIONS – SETTINGS – A PPLICATION SETTINGS – A UTO UPDATE CHECKSUM

Having this checked will rid you of the constant worry whether or not the checksum of your file is
valid. We advise you to keep this turned on!

FILE ACTIONS – SETTINGS – A PPLICATION SETTINGS – SYNCHRONIZE MAPVIEWERS

With this enabled, T8Suite will try to keep multiple opened mapviewers synchronized with eachother.
Cell selections, graph rotation etc will be done in all open mapviewers.

FILE ACTIONS – SETTINGS – A PPLICATION SETTINGS – D EFAULT VIEW SIZE FOR MAPS
Allows you to adjust the map viewers size for different screen resolutions.

FILE ACTIONS – SETTINGS – A PPLICATION SETTINGS – D EFAULT VIEW TYPE FOR MAPS
Easy view is best if you don’t know what this means ;)

FILE ACTIONS – SETTINGS – A PPLICATION SETTINGS – R EQUEST A NOTE ON CHANGES

If you are working in a project you can have T8Suite ask you for a comment every time you make a
change to one of the maps. This way, you can keep track of changes very easily.

FILE ACTIONS – SETTINGS – A PPLICATION SETTINGS – PROJECT FOLDER

Allows you to set an alternate project root folder for creating projects. You can use this if you want all
the projects to be located on a separate disk partition for example.

FILE ACTIONS – SETTINGS – A PPLICATION SETTINGS – A UTO GENERATE LOG WORKS FILE AFTER SESSION
If you run a live session on your ECU with the canbus connection, T8Suite can automatically generate
a LogWorks file from that session and start LogWorks (not yet implemented)

FILE ACTIONS – SETTINGS – A PPLICATION SETTINGS – CANBUS INTERFACE

Three devices are currently supported, the Lawicel device (www.canusb.com) and the multi-adapter
that has a canbus interface a BDM interface, 5 AD inputs and a thermocouple input, both designed by
ecuproject members. The multi-adapter will require more configuration so when this is selected, the

Document created by Dilemma 2011 9/33

T8 Suite user manual 1.2.6

extra configuration button next to the drop down box will be enabled. By selecting it you can set the
extra options.

FILE ACTIONS – TOGGLE FULL SCREEN

Lets you run T8Suite full screen for maximum usage of screen space.

Document created by Dilemma 2011 10/33

T8 Suite user manual 1.2.6

FILE PROJECTS – CREATE A PROJECT

T8Suite allows you to work on your tune in a project based fashion. This option lets you create a new
project. Projects have the advantage of having roll-back and roll-forward functions, having versioning
and keeping things tidy and together. You are advised to work in a project if you do more than simple
easy-tune your binary file.

FILE PROJECTS – OPEN A PROJECT

Lets you select and open a previously created project. If no projects are available (none were created
before) T8Suite will notify you with a message box.

Document created by Dilemma 2011 11/33

T8 Suite user manual 1.2.6

FILE PROJECTS – CLOSE PROJECT

Closed the project and allows you to work on single files again.

Document created by Dilemma 2011 12/33

T8 Suite user manual 1.2.6

FILE PROJECTS – SHOW TRANSACTION LOG

Shows the transaction log for the current project. Since a project contains only one binary file, you
could see this as an undo/redo list for the project binary file.

FILE PROJECTS – ROLL BACK/ UNDO

Lets you rollback the last transaction made to the binary file. If no transactions are available to
rollback, the button will be disabled.

FILE PROJECTS – ROLL FORWARD/ REDO

Lets you roll forward (redo) the last transaction that was undone/rolled back. If no transaction are
available to roll forward, the button will be disabled.

FILE PROJECTS – REBUILD FILE

This enables you to rebuild a project file (binary) up to a certain point in time. T8Suite will ask you

for a date and it will restore – if possible – the file that you had at that specific date.

FILE PROJECTS – EDIT PROJECT

Lets you edit the project properties for any project. This enables you to manage your version
numbering yourself. Version numbers are stored, together with all other project properties, in the xml
file in the project folder.

Document created by Dilemma 2011 13/33

T8 Suite user manual 1.2.6

FILE PROJECTS – ADD NOTE TO PROJECT

You can add a note to you project with a timestamp attached to it, so you can keep track of changes
you made in your setup. For example, if you start using different injectors or mount a bigger
intercooler, you can enter a note of this into the project log for later reference.

FILE PROJECTS – SHOW PROJECT LOGBOOK

Shows you in details what has happened in your project.

FILE PROJECTS – PRODUCE LATEST BINARY

Lets you export the project binary in its current state so you can save it in another location easily.

Document created by Dilemma 2011 14/33

T8 Suite user manual 1.2.6

ACTIONS MENU

ACTIONS MENU – VERIFY CHECKSUM

If you don’t have the automatic checksum routine turned on, you can manually verify and correct the
files checksum with this option.

ACTIONS MENU – F IRMWARE INFORMATION

Lets you alter the settings for the current binary file.

Document created by Dilemma 2011 15/33

T8 Suite user manual 1.2.6

A CTIONS MENU – FIRMWARE INFORMATION – ENGINE TYPE

Descriptive text for the current binary file.

A CTIONS MENU – FIRMWARE INFORMATION – SOFTWARE VERSION

Default software version numbering for the current binary file.

A CTIONS MENU – FIRMWARE INFORMATION – IMMOBILIZER CODE

Current immobilizer code for this binary file. For more information about immo code please refer to
the saab technical documentation.

A CTIONS MENU – FIRMWARE INFORMATION – CHASSIS ID

Vehicle Identification Number (VIN) for the current binary file. Should match you cars VIN number.

ACTIONS MENU – BROWSE AXIS INFORMATION

Shows you the relations between maps and axis symbols. This is very informative to browse and
learn.

Document created by Dilemma 2011 16/33

T8 Suite user manual 1.2.6

ACTIONS MENU – VIN DECODER

Lets you decode SAAB VIN numbers into readable format.

ACTIONS MENU – COMPARE WITH ANOTHER BINARY

The most time-consuming thing is comparing maps for different firmware versions by hand. T8Suite
gives you the tools to compare maps in different binaries with a click of the mouse. To do this you
must first open the primary binary you want to compare. Then, select “Compare maps with other
binary” from the Actions menu under Actions. Now, select the secondary binary you wish to compare
the first one with. T8Suite will now display a list of symbols that differ in the selected binaries.

Document created by Dilemma 2011 17/33

T8 Suite user manual 1.2.6

ACTIONS MENU – TRANSFER MAPS TO ANOTHER BINARY

To be able to transfer map contents from a selected binary to another one a wizard has been created
to copy all the contents for all symbols in the selected binary to another one that the wizard enables
you to select.

ACTIONS MENU – BINARY COMPARE

Lets you do a binary (byte-by-byte) compare of two files. This is a good tool to verify whether a
programming session was successful or not. Sequences of steps would be:

1. Program ECU

2. Read file from ECU

3. Compare original and downloaded file with Binary compare.

If the result screen is empty the files are identical (successful programming).

Document created by Dilemma 2011 18/33

T8 Suite user manual 1.2.6

ACTIONS MENU – EXPORT MAP TO EXCEL

For easy export and import facilities an interface with MS Excel has been implemented into T8Suite.
This option lets you export a selected map to Excel for viewing and editing.

ACTIONS MENU – IMPORT MAP FROM EXCEL

For easy export and import facilities an interface with MS Excel has been implemented into T8Suite.
This option lets you import a selected map to Excel.

ACTIONS MENU – IMPORT SRAM FILE (NOT IMPLEMENTED YET )

ACTIONS MENU – EXTRACT SYMBOLTABLE

This option allows you to extract the symbol information from the loaded binary file. Normally T8Suite
will automatically do this for you, but with this option you can force it to (re-) extract the information.

ACTIONS MENU – VIEW FILE IN HEX

Lets you explore the binary file in hexadecimal form (advanced users!)

Document created by Dilemma 2011 19/33

T8 Suite user manual 1.2.6

ACTIONS MENU – SEARCH MAP CONTENT

Allows you to search maps for a specific value. The result will be shown in a list.

Document created by Dilemma 2011 20/33

T8 Suite user manual 1.2.6

ACTIONS MENU – SHOW AIRMASS RESULT

T8Suite incorporates a function to verify the final (estimated) airmass results based on the most
common airmass and torque limiters). The result from these calculations are shown in a table that
also shows the limiter that is holding more airmass per combustion back.

Document created by Dilemma 2011 21/33

T8 Suite user manual 1.2.6

Document created by Dilemma 2011 22/33

T8 Suite user manual 1.2.6

T UNING MENU

ACTIONS MENU – TUNE ME UP

Lets you alter the binary file to match a certain torque and power. This is an automated wizard that
changes all the relevant maps for you. Please DO make sure that you have the hardware to support
what you enter in the wizards input screen. If you go above a stage 3 configuration, please also make
sure that your AFR values are in range and your EGT does not go over 950 degrees celcius.

ACTIONS MENU – MAPS

Lets you directly start a mapviewer with the specific map for quick access to the most imporant maps.

Document created by Dilemma 2011 23/33

T8 Suite user manual 1.2.6

REAL-TIME MENU

REAL-TIME – TOGGLE REAL -TIME PANEL

Allows you to start a real-time session. If all connections are done well, T8Suite should be able to
connect to the ECU and show you real-time information. You can move symbols up and down in the
real-time free-logging list with CTRL-UP and CTRL-DOWN.

Document created by Dilemma 2011 24/33

T8 Suite user manual 1.2.6

nightpanel mode

REAL-TIME – EXPORT FILE TO LOGWORKS

Will convert and export logged data (a t8l file) to LogWorks format and start LogWorks with that file
automatically.

Document created by Dilemma 2011 25/33

T8 Suite user manual 1.2.6

REAL-TIME – WRITE LOG MARKER

While running a real-time session this enables you to write a marker in the log which you can track
back easily later on.

REAL-TIME – GET SRAM SNAPSHOT

Lets you download the ECUs working memory as a snapshot for comparing and backup.

REAL-TIME – DOWNLOAD BINARY FROM ECU

Downloads the flash content from the connected ECU. Please note that this will take approximately 20
minutes to complete. Progress will be shown in the lower right corner of T8Suite’s main screen.

REAL-TIME – FLASH ECU

Flashes a given binary file to the connected ECU. Please note that this will take approximately 10
minutes to complete. Progress will be shown in the lower right corner of T8Suite’s main screen.

Document created by Dilemma 2011 26/33

T8 Suite user manual 1.2.6

HELP MENU

Document created by Dilemma 2011 27/33

T8 Suite user manual 1.2.6

SELECTING SYMBOLS

After the symbol list has been displayed you can choose a symbol from the list by double clicking it or
by highlighting it and pressing <enter>. Whenever you do this a new panel is shown with the
detailled information about the symbol in question.

This panel will look something like in Image 3.

IMAGE 1: SYMBOL DISPLAYED IN EDITOR

SEARCHING FOR INFORMATION IN THE VIEWS

The used data viewers all support something called “incremental searching”. If you select a value in
one of the views and start typing the name or address you are looking for the view will automatically

Document created by Dilemma 2011 28/33

T8 Suite user manual 1.2.6

scroll to the given entry (best match). You normally should have the column you are searching in as
the primary sort column. To do this just click on the columnheader of the column in question.

IMAGE 2: INCREMENTAL SEARCH IN ACTION

FILTERING INFORMATION

You can easily filter information in the views by selecting the little filter image in the column header
and choosing one of the options. The most elaborate filters can be defined in “custom” of course.
Here’s a sample.

Document created by Dilemma 2011 29/33

T8 Suite user manual 1.2.6

IMAGE 3: CUSTOM FILTER

SORTING INFORMATION
Information can be sorted ascending or descending by clicking the column header you want to sort
on.

Document created by Dilemma 2011 30/33

T8 Suite user manual 1.2.6

EDITING MAPS

HEXADECIMAL MODE

When you select “View tables in Hex” in the ribbon menu under Actions, Options all maps will be
displayed in hexadecimal values. If you don’t really know how to interpret hexadecimal number, you
can also switch do decimal mode by unchecking the “View tables in Hex” option. This setting will be
stored and retrieved the next time the application is started. In the images below you can see the
difference of viewing in hex or in decimal format.

COLOR INDICATORS

You can adjust how the maps are displayed to some extend. By default all maps will be displayed
having color from green (low values) to red (high values). If you find this confusing you can check the
“Show red and white maps” option in Actions, Options and the maps will be displayed using red only.
In the images below you can see the difference in viewing in red&green and red&white.

Document created by Dilemma 2011 31/33

T8 Suite user manual 1.2.6

Document created by Dilemma 2011 32/33

T8 Suite user manual 1.2.6

ADJUSTING VALUES IN A MAP

To avoid that you have to adjust all values of a “large” map manually some features have been added
to the mapeditor.

Plus key: adds 1 to all selected cells

Minus key: substracts 1 from all selected cells

PageUp key: adds 10 to all selected cells

PageDown key: substracts 10 from all selected cells

Home key: sets all selected cells to the maximal value

End key: sets all selected cells to the minimal values

To be able to get your work done faster you can selected one or more cells in a table and copy them
to the clipboard by rightclicking and selecting “Copy selected cells”.

To paste the cells select the location where you want to cells to appear – this could be in another map
and even in another binary – rightclick and select “paste selected cells” and then “At original position”
or “At currently selected location”.

Document created by Dilemma 2011 33/33