Subversion Repositories FlightCtrl

Rev

Rev 405 | Go to most recent revision | Only display areas with differences | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

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