Differences

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

--- doc:android [2011/08/27 16:16] – [The Item flags] admin
+++ doc:android [2014/01/18 07:05] – admin
@@ Line 1: / Line 1: @@
-====== OOBDAndroid Manual ======
+====== OOBDAndroid Installation ======
-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.
-If you now start the OOBD App, it should automatically connect to the given Bluetooth device.
-===== Mainscreen =====
-{{:pics:mainscreen.png?150|}}
-At startup you should see a short message "Bluetooth connect". If not, something is wrong.
-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|}}
-The Diagnose screen consists of two tabbed panes, the Diagnose pane  and the Output pane
-==== The Diagnose Pane ====
-The Diagose Pane {{:pics:oobd_32.png|}} 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  ^
-| {{:pics:back.png|}}     |  Back              |  Indicates the jump back to the previous menu  |
-| {{:pics:update.png|}}   |  Update            |  Item will be updated when the Update Button is pressed  |
-| {{:pics:timer.png|}}    |  Permanent Update  |  Item will be updated permanently as long the Timer Toggle Button is active  |
-| {{:pics:text.png|}}     |  Log Changes       |  When value changes, new value  will be written to output\\ Combined with Permanent Update, this will create a continious log  |
-| {{:pics:forward.png|}}  |  Submenu           |  No function, just a visual indicator for a further sub menu  |
-==== The Update Button  ====
-The Update Button {{:pics:update.png|}} starts an update of all actual visible items, which are marked with the update flag {{:pics:update.png?16|}}
-==== The Timer Button  ====
-The Timer Button {{:pics:timer.png|}} updates all actual visible items permanently, which are marked with the timer flag {{:pics:timer.png?16|}}
-==== 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 {{:pics:back.png?16|}}. 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 ====
-{{:pics:togglemenu.png?150|}}
-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 =====
-{{:pics:output.png?150|}}
-The Output Pane {{:pics:text.png|}} 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  ^
-| {{:pics:cancel.png|}}     |  Clear              |  Clears the textfield  |
-|  -    |  Logging Active   |  If inactive, no futher text will be added to the output  |
-| {{:pics:disk.png|}}    |  Save  |  Saves text to a file  |
-| {{:pics:forward.png|}}  |  Send Text  |  Send the text by one of the available message channels like Email, Twitter etc., depenting on the actual Android device settings  |
+After successfully installation, please continue in [[usage|how to use OOBD]]
-====== 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.