User Tools

Site Tools


doc:android

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
Next revisionBoth sides next revision
doc:android [2011/08/21 17:45] admindoc:android [2013/03/26 19:16] – [One Word about Android Smartphones and OOBD] admin
Line 1: Line 1:
 ====== OOBDAndroid Manual ====== ====== 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|}} {{: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: ===== ===== Installation: =====
  
    
-  - Unpack the {{:doc:oobdandroid_beta.zip|zip archive}} into the root folder of your android SD-Card. +  - get the latest version from our [[https://sourceforge.net/projects/oobd/files/Mobile_Clients/Android/|Download area]] and unpack the zip archive into the root folder of your android SD-Card.
-  - 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+
   - make sure that you've paired your mobile with the OOBD dongle, so that it is a known device   - make sure that you've paired your mobile with the OOBD dongle, so that it is a known device
   - make sure Bluetooth is switched as active when starting OOBD-Android   - make sure Bluetooth is switched as active when starting OOBD-Android
Line 23: Line 24:
  
  
-If you now start the OOBD Appit should automatically connect to the given Bluetooth device.+===== Settings ===== 
 +Under Menu/Settings please select your OBD device. If it not appears in the listthen you've forgotten to pair it before ;-) 
 + 
 +{{:pics:settings.png?150|}}
  
 ===== Mainscreen ===== ===== Mainscreen =====
Line 29: Line 33:
 {{:pics:mainscreen.png?150|}} {{: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+Select the script you want to run and press the round Button to start
  
-===== Settings ===== 
-The settings screen (available when you press the menu button) is actual without function 
  
 ===== The Diagnose Screen ===== ===== The Diagnose Screen =====
Line 55: Line 56:
 | {{:pics:update.png|}}    Update            |  Item will be updated when the Update Button is pressed  | | {{: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:timer.png|}}    |  Permanent Update  |  Item will be updated permanently as long the Timer Toggle Button is active  |
-| {{:pics:text.png|}}      Log Changes       |  Permantent Update, value changes will be written to output  |+| {{: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  | | {{:pics:forward.png|}}  |  Submenu            No function, just a visual indicator for a further sub menu  |
  
Line 94: Line 95:
 | {{:pics:cancel.png|}}      Clear              |  Clears the textfield  | | {{:pics:cancel.png|}}      Clear              |  Clears the textfield  |
 |  -    |  Logging Active    If inactive, no futher text will be added to the output  | |  -    |  Logging Active    If inactive, no futher text will be added to the output  |
-| {{:pics:disk.png|}}    |  Save  |  Saves text to a file  | +| {{: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  |
-| {{: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  |+
  
  
 ====== Bugs ====== ====== 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.