Subversion Repositories Projects

Rev

Details | Last modification | View Log | RSS feed

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