User Tools

Site Tools


doc:startup_javame
no way to compare when less than two revisions

Differences

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


doc:startup_javame [2014/03/02 09:07] (current) – created admin
Line 1: Line 1:
 +====== OOBD-ME: The OOBD Mobile Edition ======
  
 +(Attention: Because of the big price decrease of android phones, the JavaME version is not anymore in active development. This page is kept for history reason only)
 +
 +OOBD-ME allows on Java enabled mobile phones to hide complex communication with a Bluetooth device behind a simple user interface. All the menus and functions are not static, they are fully programmable instead through an build-in Lua interpreter.
 +
 +So to add new functionality, you don't need another program, you just have to load another script :-)
 +
 +===== Installation =====
 +
 +
 +Just copy the [[https://sourceforge.net/projects/oobd/files/| OOBD-ME.jar]] file onto your mobile phone as executable java- program. How this works is different for each mobile, so please follow the instruction in your user manual. If it's not described there: Good luck... ;-)
 +
 +===== Usage =====
 +
 +
 +The main form offers three menu commands:
 +
 +
 +==== Config ====
 +
 +
 +The following settings can be made and will automatically be saved automatically (except the blind mode), until you going to re-install the program.
 +
 +{{:pics:oobd-config.png|}}
 +
 +  * Bluetooth Device: This starts a bluetooth device discovery search, after which you can select your device. Please be patient, as this search can take a while..
 +  * OOBD Lua Script: Here you can select the OOBD Lua file, which contains the menus and functionality. If you don't choose your own file, the build in default will be used.
 +  * Blind Mode: This is only for testing purposes, as it overwrites the Bluetooth connection sequence and you can start the script menu also without beeing connected to a OBD device (which makes, as said, only sense for testing). This setting is not stored, so the blind mode is always "off" at program start.
 +
 +==== Start ====
 +
 +This will load the script menu after trying to connect to the Bluetooth device.
 +
 +{{:pics:oobdme-window.png|}}
 +
 +==== Exit ====
 +
 +
 +Guess what this is...
 +===== Requests & Bug reports =====
 +
 +
 +If you would like to report a bug, please use the [[http://code.google.com/p/oobd/issues/list|OOBD Bugtracker]]
 +===== The Script Menu =====
 +
 +
 +As said, the interface is fully programmable. The available functions are shown as a list and simple called just by selecting the list entry. Depending on the actual functionality of the loaded program this starts e.g. a request to the Bluetooth device or opens another Menu.
 +
 +
 +===== Write your own scripts =====
 +
 +as you can see in the [[http://code.google.com/p/oobd/source/browse/trunk/clients/OOBD-ME/testscripts/OOBD.lua|OOBD.lua]] sample, the programming itself is quite straightforward. You do not need to know how to do Bluetooth communication on a mobile phone, this is all done by OOBD-ME itself, you can focus on the data exchange itself.
 +
 +
 +To write your own scripts, please follow the instruction in the [[lua_start|Lua Programming]] section.
 +
 +
 +Transfer the resulting <myprogram>.lbc on your mobile and select it in the Config.
doc/startup_javame.txt · Last modified: 2014/03/02 09:07 by admin