Differences

This shows you the differences between two versions of the page.

--- doc:android [2011/08/27 16:18] – [The Output Pane] admin
+++ doc:android [2013/10/27 15:26] – wsauer
@@ Line 1: / Line 1: @@
 ====== OOBDAndroid Manual ======
-Attention: OOBDAndroid is still in Beta state and not indented for normal users - this version and this documentation is only for geeks :-)
+Screenshot of an older beta version
 {{:doc:android-ss.jpg?150|}}
-===== Are you a geek? =====
+===== Two Words about Android Smartphones and OOBD =====
-If you understand the installation instructions below, then you are.. if not, just wait for the final version ;-)
+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: =====
+  - Install the [[https://play.google.com/store/apps/details?id=org.openintents.filemanager|OI Filemanager]] out of the Google Play Store onto your Android device
-  - Unpack the {{:doc:oobdandroid_beta.zip|zip archive}} into the root folder of your android SD-Card.
+  - get the latest zip archive of OOBDAndroid from our [[http://code.google.com/p/oobd/downloads/list|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**. \\ {{  :doc:oi-filemanager.png?w=180  |  }}
-  - In the new created OOBD directory you'll find the file "buscom.props". In there set the BTDevice to the MAC Adress of your OOBD dongle in the same syntax as shown ("AA:BB:CC..."). Make sure that you use a editor which is able to handle UTF8 unix files correctly
+  - in case you have already some own personal scripts (*.lbc), store them also in that OOBD folder.
-  - make sure that you've paired your mobile with the OOBD dongle, so that it is a known device
+  - 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.
-  - make sure Bluetooth is switched as active when starting OOBD-Android
+  - 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. \\ {{  :doc:oi-filemanager2.png?w=180  |  }}
-  - In the OOBD folder you'll find the OOBDAndroid...apk file. Install this on your mobile
+  - After installation is done, go into your System Bluetooth settings. Make sure Bluetooth is switched on
-  - copy your personal scripts (*.lbc) also in the OOBD folder
+  - 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 ;-)
+{{  :pics:settings.png?150  |}}
-If you now start the OOBD App, it should automatically connect to the given Bluetooth device.
 ===== Mainscreen =====
-{{:pics:mainscreen.png?150|}}
+Select the script you want to run and press the round Button to start
-At startup you should see a short message "Bluetooth connect". If not, something is wrong.
+{{  :pics:mainscreen.png?150  |}}
-Select the script you want to run and press the "Start Diagnose" Button
-===== Settings =====
-The settings screen (available when you press the menu button) is actual without function
 ===== The Diagnose Screen =====
-{{:pics:diagnose.png?150|}}
+{{  :pics:diagnose.png?150  |}}
 The Diagnose screen consists of two tabbed panes, the Diagnose pane  and the Output pane
@@ Line 98: / Line 97: @@
 ====== Bugs ======
-As said, AndroidOOBD is still in beta state. If something seems to be wrong or is not working as expected, please check the [[http://sourceforge.net/apps/trac/oobd/report/9||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.
+As said, AndroidOOBD is still in beta state. If something seems to be wrong or is not working as expected, please check the [[http://code.google.com/p/oobd/issues/list|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.