User Tools

Site Tools


doc:android

This is an old revision of the document!


OOBDAndroid Manual

Screenshot of an older beta version

Two Words about Android Smartphones and OOBD

Before you go to spend money for your own Android phone especially for OOBD, there's one important thing to know: OOBD is using the Bluetooth SPP Profile to communicate like on a serial port with the Bluetooth OBD Dongle. But at least in several low cost Android phones this profile is NOT implemented (they supporting only e.g. Headsets), so you need to make sure that your device supports Bluetooth SPP, other ways OOBD-Android will not work!

After finding a device which supports SPP, another problem might occur: Several android device are affected by the so called “Device Zero” bug. This bug in the android bluetooth driver avoids, that our dongle can be found during the search process for new bluetooth devices. But as a work around there are some apps available which allows a manual pairing with a search before.

Installation:

  1. Install the OI Filemanager out of the Google Play Store onto your Android device
  2. get the latest zip archive of OOBDAndroid from our Download area. In that zip archive there's a complete folder named OOBD. Unpack and copy that folder with its content onto your android device into the root folder of your android SD-Card.
  3. in case you have already some own personal scripts (*.lbc), store them also in that OOBD folder.
  4. As next start the OI File- Manager, which you have installed in step 1, on your Android device. Move into the OOBD Folder which you have generated in step 2.
  5. In that OOBD folder you'll find the OOBDAndroid…apk file. Install this by selecting the file. You might get asked to allow to install software packets (like OOBD), which do not come direct out of the Play Store.
  6. After installation is done, go into your System Bluetooth settings. Make sure Bluetooth is switched on
  7. If not already done before, pair your mobile phone with the OOBD dongle, so that the dongle becomes a known device to your android device. Otherwise it would not appear in the OOBD settings.

Settings

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

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 item flags can be changed by selecting the item and keep the item pressed until a context menu pops up. There the flag to change can be selected.

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., depenting on the actual Android device settings

Bugs

As said, AndroidOOBD 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.

This website uses cookies. By using the website, you agree with storing cookies on your computer. Also you acknowledge that you have read and understand our Privacy Policy. If you do not agree leave the website.More information about cookies
doc/android.1382883988.txt.gz · Last modified: 2013/10/27 15:26 by wsauer