Subversion Repositories FlightCtrl

Rev

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

Rev 210 Rev 221
1
/*************************************************************************************************
1
/*************************************************************************************************
2
 *
2
 *
3
 * Project to Communicate via J2ME and Bluetooth with a MikroKopter (www.mikrokopter.de )
3
 * Project to Communicate via J2ME and Bluetooth with a MikroKopter (www.mikrokopter.de )
4
 * 
4
 * 
5
 *
5
 *
6
 * Author:        Marcus -LiGi- Bueschleb
6
 * Author:        Marcus -LiGi- Bueschleb
7
 * Project-Start: 9/2007
7
 * Project-Start: 9/2007
8
 * Version:	  0.17
8
 * Version:	  0.17
9
 * Mailto:        ligi@smart4mobile.de
9
 * Mailto:        ligi@smart4mobile.de
10
 *
10
 *
11
 * Licence:       http://creativecommons.org/licenses/by-nc-sa/2.0/de/
11
 * Licence:       http://creativecommons.org/licenses/by-nc-sa/2.0/de/
12
 *                (Creative Commons / Non Commercial / Share Alike) 
12
 *                (Creative Commons / Non Commercial / Share Alike) 
13
 * Big Up:        Holger&Ingo
13
 * Big Up:        Holger&Ingo
14
 *
14
 *
15
 * ChangeLog:
15
 * ChangeLog:
16
 *  0.01 - initial Version ( initialize connection / main Thread with reading data from MK)
16
 *  0.01 - initial Version ( initialize connection / main Thread with reading data from MK)
17
 *  0.02 - reconnect after connection loss ( e.g. switching on/off )
17
 *  0.02 - reconnect after connection loss ( e.g. switching on/off )
18
 *  0.03 - added send_command ( with CRC )
18
 *  0.03 - added send_command ( with CRC )
19
 *  0.04 - added decode64 to decode 'pseudo' BASE64
19
 *  0.04 - added decode64 to decode 'pseudo' BASE64
20
 *  0.05 - added get_version
20
 *  0.05 - added get_version
21
 *  0.06 - added parsing of DebugData
21
 *  0.06 - added parsing of DebugData
22
 *  0.07 - Code-(Doc&&Cleanup) && initial svn commit
22
 *  0.07 - Code-(Doc&&Cleanup) && initial svn commit
23
 *  0.08 - Initial README / ToDo List
23
 *  0.08 - Initial README / ToDo List
24
 *  0.09 - implemented BTScanner for detecting BT-Devices (No hard mac anymore for first public bin)
24
 *  0.09 - implemented BTScanner for detecting BT-Devices (No hard mac anymore for first public bin)
25
 *  0.10 - initial MKMinimalMidlet / Canvas
25
 *  0.10 - initial MKMinimalMidlet / Canvas
26
 *  0.11 - 1st public binary ( JAR/JAD)
26
 *  0.11 - 1st public binary ( JAR/JAD)
27
 *  0.12 - measure Uptime ( like that word for MK being in Air ;-)
27
 *  0.12 - measure Uptime ( like that word for MK being in Air ;-)
28
 *  0.14 - measure idling mixture
28
 *  0.14 - measure idling mixture
29
 *  0.15 - Fixed Nokia Problem 2 instead of 2.0 ..
29
 *  0.15 - Fixed Nokia Problem 2 instead of 2.0 ..
30
 *  0.16 - LCD implementation & polishing code on serveral places
30
 *  0.16 - LCD implementation & polishing code on serveral places
31
 *  0.17 - Quit via * | Rescan via #
31
 *  0.17 - Quit via * | Rescan via #
32
 *  0.18 - Remember URL ( bt-mac ) on quit
32
 *  0.18 - Remember URL ( bt-mac ) on quit
33
 *  0.19 - better handling of MK Version 
33
 *  0.19 - better handling of MK Version 
34
 *  0.23 - care for Version while parsing DebugData - MK0.64 compatible now (0.20-0.23 - n1 bugfixing With CaSCade)
34
 *  0.23 - care for Version while parsing DebugData - MK0.64 compatible now (0.20-0.23 - n1 bugfixing With CaSCade)
-
 
35
 *  0.24 - adding some GFX 
-
 
36
 *  0.25 - adding Graph ( Nick int;Roll int; nick acc ;roll acc)
-
 
37
 *  0.26 - more Visuals
35
 *                                                                                
38
 *                                                                                
36
 * Online Link to this Document:                                                                                      
39
 * Online Link to this Document:                                                                                      
37
 *  http://mikrocontroller.cco-ev.de/mikroviewvc/FlightCtrl/branches/ligi_j2me/README?view=markup                     
40
 *  http://mikrocontroller.cco-ev.de/mikroviewvc/FlightCtrl/branches/ligi_j2me/README?view=markup                     
38
 *
41
 *
39
 *************************************************************************************************/
