Differences

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

--- doc:android [2011/08/06 20:58] – admin
+++ doc:android [2014/01/18 07:05] – admin
@@ Line 1: / Line 1: @@
-====== OOBDAndroid Manual ======
+====== OOBDAndroid Installation ======
-Attention: OOBDAndroid is in an early Beta state and not indented for normal users - this version and this documentation is only for geeks :-)
-{{:doc:android-ss.jpg?512|}}
+Screenshot of an older beta version
-===== Are you a geek? =====
+{{:doc:android-ss.jpg?150|}}
-If you understand the installation instructions below, then you are.. if not, just wait for the final 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: =====
+  - 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_1.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.
-  - In the OOBD folder you'll find the OOBDAndroid...apk file. Install this on your mobile
+  - 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  |  }}
+  - After installation is done, go into your System Bluetooth settings. Make sure Bluetooth is switched on
+  - 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.
-If you now start the OOBD App, it should automatically connect to the OOBD dongle and execute the script.
-If you want to use other scripts, copy them into the OOBD folder and change the filename in "enginelua.props" accordingly
+After successfully installation, please continue in [[usage|how to use OOBD]]