Home > VBOX Automotive > Software applications > VBOX Test Suite > VBOX Test Suite User Guide > 02 - VBOX Test Suite Getting Started

02 - VBOX Test Suite Getting Started

Launching the software

After installation, VBOX Test Suite can be launched by selecting it from the list of programs on your computer, or by launching a configuration (.vbts) file.

When launching via the main program list, the user will be presented with a pre-loaded ‘Workspace’ and the software will be ‘Offline’ ready to accept a saved data file (.vbo or .dbn files).

If the user launches the software via a .vbts file, it will start up with the same settings that were saved within the .vbts file. This will include any open tests and their test configurations, the window layout and also the units used.

Workspace

The workspace is an area that has been designed for non-test specific file analysis and is automatically loaded every time the software is launched. The Workspace can be used in both offline and online modes and contains 3 main areas, as described below.

 

Workspace.png

 

Extra workspaces can be added via the 'Add Test' button or by adding a new test tab and selecting the ‘Workspace’ icon in the home tab.

The Dashboard

The dashboard is an area where the user can display live or post process data on a series of gauges, as well starting, stopping and resetting tests when in online mode.

 

There are 5 main types of gauge types:-

  • Default – A standard alpha numeric representation of the data.
  • Chart – A line graph representation of the data.
  • Target – A cursor indicates the data value on a user specified number line.
  • Angular Meter – A ‘needle’ type gauge that displays the data value on a circular gauge.
  • Level – The data is displayed as a % fill of a bar.
     

These gauges are demonstrated in the image below.

 

Dashboard.png

The Chart Area

The chart area is an area that allows the user to see a graphical representation of the data contained within a file.

 

7.png

 

Within this chart area it is possible to create a custom graph of one channel vs another (for example speed against time), as well as add multiple channels on one common X-Axis.

Note: The chart area will only be populated from post process data and will not display a live plot of the data. If a live plot is required, the user must use a 'Chart' gauge in the dashboard.

The Map Area

The map area is an area that shows a positional trace from the saved data contained within a file.

 

8.png

 

Note: The map area will only be populated from post process data and will not display a live plot of the data. If a live plot is required, the user must add a 'Position' gauge to the dashboard.

Viewing a saved file

To view a saved file, the user must first ensure that they are in 'Offline' mode. This is done by selecting the 'Offline' button on the home tab of the ribbon bar.
 

41.png

 

Once offline, the user can load a file by either pressing the 'Load' button on the ribbon bar, or the 'Load data' option from the file menu. Once either of these options have been selected, a file browser window will be displayed, allow the user to select a previously saved file (.vbo or .dbn). Opening the desired file will automatically load the data into all open tests, automatically populating the chart and test areas.

Viewing Live VBOX Data

To view live data from a VBOX, the user must first connect to the VBOX and be in 'Online' mode. This is done by selecting the online button on the ribbon bar. Once selected, a drop down menu will appear that allows the user to choose a COM port to connect to.

 

42.png

 

Once the software is connected to a VBOX, the dashboard gauges will automatically start to display the data being sent live over the VBOX’s serial stream.

In online mode, start, stop and reset buttons will appear on the dashboard. These buttons are used to start, stop and reset any open tests.

 

Note: The COM port selection can be cancelled before the software has fully opened online communications. This is done by selecting the X button at the bottom left of the software window, as shown below.

 

Session1.png

Saving Live VBOX Data

  Save as VBO1.png

Whilst in 'Online' mode, live VBOX data can be saved as a .vbo file when a test has been completed. To do this, once a a test has finished, navigate to the 'File' menu at the top left of the 'Ribbon' bar and select 'Save as vbo' from the dropdown.

 

This file can then be named and saved locally on a PC, enabling you to load this file in to VBOX Test Suite for analysis at a later date.

 

Note: The saved .vbo will mirror the test data stored on the CF (compact flash) card inserted into the VBOX 3i unit.

Adding/Replacing a Test

VBOX Test Suite has the ability to add in pre-defined tests. This can be done by either selecting the ‘Add’ button on the home tab or selecting the desired test from the test drop downs on the home tab.

Pressing the add button will bring up the add test window that will allow the user to browse the available tests.

 

Add Test.png

 

The add test window is split into various sections, Categories, tests, saved settings, description, version and licence.

The 'Categories' area contains the main category groups of tests, selecting a category will show the tests from that category in the 'Tests' area. The user can then select a test from the list, which will then display a short description of the test in the 'Description' area, the version number in the 'Version' area and the licence information and status in the 'Licence' area. A list of previously saved tests configurations will be displayed in the 'Saved Settings' area which the user can choose to load, or they can just load the default version of that test.

 

Once a test has been selected, a new tab will be displayed within the main software window.

For a quick way to swap the current test to a different test, VBOX Test Suite displays all the available test categories on the home tab.

 

Fav test.png

 

By selecting one of these buttons, a drop down list of all default and custom tests will be displayed to the user and selecting one of these tests will load that test configuration into the currently selected test tab.

The user can also add a new tab by clicking the ‘+’ button next to the test tab header.

 

45.png

 

Doing this will open a new, blank test tab that can then be populated using the above method.

You must to post a comment.
Last modified

Tags

Classifications

This page has no classifications.
Having trouble finding what you need?