Unterschiede zwischen den Revisionen 2 und 17 (über 15 Versionen hinweg)
Revision 2 vom 08.10.2007 19:23
Größe: 2952
Autor: ligi
Kommentar:
Revision 17 vom 09.11.2009 18:14
Größe: 8581
Autor: nebukad
Kommentar: nur ein bisschen uebersetzt
Gelöschter Text ist auf diese Art markiert. Hinzugefügter Text ist auf diese Art markiert.
Zeile 1: Zeile 1:
= Preface: =
 * DUBwise == Digital UFO Broadcasting with intelligent service equipment
 * Project to Communicate via J2ME (Mobile Phone) and Bluetooth with a MikroKopter ( www.mikrokopter.de )
= ChangeLog: =
 * 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
= Usage =
 * General:
  . KEY # toggle Fullscreen KEY * to Quit
 * 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 )
= 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
= 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
||<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]''' ||
[[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 =
 * /!\ 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
= Videos =
 . '''Video von Jamiro ( Zeigt die Sprachausgabe von DUBwise am Anfang ) '''''''
 . [[Vimeo(5629176)]]
 [[BR]]
 . Video von Speedy''' '''
 . [[Vimeo(4040325)]]
 [[BR]]
 . Screencast ( Version 0.52 - sorry for the bad audio)''' '''
 . [[Vimeo(3175980)]]
 [[BR]]
 . Holger steuert seinen MikroKopter mit DUBwise:''' [[BR]] '''
 . [[Vimeo(2714743)]]
 [[BR]]
 . Motortest mit der 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 ===
 . es kommt immer etwas auf das Geraet an- als Erstes sollte man folgendermassen vorgehen:
 * 1.)Nachdem der MK eingeschaltet wurde, Bluetooth auf dem Handy aktivieren
 * 2.)DUBwise starten
 * 3.)"connection" waehlen -> "connect via BT", um nach Geraeten zu suchen
 * 4.)Sicherheits-Code eingeben(falls benoetigt)
[[BR]]

 . /!\ Wenn diese Vorgehensweise nicht funktioniert ( z.B. weil DUBwise das Geraet nicht findet), sollte man Folgendes versuchen:
[[BR]][[BR]]

 * 1.)Nachdem der MK eingeschaltet wurde, Bluetooth auf dem Handy aktivieren
 * 2.)Mit dem Handy nach BLuetooth-Geraeten suchen
 * 3.)Das Handy mit dem MK "paaren"
 * 4.)DUBwise starten
 * 5.)wieder nach Geraeten suchen
 * 6.)Sicherheits-Code eingeben(falls benoetigt)
== 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 )
Zeile 62: Zeile 125:
 * /!\ 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 ] [[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
  * ...
Zeile 66: Zeile 142:
 * 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

  • es kommt immer etwas auf das Geraet an- als Erstes sollte man folgendermassen vorgehen:
  • 1.)Nachdem der MK eingeschaltet wurde, Bluetooth auf dem Handy aktivieren
  • 2.)DUBwise starten
  • 3.)"connection" waehlen -> "connect via BT", um nach Geraeten zu suchen

  • 4.)Sicherheits-Code eingeben(falls benoetigt)

BR

  • /!\ Wenn diese Vorgehensweise nicht funktioniert ( z.B. weil DUBwise das Geraet nicht findet), sollte man Folgendes versuchen:

BRBR

  • 1.)Nachdem der MK eingeschaltet wurde, Bluetooth auf dem Handy aktivieren
  • 2.)Mit dem Handy nach BLuetooth-Geraeten suchen
  • 3.)Das Handy mit dem MK "paaren"
  • 4.)DUBwise starten
  • 5.)wieder nach Geraeten suchen
  • 6.)Sicherheits-Code eingeben(falls benoetigt)

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 ] 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