Table of Contents

Usage

We've tried to give both Android and Windows versions the same look & feel. So the handling instructions work for both

Pairing

On both Android and Windows the Bluetooth dongle needs to paired once before it can be used. Please follow the standard Android or Windows instructions about how to pair a Bluetooth device. The PIN number of the OOBD bluetooth devices is 1234.

Windows COM port

Under Windows the App does not directly connect to the BT dongle like on Android, it uses the COM port instead which Windows assigns to that device. That's allows also other programs like terminal programs or third parties applications to talk to the OOBD dongle.

Which COM port is assigned can be found in the Bluetooth device settings:

Settings

Under Android in some Android versions the button for the Settings is not displayed correctly. To reach the settings menu, please push and hold the standard task switcher button (the one, where you can switch between the apps) for a few seconds, this will open the settings menu also.

Under Menu/Settings please select your OBD device. If it not appears in the list then you've forgotten to pair it before ;-)

Under Windows select the COM- port, which is assigned to the dongle (as descripted above)

In Android, the scripts are fixed stored in /sdcard/OOBD. Under Windows, you can choose the script directory. The installation default directory is (your Documents)/OOBD-Scripts, but you are free to choose another one.

PGP- Settings

In case you want or you have to use PGP encrypted scripts (e.g. because of company policies), you have to import the keyfiles to be able to decrypt the encrypted scripts.

  1. From the key generation process and from your Key adminstrator you've received several files, including groupkey.sec and userkey.sec. Before starting the settings, place these two files into the script folder you want to use as script folder in this setup process.
  2. When going into the settings then, OOBD will detect the existence of these two files and flags this by naming the button as “Import Keys now”. When pressing the button, the both files will then be imported and removed from the script directory. The button text changes to “Delete keys”
  3. Now the “Use PGP” checkbox is not grayed out and can be selected. Please select. This is important to make OOBD to ask for your personal passphrase at startup. Without this passphrase you could not open any PGP file

Because of the functionality behind, you might get a new groupkey.sec from your key administrator from time to time. When this happens, copy the groupkey.sec into your script folder again and go again into settings. The button then shows “Import new group key”. By press the button, the new group keys will be imported into OOBD.

When having both groupkey.sec and userkey.sec imported, the button text says “Delete keys now”. By doing this, both keys get been deleted and would need to be re-imported again as described above to be able to use PGP again.

Important - Please Read

When you'll start OOBD the first time and push the start button, you might be quite estonished that your web browser pops up instead the UI description you'll find below.

This is because since V1.0 we've added a complete web browser interface instead the hard coded one descripted below. Nevertheless we left the documentation in to descripe the basic user elements, as you'll find simular elements in the different web application. But please be aware that each web app can have it's complete own design interface, so please see the description below as a general guideline about the programs concepts

Mainscreen

Select the script you want to run and press the round Button to start

The Diagnose Screen

The Diagnose screen consists of two tabbed panes, the Diagnose pane and the Output pane

The Diagnose Pane

The Diagose Pane contains two buttons and a list of items.

The Item list

In the Item list you'll find the description of the item, the actual value and a set of flags

The Item flags

Symbol Name Meaning
Back Indicates the jump back to the previous menu
Update Item will be updated when the Update Button is pressed
Permanent Update Item will be updated permanently as long the Timer Toggle Button is active
Log Changes When value changes, new value will be written to output
Combined with Permanent Update, this will create a continious log
Submenu No function, just a visual indicator for a further sub menu

The Update Button

The Update Button starts an update of all actual visible items, which are marked with the update flag

The Timer Button

The Timer Button updates all actual visible items permanently, which are marked with the timer flag

The Back- Button

If the user selects the Back- Button, which is part of the mobile phone itself, it is checked if the item list contains any items which are marked with the Back flag . If yes, the first found item is called, which then jumps back to the previous menu.

If no such item is found, the program jumps back to the main screen.

Changing the item flags

The Update, Timer and Log flag on an item can be changed by the user. Just hold the list item on Android or press the RMB on Windows. A context menu which will you to toggle the flag and by that the behaviour of this list item.

The Output Pane

The Output Pane contains a button row and a text field. The textfield is editable, so an output can be changed before saving or sending.

The Output functions:

Symbol Name Meaning
Clear Clears the textfield
- Logging Active If inactive, no futher text will be added to the output
Store Allows to save the text or send it by one of the available message channels like Email, Twitter etc., depending on the actual Android device settings

First Success: Trying out the OOBD Standard Script

After you have now reached this point after going through the process of installing and setup and understanding the screens of OOBD, it's now time to have a first real touch with a real vehicle with OOBD with the OOBD standard script.

Bugs

As said, OOBD is still in beta state. If something seems to be wrong or is not working as expected, please check the OOBD- Bugtracker is this is a known problem. Please feel free to add comments to the known bugs or raise new ones. Please respect that bugs reported just by email or only verbaly will not be considered.