Subversion Repositories Projects

Compare Revisions

Regard whitespace Rev 2 → Rev 3

/DUBwise/README
0,0 → 1,174
/*************************************************************************************************
*
* 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