42
 *************************************************************************************************/
40
 
43
 
41
Install:
44
Install:
42
 - If u know how to handle JAR/JADs take the ones from the bin directory. 
45
 - If u know how to handle JAR/JADs take the ones from the bin directory. 
43
 - If u dont visit http://www.getjar.com/products/12587/MKMiniMidlet
46
 - If u dont visit http://www.getjar.com/products/12587/MKMiniMidlet ( SVN might be more recent)
44
 
47
 
45
Compile:
48
Compile:
46
 - install some tools to fullfill Compile-Dependencys ( see below )
49
 - install some tools to fullfill Compile-Dependencys ( see below )
47
 - Set the path to WTK it in build.xml 
50
 - Set the path to WTK it in build.xml 
48
 - execute $> ant build
51
 - execute $> ant build
49
 - the JAR and JAD will appear in build/bin when success
52
 - the JAR and JAD will appear in build/bin when success
50
 * see http://forum.mikrokopter.de/topic-post15829.html#post15829 for Hints on Compiling on Windows
53
 * see http://forum.mikrokopter.de/topic-post15829.html#post15829 for Hints on Compiling on Windows
51
 
54
 
52
Dependencys:
55
Dependencys:
53
 Run:
56
 Run:
54
  - The Phone needs the Bluetooth API and MIDP 2.0 .
57
  - The Phone needs the Bluetooth API and MIDP 2.0 .
55
  - The MK needs a Bluetooth-Modul - http://mikrokopter.de/ucwiki/F2M03GXA?action=show
58
  - The MK needs a Bluetooth-Modul - http://mikrokopter.de/ucwiki/F2M03GXA?action=show
56
 Compile:
59
 Compile:
57
  - WTK ( 2.2 proven to work - please test with newer )
60
  - WTK ( 2.2 proven to work - please test with newer )
58
  - Obfuscator (e.g. Proguard from http://sourceforge.net/project/showfiles.php?group_id=54750
61
  - Obfuscator (e.g. Proguard from http://sourceforge.net/project/showfiles.php?group_id=54750
59
) when willing to obfuscate 
62
) when willing to obfuscate 
60
  - ANT 
63
  - ANT 
61
  
64
  
62
Usage:
65
Usage:
63
 KEY 1..X to select device
66
 KEY 1..X to select device
64
 KEY UP to go Page up in MK-LCD
67
 KEY UP to go Page up in MK-LCD
65
 KEY DOWN to go Page up in MK-LCD
68
 KEY DOWN to go Page up in MK-LCD
66
 KEY # to Rescan
69
 KEY # toggle Fullscreen
67
 KEY * to Quit
70
 KEY * to Quit
68
 
71
 
69
Tested on:
72
Tested on:
70
 SE - K800i
73
 SE - K800i
-
 
74
 SE - W800i
71
 Nokia 6234
75
 Nokia 6234
72
 Nokia N80 ( Font is too Big - but API worx)
76
 Nokia N80 ( Font is too Big - but API worx)
73
 6230i ( without copter )
77
 6230i ( without copter )
74
 N95 ( without copter )
78
 N95 ( without copter )
75
	
79
	
76
ToDo:
80
ToDo:
77
 - Proxying to TCP/IP ( GPRS / UMTS / WLAN ( e.g. N80) .. )
81
 - Proxying to TCP/IP ( GPRS / UMTS / WLAN ( e.g. N80) .. )
78
 - measure DebugSets per Second
82
 - measure DebugSets per Second
79
 - log data/csv ( send via TCP/IP ; save )
83
 - log data/csv ( send via TCP/IP ; save )
80
 - Sound Alarms on Batt low or other triggers
84
 - Sound Alarms on Batt low or other triggers
81
 - get/set MK-Parameters
85
 - get/set MK-Parameters
82
 - Visualisation of DebugData
86
 - Visualisation of DebugData
83
 - making lib to be useable with desktop JAVA / will be sceduled after bluecove for linux is ready ( anounced for next Version)
87
 - making lib to be useable with desktop JAVA / will be sceduled after bluecove for linux is ready ( anounced for next Version)
84
 - triangulate MK by BT rssi
88
 - triangulate MK by BT rssi
-
 
89
 - trigger cammera shot via FC
85
 - tbc 
90
 - tbc 
86
 
91