Subversion Repositories FlightCtrl

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

 *

 * DUBwise

 * Digital UFO Broadcasting with intelligent service equipment

 *

 * Project to Communicate via J2ME (Mobile Phone) and Bluetooth

 * with a MikroKopter ( www.mikrokopter.de )

 *

 *

 * Author:        Marcus -LiGi- Bueschleb

 * Project-Start: 9/2007

 * Version:	  0.42

 * Mailto:        ligi

 *		  <-/AT/->

 *		  smart4mobile.de

 *

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

 *                (Creative Commons / Non Commercial / Share Alike)

 *		  Addtitonally to this Licence it is not allowed to use this software in any violent manner.

 *                This explicitly includes that lethal Weapon owning "People" (e.g. Army & Police) are not allowed to use this Project

 *		  If you want to use this tool in any Commercial Context - please contact me first!

 *

 * Disclaimer:    Use this Project at your own Risk!

 *

 * Credits:       Holger&Ingo for the MikroKopter Project

 *                CaScAdE for Testing and Graphics

 *                Orion8 for inspiration

 *                Joko for Testing and Comments

 *                Thomas Fitchen for equipping me with my first RC stuff

 *

 * Online Links:

 *

 *  -this Document (Subversion):

 *   http://mikrocontroller.cco-ev.de/mikrosvn/FlightCtrl/branches/ligi_j2me/README

 *

 *  -Wiki:

 *   http://mikrokopter.de/ucwiki/en/DUBwise

 *

 *  -Forum ( German Discussion around DUBwise ):

 *   http://forum.mikrokopter.de/topic-1682.html

 *

 *  -GetJar:

 *   http://www.getjar.com/products/12587/DUBwise

 *

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

*** Features:

 - draw Graphs with Nick integral / Roll integral / Nick acc / Roll acc

 - test each motor ( like MotorTest in MK-Tool )

 - Draw LCD of mk ( + interact with it Up/Down )

 - Fly the MikroKopter ( you nees GPS and a special MK-Version )

 - View all DebugValues

 - measure ConnectionTime / Motor=15Time / Motor>15Time ( UpTime )

 - Read and Edit Settings/Parameters from MK

 - initial Proxy Function ( send Data from MK via TCP/IP to socket )

 - save MK MAC/Name - so that scanning is only needed once ( you have to Quit via the Menu-Item - not the systems Exit button or simply turning the Phone off)

 - get MK_version

 - reconnect after connection loss ( detection of disconnect could be faster )

*** 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/DUBwise ( SVN might be more recent)

*** Usage:

 General:

  KEY # toggle Fullscreen

  KEY * MainMenu

 Device selection Screen:

  KEY UP/Down to select device

 Telemetry Screen:

  KEY UP to go Page up in MK-LCD

  KEY DOWN to go Page up in MK-LCD

 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

 SE  W800i

 SE  W810i

 SE  K610i

 Nokia N95

 Nokia N80

 Nokia N73

 Nokia 6234

 Nokia 6131

 Nokia 6300

 Nokia 6230

 Nokia 6230i ( without MK )

*** 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

  - Ruby for some scripts around the build process

*** ToDo:

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

 - internationalize Stings

 - measure DebugSets per Second

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

 - Sound Alarms on Batt low or other triggers

 - Flash new MK Version via this Tool ( with online connectivity it could be an automatic update reminder )

 - 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 mobile-cammera via FC

 - save/reat Parameters in/from RMS ( e.g. to copy parameters from MK 2 MK )

 - Port to Android ( will do when i have such a phone ;-)

 - tbc

*** 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

  0.30 - Load Parameters from MK

  0.31 - Edit Parameters ( MKParamEdit.java )

  0.32 - Main Menu

  0.33 - Bugfix / Code CleanUp

  0.34 - select ParamSet to edit

  0.35 - Proxy server test script

  0.36 - initial Proxy-function in DUBwise ( send data recieved from mk to socket )

  0.37 - write ParamSets / BugFixing

  0.38 - scrolling intro string ( some EYE-Candy )

  0.39 - rotation instead of clipping in main menu select

  0.40 - Input Values in ParameterEditor via KEY0..KEY9

  0.41 - block motortest values > 255 / BugFixes / better Parameter Input

  0.42 - Display UBatt and SenderOkay

       - RAW Debug Mode

       - BugFixes ( e.g. SetPoint in ParamsParser was wrong )

       - using newer Antenna Preprocessor so that version has to be changed only once

       - KeyControl -> send KeyEvents as BitField from mobile to FC in order to control the MK

       - Vibration on Connection loss

       - StarField BackGround

       - Fixing Bluetooth Image & Activity Indicator