Subversion Repositories FlightCtrl

Rev

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

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