Subversion Repositories FlightCtrl

/*************************************************************************************************

 *

 * Project to Communicate via J2ME and Bluetooth with a MikroKopter (www.mikrokopter.de )

 *

 *

 * Author:        Marcus -LiGi- Bueschleb

 * Project-Start: 9/2007

 * Version:	  0.17

 * Mailto:        ligi@smart4mobile.de

 *

 * Licence:       http://creativecommons.org/licenses/by-nc-sa/2.0/de/

 *                (Creative Commons / Non Commercial / Share Alike)

 * Big Up:        Holger&Ingo

 *

 * ChangeLog:

 *  0.01 - initial Version ( initialize connection / main Thread with reading data from MK)

 *  0.02 - reconnect after connection loss ( e.g. switching on/off )

 *  0.03 - added send_command ( with CRC )

 *  0.04 - added decode64 to decode 'pseudo' BASE64

 *  0.05 - added get_version

 *  0.06 - added parsing of DebugData

 *  0.07 - Code-(Doc&&Cleanup) && initial svn commit

 *  0.08 - Initial README / ToDo List

 *  0.09 - implemented BTScanner for detecting BT-Devices (No hard mac anymore for first public bin)

 *  0.10 - initial MKMinimalMidlet / Canvas

 *  0.11 - 1st public binary ( JAR/JAD)

 *  0.12 - measure Uptime ( like that word for MK being in Air ;-)

 *  0.14 - measure idling mixture

 *  0.15 - Fixed Nokia Problem 2 instead of 2.0 ..

 *  0.16 - LCD implementation & polishing code on serveral places

 *  0.17 - Quit via * | Rescan via #

 *  0.18 - Remember URL ( bt-mac ) on quit

 *  0.19 - better handling of MK Version

 *  0.23 - care for Version while parsing DebugData - MK0.64 compatible now (0.20-0.23 - n1 bugfixing With CaSCade)

 *  0.24 - adding some GFX

 *  0.25 - adding Graph ( Nick int;Roll int; nick acc ;roll acc)

 *  0.26 - more Visuals

 *  0.27 - implemented motor_test

 *  0.28 - Icon

 *  0.29 - ressources for 176x220 / Ress differencing

 *

 * Online Link to this Document:

 *  http://mikrocontroller.cco-ev.de/mikroviewvc/FlightCtrl/branches/ligi_j2me/README?view=markup

 *

 *************************************************************************************************/

Install:

 - If u know how to handle JAR/JADs take the ones from the bin directory.

 - If u dont visit http://www.getjar.com/products/12587/MKMiniMidlet ( SVN might be more recent)

Compile:

 - install some tools to fullfill Compile-Dependencys ( see below )

 - Set the path to WTK it in build.xml

 - execute $> ant build

 - the JAR and JAD will appear in build/bin when success

 * see http://forum.mikrokopter.de/topic-post15829.html#post15829 for Hints on Compiling on Windows

Dependencys:

 Run:

  - The Phone needs the Bluetooth API and MIDP 2.0 .

  - The MK needs a Bluetooth-Modul - http://mikrokopter.de/ucwiki/F2M03GXA?action=show

 Compile:

  - WTK ( 2.2 proven to work - please test with newer )

  - Obfuscator (e.g. Proguard from http://sourceforge.net/project/showfiles.php?group_id=54750

) when willing to obfuscate

  - ANT

Usage:

 General:

  KEY # toggle Fullscreen

  KEY * to Quit

 Device selection Screen:

  KEY 1..X to select device

 Main Screen:

  KEY UP to go Page up in MK-LCD

  KEY DOWN to go Page up in MK-LCD

  KEY RIGHT - go to MotorTest

 MotorTest Screen

  UP/DOWN increas/decrease speed of actual motor

  LEFT prev motor ( if first go to main screen )

  RIGHT next motor

Tested on:

 SE - K800i

 Nokia - N95

 SE - W800i

 Nokia - 6234

 Nokia - N80 ( Font is too Big - but API worx)

 Nokia - 6230i ( without copter )

ToDo:

 - Proxying to TCP/IP ( GPRS / UMTS / WLAN ( e.g. N80) .. )

 - measure DebugSets per Second

 - log data/csv ( send via TCP/IP ; save )

 - Sound Alarms on Batt low or other triggers

 - get/set MK-Parameters

 - Visualisation of DebugData

 - making lib to be useable with desktop JAVA / will be sceduled after bluecove for linux is ready ( anounced for next Version)

 - triangulate MK by BT rssi

 - trigger cammera shot via FC

 - tbc