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