Subversion Repositories FlightCtrl

Rev

Details | Last modification | View Log | RSS feed

Rev Author Line No. Line
208 ligi 1
/*************************************************************************************************
2
 *
303 ligi 3
 * DUBwise
4
 * Digital UFO Broadcasting with intelligent service equipment
5
 *
250 ligi 6
 * Project to Communicate via J2ME (Mobile Phone) and Bluetooth
7
 * with a MikroKopter ( www.mikrokopter.de )
208 ligi 8
 *
9
 *
10
 * Author:        Marcus -LiGi- Bueschleb
11
 * Project-Start: 9/2007
390 ligi 12
 * Version:	  0.40
325 ligi 13
 * Mailto:        ligi
390 ligi 14
 *		  -at-
325 ligi 15
 *		  smart4mobile.de
208 ligi 16
 *
17
 * Licence:       http://creativecommons.org/licenses/by-nc-sa/2.0/de/
18
 *                (Creative Commons / Non Commercial / Share Alike)
303 ligi 19
 *		  Addtitonally to this Licence it is not allowed to use this software in any violent manner.
20
 *                This explicitly includes that lethal Weapon owning "People" (e.g. Army & Police) are not allowed to use this Project
21
 *
22
 * Disclaimer:    Use this Project at your own Risk!
23
 *
250 ligi 24
 * Credits:       Holger&Ingo for the MikroKopter Project
25
 *                CaScAdE for Testing and Graphics
26
 *                Orion8 for inspiration
208 ligi 27
 *
303 ligi 28
 * Online Link to this Document:
29
 *
208 ligi 30
 *  http://mikrocontroller.cco-ev.de/mikroviewvc/FlightCtrl/branches/ligi_j2me/README?view=markup
31
 *
32
 *************************************************************************************************/
165 ligi 33
 
250 ligi 34
*** Features:
35
 - draw Graphs with Nick integral / Roll integral / Nick acc / Roll acc
325 ligi 36
 - test each motor ( like MotorTest in MK-Tool )
250 ligi 37
 - Draw LCD of mk ( + interact with it Up/Down )
38
 - get MK_version
39
 - measure ConnectionTime / Motor=15Time / Motor>15Time ( UpTime )
303 ligi 40
 - Read and Edit Settings/Parameters from MK
325 ligi 41
 - initial Proxy Function ( send Data from MK via TCP/IP to socket )
42
 - save MK MAC - so that scanning is only needed 1x ( you have to Quit via the Menu-Item - not the systems Exit button)
43
 - reconnect after connection loss ( detection of disconnect could be faster )
250 ligi 44
 
45
*** Install:
208 ligi 46
 - If u know how to handle JAR/JADs take the ones from the bin directory.
325 ligi 47
 - If u dont visit http://www.getjar.com/products/12587/DUBwise ( SVN might be more recent)
165 ligi 48
 
250 ligi 49
*** Usage:
231 ligi 50
 General:
51
  KEY # toggle Fullscreen
303 ligi 52
  KEY * MainMenu
193 ligi 53
 
231 ligi 54
 Device selection Screen:
325 ligi 55
  KEY UP/Down to select device
231 ligi 56
 
325 ligi 57
 Telemetry Screen:
231 ligi 58
  KEY UP to go Page up in MK-LCD
59
  KEY DOWN to go Page up in MK-LCD
60
 
61
 MotorTest Screen
62
  UP/DOWN increas/decrease speed of actual motor
63
  LEFT prev motor ( if first go to main screen )
64
  RIGHT next motor
65
 
250 ligi 66
*** Tested on:
390 ligi 67
 SE  K800i
68
 SE  W800i
231 ligi 69
 
390 ligi 70
 Nokia N95
71
 Nokia 6234
72
 Nokia 6131
73
 Nokia N80
74
 Nokia 6230i ( without MK )
75
 
250 ligi 76
*** Compile:
77
 - install some tools to fullfill Compile-Dependencys ( see below )
78
 - Set the path to WTK it in build.xml
79
 - execute $> ant build
80
 - the JAR and JAD will appear in build/bin when success
