Differences

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

--- de:doc:android [2013/10/12 17:04] – created wsauer
+++ de:doc:android [2014/03/28 14:24] (current) – removed wsauer
@@ Line 1: / Line 1: @@
-====== OOBDAndroid Manual ======
-Screenshot of an older beta version
-{{:doc:android-ss.jpg?150|}}
-===== 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
-  - get the latest zip archive of OOBDAndroid from our [[https://sourceforge.net/projects/oobd/files/Mobile_Clients/Android/|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 case you have already some own personal scripts (*.lbc), store them also in that OOBD folder.
-  - 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 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.
-===== 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  |}}
-===== Mainscreen =====
-Select the script you want to run and press the round Button to start
-{{  :pics:mainscreen.png?150  |}}
-===== 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|}}    |  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 [[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.