Differences between revisions 1 and 16 (spanning 15 versions)
Revision 1 as of 08.10.2007 19:20
Size: 2940
Editor: ligi
Comment:
Revision 16 as of 09.11.2009 04:03
Size: 8500
Editor: ligi
Comment: some more translation
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
= Preface: =
 * Project to Communicate via J2ME (Mobile Phone) and Bluetooth with a MikroKopter ( www.mikrokopter.de )
||<tablewidth="99%" bgcolor="#CEF6CE" style="text-align: center;"> http://mikrokopter.de/images/eng.gif '''[:en/DUBwise:English Page]''' | http://mikrokopter.de/images/deu.gif '''[:DUBwise: Deutsch]''' | http://mikrokopter.de/images/fra.gif '''[:fr/DUBwise:Français]''' ||
Line 4: Line 3:
= ChangeLog: = [[NeedsTranslation(Hier müsste noch einiges von englisch nach deutsch übersetzt werden)]]
Line 6: Line 5:
 * 0.01 - initial Version ( initialize connection / main Thread with reading data from MK)
 * 0.02 - reconnect after connection loss ( e.g. switching on/off )
 * 0.03 - added send_command ( with CRC )
 * 0.04 - added decode64 to decode 'pseudo' BASE64
 * 0.05 - added get_version
 * 0.06 - added parsing of DebugData
 * 0.07 - Code-(Doc&&Cleanup) && initial svn commit
 * 0.08 - Initial README / ToDo List
 * 0.09 - implemented BTScanner for detecting BT-Devices (No hard mac anymore for first public bin)
 * 0.10 - initial MKMinimalMidlet / Canvas
 * 0.11 - 1st public binary ( JAR/JAD)
 * 0.12 - measure Uptime ( like that word for MK being in Air ;-)
 * 0.14 - measure idling mixture
 * 0.15 - Fixed Nokia Problem 2 instead of 2.0 ..
 * 0.16 - LCD implementation & polishing code on serveral places
 * 0.17 - Quit via * | Rescan via #
 * 0.18 - Remember URL ( bt-mac ) on quit
 * 0.19 - better handling of MK Version
 * 0.23 - care for Version while parsing DebugData - MK0.64 compatible now (0.20-0.23 - n1 bugfixing With CaSCade)
 * 0.24 - adding some GFX
 * 0.25 - adding Graph ( Nick int;Roll int; nick acc ;roll acc)
 * 0.26 - more Visuals
 * 0.27 - implemented motor_test
 * 0.28 - Icon
 * 0.29 - ressources for 176x220 / Ress differencing
attachment:banner.jpg
Line 32: Line 7:
= Usage =
 * General:
  KEY # toggle Fullscreen
  KEY * to Quit
[[TableOfContents]]
Line 37: Line 9:
 * Device selection Screen:
  KEY 1..X to select device
 
 * Main Screen:
  KEY UP to go Page up in MK-LCD
  KEY DOWN to go Page up in MK-LCD
  KEY RIGHT - go to MotorTest
   
 * MotorTest Screen
  UP/DOWN increas/decrease speed of actual motor
  LEFT prev motor ( if first go to main screen )
  RIGHT next motor
   
= Tested on =
 * SE - K800i
 * Nokia - N95
 * SE - W800i
 * Nokia - 6234
 * Nokia - N80 ( Font is too Big - but API worx)
 * Nokia - 6230i ( without copter )
= Was ist DUBwise? =
 . DUBwise ist eine Software für Handys um Aufgaben rund um den MikroKopter zu erfüllen.
Line 58: Line 12:
= Compile =
 * install some tools to fullfill Compile-Dependencys ( see below )
 * Set the path to WTK it in build.xml
 * execute $> ant build
 * the JAR and JAD will appear in build/bin when success
 * see http://forum.mikrokopter.de/topic-post15829.html#post15829 for Hints on Compiling on Windows