81
 * see http://forum.mikrokopter.de/topic-post15829.html#post15829 for Hints on Compiling on Windows
82
 
83
*** Dependencys:
84
 Run:
85
  - The Phone needs the Bluetooth API and MIDP 2.0 .
86
  - The MK needs a Bluetooth-Modul - http://mikrokopter.de/ucwiki/F2M03GXA?action=show
87
 Compile:
88
  - WTK ( 2.2 proven to work - please test with newer )
89
  - Obfuscator (e.g. Proguard from http://sourceforge.net/project/showfiles.php?group_id=54750
90
) when willing to obfuscate
91
  - ANT
390 ligi 92
  - Ruby for some scripts around the build process
93
 
250 ligi 94
*** ToDo:
193 ligi 95
 - Proxying to TCP/IP ( GPRS / UMTS / WLAN ( e.g. N80) .. )
390 ligi 96
 - rescan
97
 - internationalize Stings
165 ligi 98
 - measure DebugSets per Second
193 ligi 99
 - log data/csv ( send via TCP/IP ; save )
165 ligi 100
 - Sound Alarms on Batt low or other triggers
314 ligi 101
 - Flash new MK Version ( with online connectivity it could be an automatic update reminder )
303 ligi 102
 - set MK-Parameters
181 ligi 103
 - making lib to be useable with desktop JAVA / will be sceduled after bluecove for linux is ready ( anounced for next Version)
210 ligi 104
 - triangulate MK by BT rssi
221 ligi 105
 - trigger cammera shot via FC
303 ligi 106
 - save/reat Parameters in/from RMS ( e.g. to copy parameters from MK2MK
107
 - Port to OpenMoko ( will do when i have such a phone ;-)
193 ligi 108
 - tbc
303 ligi 109
 
110
*** ChangeLog:
111
  0.01 - initial Version ( initialize connection / main Thread with reading data from MK)
112
  0.02 - reconnect after connection loss ( e.g. switching on/off )
113
  0.03 - added send_command ( with CRC )
114
  0.04 - added decode64 to decode 'pseudo' BASE64
115
  0.05 - added get_version
116
  0.06 - added parsing of DebugData
117
  0.07 - Code-(Doc&&Cleanup) && initial svn commit
118
  0.08 - Initial README / ToDo List
119
  0.09 - implemented BTScanner for detecting BT-Devices (No hard mac anymore for first public bin)
120
  0.10 - initial MKMinimalMidlet / Canvas
121
  0.11 - 1st public binary ( JAR/JAD)
122
  0.12 - measure Uptime ( like that word for MK being in Air ;-)
123
  0.14 - measure idling mixture
124
  0.15 - Fixed Nokia Problem 2 instead of 2.0 ..
125
  0.16 - LCD implementation & polishing code on serveral places
126
  0.17 - Quit via * | Rescan via #
127
  0.18 - Remember URL ( bt-mac ) on quit
128
  0.19 - better handling of MK Version
129
  0.23 - care for Version while parsing DebugData - MK0.64 compatible now (0.20-0.23 - n1 bugfixing With CaSCade)
130
  0.24 - adding some GFX
131
  0.25 - adding Graph ( Nick int;Roll int; nick acc ;roll acc)
132
  0.26 - more Visuals
133
  0.27 - implemented motor_test
134
  0.28 - Icon
135
  0.29 - ressources for 176x220 / Ress differencing
136
  0.30 - Load Parameters from MK
137
  0.31 - Edit Parameters ( MKParamEdit.java )
138
  0.32 - Main Menu
139
  0.33 - Bugfix / Code CleanUp
140
  0.34 - select ParamSet to edit
314 ligi 141
  0.35 - Proxy server test script
142
  0.36 - initial Proxy-function in DUBwise ( send data recieved from mk to socket )
325 ligi 143
  0.37 - write ParamSets / BugFixing
390 ligi 144
  0.38 - scrolling intro string ( some EYE-Candy )
145
  0.39 - rotation instead of clipping in main menu select
146
  0.40 - Input Values in ParameterEditor via KEY0..KEY9
147