= Was kann DUBwise? =
== J2ME Version ==
 * Sprachausgabe der aktuellen Spannung, Höhe, Flugzeit und Warnungen
 * Anzeige eines künstlichen Horizonts
 * Fliegen des MikroKopter mit den Handy-Tasten
 * Anzeige eines Graphs
 * Motor-Test
 * Das LCD des MikroKopter darstellen
 * Debugwerte anschaun
 * Parameter einsehen und ändern
 * Speichern der Parameter im Handy ( um sie z.B. schnell von MK zu MK zu kopieren )
 * "Proxy" funktion ( lässt den Kopter TCP/IP sprechen )
 * Flash MK / Navi / MK3MAG Firmware ( Experimentell und in den aktuellen versionen entfernt )
 * Verbindung via Bluetooth ( jsr-82 ) ; comport & TCP/IP ( + eine Fake Connection um sich teile von DUBwise ohne Kopter anzuschaun )
 * Vordefinierte Mixer-tabellen schreiben ( wer spezielle braucht einfach mal melden )
 * Sprachauswahl Deutsch / Englisch / Französisch ( nur für texte innerhalb DUBwise - nicht für die Audio ausgabe und die teile die vom kopter kommen )
Line 65: Line 29:
= Dependencys =
 * Run:
  - The Phone needs the Bluetooth API and MIDP 2.0 .
  - The MK needs a Bluetooth-Modul - http://mikrokopter.de/ucwiki/F2M03GXA?action=show
 * Compile:
  - WTK ( 2.2 proven to work - please test with newer )
  - Obfuscator (e.g. Proguard from http://sourceforge.net/project/showfiles.php?group_id=54750) when willing to obfuscate
  - ANT
= Download =
 * /!\ Wenn dein Handy ein Windows-Mobile Handy ist, bzw wenn der installer sich am anfang über eine fehlende jsr-82 beschwert [:DUBwiseWindowsMobile:lies hier]
 * Binaries: http://dubwise-download.appspot.com/
 * Source Code: http://github.com/ligi/DUBwise
Line 74: Line 34:
= Videos =
 . '''Video von Jamiro ( Zeigt die Sprachausgabe von DUBwise am Anfang ) ''
 . [[Vimeo(5629176)]] [[BR]]
 . '''Video by Speedy'''
 . [[Vimeo(4040325)]] [[BR]]
 . '''Screencast ( Version 0.52 - sorry for the bad audio)'''
 . [[Vimeo(3175980)]] [[BR]]
 . '''Holger Flying his MikroKopter with DUBwise:''' [[BR]]
 . [[Vimeo(2714743)]] [[BR]]
 . '''Motortest with the Android Version:''' [[BR]]
 . [[Vimeo(905980)]] [[BR]]
 '''Orientation View ( piloting screen) with the Android Version:''' [[BR]]
 . [[Vimeo(919991)]]
 . [[BR]]



= Screenshots =
 . [:en/DUBwiseJ2MEScreenShots:J2ME ScreenShots]


= Anleitungen =

== Anleitung für Key Control ==

 * 1. In den MK Settings "ExternalControl" auf z.B. 200 stellen.
 * 2. Handy mit dem MK Verbinden
 * 3. In Dubwise menüpunkt "Tastensteuerung" wählen. (Wenn alles passt laufen unten Zahlen durch)
 * 4. Mit Funke Gyros kalibrieren und Motoren starten
 * 5. Langsam Vollgas geben, Motoren drehen nur etwas schneller
 * 6. MK über Handy steuern und spaß haben.

 . /!\ Achtung1: Den Gasknüppel auf leerlauf = Notaus
 . /!\ Achtung2: Ist der Gasknüppel auf Vollgas und die Motoren laufen und man beendet den Menüpunkt "Tastensteuerung" übernimmt die Funke und der MK schießt nach oben (TODO: Bild von decke einfügen) ;)

== Verbinden ==
=== via Bluetooth ===
 it depends on the device a bit - first you should try:

 * 1.)Enable BT on your phone after switching on the MK
 * 2.)Start DUBwise
 * 3.)go to "connection -> connect via BT" to search for devices
 * 4.)Enter code (if needed)
[[BR]]
 /!\ if that fails ( e.g. DUBwise does not find the Device ) try this:
[[BR]][[BR]]
 * 1.)Enable BT on your phone after switching on the MK
 * 2.)Search for devices on your phone
 * 3.)Pair your phone with the MK
 * 4.)Start DUBwise
 * 5.)Search for devices again
 * 6.)Enter code (if needed)

== Keys ==
=== General ===
 * The star brings you back to the main menu ( /!\ If you have a touchscreen device you can touch the upper bar where the symbols are )
 * up / down / fire to select

=== In the Graph Screen ===
 * 3 -> Freeze
 * 5 -> toggle Legend
 * 7 -> toggle scale

== Touchscreen ==
 * touch on the top-bar ( where e.g. the Voltage is ) to get back to the main-menu
 * touch on an menu-item to select it - touch again to execute
 * if there is a value to edit touch on the left side to decrement and touch on the right side to increment
= Supported Devices =
 There is no complete list of supported Devices - there is just a [:en/DUBwiseTestedDevices:List of Devices where DUBwise was tested on] . If your Device is not in the list - just try it and give [:en/LiGi:me] some feedback if it worked and i'll update the list.

= Trouble Shooting =

 || ''' Problem ''' || '''Solution'''||
 || short Range || build [:en/DUBwiseRangeExtender:DUBwiseRangeExtender] ||
 || "Incompatible Device" Error || try updating your MK or Navi board to the latest Version ||
 || no Sound || check if your mobile is in silent mode or volume is at 0 ||
 || no Sound || try the version with wav or 64kbit in the filename ||
 || !KeyControl has no Effect || Check Parameter External Controll in the actual Setting ||
 || Settings are not saved || Make sure you exit DUBwise via the menu entry "quit" in the main menu ||

= Notes / Known Issues =
== General ==
 * If you configure your Bluetooth-Module with a security PIN - keep in mind that some J2ME - Mobile Phones are having Problems with PINs which are not Alpha-Numeric - so you better not use souch a PIN to prevent to have to reconfigure the Bluetooth-Module.

 * Your Settings are only saved when you close DUBwise via quit in the main menu ( Background: This should prevent you from fucking up your DUBwise installation with Settings that are not working on your Hardware )

== PhoneME specific ==
 * you have to close DUBwise via quit in the main menu! If you close via the X in the upper right you dont really close DUBwise ...

= ToDo =
== Work in Progress ==
 * Port to Android
 * Support for Wolferl-NG QuadKopter
 * trigger mobile-cammera via FC
== mid term ==
 * log data/csv ( send via TCP/IP ; save )
 * Sound Alarms on Batt low or other triggers
 * Battery Charging Log with camera and barcodes
== long term ==
 * live video & osd generation as background for the piloting screen
 * lead - function - gps on Phone and QC needed - QC always holds position in a defined distance to the phone
 * get Firmwares to flash via TCP/IP
 * making lib to be useable with desktop JAVA / will be sceduled after bluecove for linux is ready ( anounced for next Version)
 * triangulate MK by BT rssi
 * Define which !DebugValues are shown on Graph with which color ( implicit graph switch of )
Line 75: Line 140:
 * http://creativecommons.org/licenses/by-nc-sa/2.0/de/ (Creative Commons / Non Commercial / Share Alike)  * http://creativecommons.org/licenses/by-nc-sa/2.0/de/ (Creative Commons / Non Commercial / Share Alike)
 * /!\ Addtitonally to this Licence it is not allowed to use this project in any violent manner! This explicitly includes that lethal Weapon owning "People" and Organisations (e.g. Army & Police) are not allowed to use this Project.
 . [[BR]][http://support.creativecommons.org/videos#wwt http://search.creativecommons.org/images/wwt.jpg] [[BR]]

 If you wanna participate in Development have a look at [:en/DUBwiseDevelopment:this page]
 And there are several things beside Coding where you could help:
  * Translation of the Wiki page
  * Translation of DUBwise ( contact me if you are willing - i will include the translations into the code )
  * Correct my typos ;-)
  * Documentation
  * Screenshots
  * Device Tests ( Testing in general )
  * Improve Graphics
  * Improve Audio samples
  * ...
Line 81: Line 160:
 * Joko for Testing and Comments
 * ["Speedy"] for Audio Editing / Graphics & blogging about this tool
 * Jamiro for the new Icon
 * [:en/SelectaT:SelectaT] for Audio Samples and Testing
 * kmpec for lending me his Diamond
 * !JiPsi for translation to french

= DUBwise in the Media =
 * Chaos Radio Express: http://chaosradio.ccc.de/cre106.html
 * hackedgadgets.com: http://hackedgadgets.com/2008/04/19/dubwise-digital-ufo-broadcasting-with-intelligent-service-equipment/
 * Speedys blog: http://speedyweb.at/start/2007/11/05/mikrokopter-am-handy/
 * http://brum.wx.cz/index.php?option=com_content&view=article&id=59:dubwise&catid=35:mikrokopter&Itemid=2

= Discussion =
 * German Discussion @ MK Forum: http://forum.mikrokopter.de/topic-1682.html


----
 . KategorieAnleitung KategorieProjekte KategorieTools

http://mikrokopter.de/images/eng.gif [:en/DUBwise:English Page] | http://mikrokopter.de/images/deu.gif [:DUBwise: Deutsch] | http://mikrokopter.de/images/fra.gif [:fr/DUBwise:Français]

NeedsTranslation(Hier müsste noch einiges von englisch nach deutsch übersetzt werden)

attachment:banner.jpg

TableOfContents

Was ist DUBwise?

  • DUBwise ist eine Software für Handys um Aufgaben rund um den MikroKopter zu erfüllen.

Was kann DUBwise?

J2ME Version

  • Sprachausgabe der aktuellen Spannung, Höhe, Flugzeit und Warnungen
  • Anzeige eines künstlichen Horizonts
  • Fliegen des MikroKopter mit den Handy-Tasten

  • Anzeige eines Graphs
  • Motor-Test
  • Das LCD des MikroKopter darstellen

  • Debugwerte anschaun
  • Parameter einsehen und ändern
  • Speichern der Parameter im Handy ( um sie z.B. schnell von MK zu MK zu kopieren )
  • "Proxy" funktion ( lässt den Kopter TCP/IP sprechen )
  • Flash MK / Navi / MK3MAG Firmware ( Experimentell und in den aktuellen versionen entfernt )
  • Verbindung via Bluetooth ( jsr-82 ) ; comport & TCP/IP ( + eine Fake Connection um sich teile von DUBwise ohne Kopter anzuschaun )

  • Vordefinierte Mixer-tabellen schreiben ( wer spezielle braucht einfach mal melden )
  • Sprachauswahl Deutsch / Englisch / Französisch ( nur für texte innerhalb DUBwise - nicht für die Audio ausgabe und die teile die vom kopter kommen )

Download

Videos

Screenshots

Anleitungen

Anleitung für Key Control

  • 1. In den MK Settings "ExternalControl" auf z.B. 200 stellen.

  • 2. Handy mit dem MK Verbinden
  • 3. In Dubwise menüpunkt "Tastensteuerung" wählen. (Wenn alles passt laufen unten Zahlen durch)
  • 4. Mit Funke Gyros kalibrieren und Motoren starten
  • 5. Langsam Vollgas geben, Motoren drehen nur etwas schneller
  • 6. MK über Handy steuern und spaß haben.
  • /!\ Achtung1: Den Gasknüppel auf leerlauf = Notaus

  • /!\ Achtung2: Ist der Gasknüppel auf Vollgas und die Motoren laufen und man beendet den Menüpunkt "Tastensteuerung" übernimmt die Funke und der MK schießt nach oben (TODO: Bild von decke einfügen) ;)

Verbinden

via Bluetooth

  • it depends on the device a bit - first you should try:
  • 1.)Enable BT on your phone after switching on the MK
  • 2.)Start DUBwise
  • 3.)go to "connection -> connect via BT" to search for devices

  • 4.)Enter code (if needed)

BR

  • /!\ if that fails ( e.g. DUBwise does not find the Device ) try this:

BRBR

  • 1.)Enable BT on your phone after switching on the MK
  • 2.)Search for devices on your phone
  • 3.)Pair your phone with the MK
  • 4.)Start DUBwise
  • 5.)Search for devices again
  • 6.)Enter code (if needed)

Keys

General

  • The star brings you back to the main menu ( /!\ If you have a touchscreen device you can touch the upper bar where the symbols are )

  • up / down / fire to select

In the Graph Screen

  • 3 -> Freeze

  • 5 -> toggle Legend

  • 7 -> toggle scale

Touchscreen

  • touch on the top-bar ( where e.g. the Voltage is ) to get back to the main-menu
  • touch on an menu-item to select it - touch again to execute
  • if there is a value to edit touch on the left side to decrement and touch on the right side to increment

Supported Devices

  • There is no complete list of supported Devices - there is just a [:en/DUBwiseTestedDevices:List of Devices where DUBwise was tested on] . If your Device is not in the list - just try it and give [:en/LiGi:me] some feedback if it worked and i'll update the list.

Trouble Shooting

  • Problem

    Solution

    short Range

    build [:en/DUBwiseRangeExtender:DUBwiseRangeExtender]

    "Incompatible Device" Error

    try updating your MK or Navi board to the latest Version

    no Sound

    check if your mobile is in silent mode or volume is at 0

    no Sound

    try the version with wav or 64kbit in the filename

    KeyControl has no Effect

    Check Parameter External Controll in the actual Setting

    Settings are not saved

    Make sure you exit DUBwise via the menu entry "quit" in the main menu

Notes / Known Issues

General

  • If you configure your Bluetooth-Module with a security PIN - keep in mind that some J2ME - Mobile Phones are having Problems with PINs which are not Alpha-Numeric - so you better not use souch a PIN to prevent to have to reconfigure the Bluetooth-Module.
  • Your Settings are only saved when you close DUBwise via quit in the main menu ( Background: This should prevent you from fucking up your DUBwise installation with Settings that are not working on your Hardware )

PhoneME specific

  • you have to close DUBwise via quit in the main menu! If you close via the X in the upper right you dont really close DUBwise ...

ToDo

Work in Progress

  • Port to Android
  • Support for Wolferl-NG QuadKopter

  • trigger mobile-cammera via FC

mid term

  • log data/csv ( send via TCP/IP ; save )
  • Sound Alarms on Batt low or other triggers
  • Battery Charging Log with camera and barcodes

long term

  • live video & osd generation as background for the piloting screen

  • lead - function - gps on Phone and QC needed - QC always holds position in a defined distance to the phone
  • get Firmwares to flash via TCP/IP
  • making lib to be useable with desktop JAVA / will be sceduled after bluecove for linux is ready ( anounced for next Version)
  • triangulate MK by BT rssi
  • Define which DebugValues are shown on Graph with which color ( implicit graph switch of )

Licence

  • http://creativecommons.org/licenses/by-nc-sa/2.0/de/ (Creative Commons / Non Commercial / Share Alike)

  • /!\ Addtitonally to this Licence it is not allowed to use this project in any violent manner! This explicitly includes that lethal Weapon owning "People" and Organisations (e.g. Army & Police) are not allowed to use this Project.

  • BR[http://support.creativecommons.org/videos#wwt http://search.creativecommons.org/images/wwt.jpg] BR

    If you wanna participate in Development have a look at [:en/DUBwiseDevelopment:this page] And there are several things beside Coding where you could help:

    • Translation of the Wiki page
    • Translation of DUBwise ( contact me if you are willing - i will include the translations into the code )
    • Correct my typos ;-)

    • Documentation
    • Screenshots
    • Device Tests ( Testing in general )
    • Improve Graphics
    • Improve Audio samples
    • ...

Credits:

  • Holger&Ingo for the MikroKopter Project

  • CaScAdE for Testing and Graphics
  • Orion8 for inspiration
  • Joko for Testing and Comments
  • ["Speedy"] for Audio Editing / Graphics & blogging about this tool

  • Jamiro for the new Icon
  • [:en/SelectaT:SelectaT] for Audio Samples and Testing

  • kmpec for lending me his Diamond
  • JiPsi for translation to french

DUBwise in the Media

Discussion