» Tools4Mobile.de » httpd4mobile » Online Manual

httpd4mobile Online Manual Version 1

1. Installation

1.1 Automatische Installation via Handy Download

Starten des Browsers auf dem Handy und Eingabe folgender URL: http://www.tools4mobile.de/httpd4mobile.jad

Es wird nun das Java Descriptor File heruntergeladen und anhand des Mime Typs erkennt das Handy, dass es sich um eine Java Midlet handelt. Je nach Handytyp kommt eine Abfrage ob Sie dieses nicht-signierte MIDlet installieren möchten. Diese Abfrage bitte mit "JA" quittieren. Danach lädt er sich noch automatisch das benötigte JAR File herunter. Wechseln Sie in Ihr MIDlet Programmverzeichnis, es sollte sich darin das Programm httpd4mobile mit dem tools4mobile Icon befinden.

1.2 Manuelle Installation

Für die manuelle Installation werden die beiden Files httpd4mobile.jad und httpd4mobile.jar benötigt. Diese zwei Files können Sie unter http://www.tools4mobile.de/download downloaden.

Bauen Sie eine physikalische Verbindung via Bluetooth, IrDA oder USB Kabel zu Ihrem Handy auf. Kopieren Sie die Files dann in Ihr MIDlet Programmverzeichnis. Je nach Handy wird anhand der JAD Dateiendung erkannt das es sich um ein Java MIDlet handelt und entsprechend dargestellt.

1.3 Installation per MMS

Theoretisch sollte es auch möglich sein Java MIDlets per MMS zu übertragen. Dies konnte ich aber leider noch nicht praktisch durchführen da ich noch kein Handy gefunden habe was außer Multimedia Inhalte wie Video,Audio und Pictures auch Java MIDlets versenden konnte.

1.4 Installation per SMS

Sie senden eine SMS an das Handy wo httpd4mobile installiert werden soll mit folgendem Hyperlinktext: http://www.tools4mobile.de/httpd4mobile.jad. Viele Handys stellen die URL dann als direkten Link in der SMS da, den man dann einfach nur noch aufrufen muss. Der Installationsablauf entspricht dem im Punkt 1.1.

2. Starten

Wechseln Sie in Ihr MIDlet Programmverzeichnis und klicken Sie auf den httpd4mobile Eintrag. (siehe Abbildung 1)

Hinweis:Vor dem Start von httpd4mobile bitte die einzelnen Programmrechte überprüfen. Bitte beachten, falls die Verbindung nicht über ein privates Netz geht sondern wie in den meisten Fällen über das Internet haben theoretisch alle Personen die Möglichkeit auf Ihr Handy zuzugreifen. Deswegen sollte man vor dem Start die MIDlet Rechte des Programmes überprüfen und gegebenenfalls einschränken. Normalerweise werden bei nicht signierten MIDlets wie httpd4mobile je nach Handytyp und OS die Programmrechte von Haus aus eingeschränkt. Dadurch kann es auch gut möglich sein das je nach Art der Funktionen, die man für httpd4mobile verwenden möchte, die Rechte vorher noch manuell angepasst werden müssen. Gehen Sie aber bitte sehr sorgsam mit der Programmrechtevergabe um.


Abbildung 1

Nach dem Start des httpd4mobile MIDlets erscheint bei der unregistrierten Version der Startdialog mit den Lizenzbestimmungen. Lesen Sie diesen bitte durch und bestätigen Sie bei Akzeptanz der Bestimmungen mit „Weiter“. Mit „Exit“ können Sie das MIDlet beenden. (siehe Abbildung 2)


Abbildung 2


3. Konfiguration

3.1 Konfigurationsmenü 1

Im Konfigurationsmenü 1 (siehe Abbildung 3) können Sie folgende Einstellungen vornehmen.

  • DynDNS Registrierung (optional). Vorteil: Sie sind immer unter ein und demselben Domainnamen erreichbar, auch wenn Sie von Ihrem Provider keine statischen IP Adressen bekommen. Falls Sie noch keinen DynDNS Account haben können Sie sich einen unter http://www.dyndns.org anlegen.

  • Data Traffic Begrenzung (optional). Derzeit ist der Internet-Datentarif via GPRS/UMTS noch relativ teuer. Um die Online-Kosten nicht in die Höhe zu treiben, kann man sich ein Datenlimit setzen. Ist dieses erreicht, werden von httpd4mobile keine neuen Verbindungsanfragen (HTTP Requests) mehr angenommen. Dieses Limit wird in KB angegeben.

  • Data Storage (required). Hier geben Sie das Laufwerk an wo sich Ihr htdocs Root Verzeichnis befindet. Normalerweise müssen Sie da nichts ändern, da defaultmässig „E:/“ das Card Storage bei fast allen mobilen Geräten ist. Falls das htdocs noch nicht vorhanden ist wird es von httpd4mobile automatisch auf den entsprechenden Storage angelegt.



  • Abbildung 3

    Durch bestätigen mit „Weiter“ kommen Sie in das Konfigurationsmenü 2.
    „Exit“ beendet das httpd4mobile MIDlet.
    „Help“ es erscheint ein Hilfefenster.

    3.2 Konfigurationsmenü 2

    Im Konfigurationsmenü 2 (siehe Abbildung 4) können Sie folgende Einstellungen vornehmen.

    Module functionDescription
    CAM PictureHandy Kamera als Webcam benutzen
    Audio RecordAudioaufnahme über das Handy Microphone
    Contact ListAnzeigen von Contact,ToDO und Event Einträgen im Webbrowser. Download der Einträge als vcard, vcalendar für den Import in Outlook.
    Send SMSSMS Versand über Webbrowser
    File DownloadAnzeige der Dateien vom Handy als Link im Webbrowser für den Download auf den PC
    File UploadUpload von Dateien vom PC zum Handy
    Phone InfosAllgemeine Informationen über das Handy anzeigen lassen
    Phone JokesVia Webbrowser Vibrationsalarm, Flash und Sound auf dem Handy aktivieren
    Server Statushttpd4mobile Server Status anzeigen lassen
    Server LogLogs aller Zugriffe in einer HTML Tabelle ausgeben



    Abbildung 4

    Durch bestätigen mit „Start“ wird httpd4mobile aktiviert und es erscheint das Statusfenster
    “Exit“ beendet das httpd4mobile MIDlet
    „Help“ es erscheint ein Hilfefenster

    4. Betrieb

    Während der Laufzeit von httpd4mobile wird ein sekündlich aktualisiertes Fenster(siehe Abbildung 5) mit Statusinformationen angezeigt.

    AusgabeparameterBeschreibung
    IPIP Adresse des Servers unter welcher er für die Clients erreichbar ist. Da es sich um ein Web-Server handelt kann man Ihn somit mit jedem Webbrowser unter http://ipadresse erreichen. Der Server läuft auf Standard Port 80.
    Total TrafficGesamter Data Traffic in KB wird angezeigt
    Incoming TrafficEingehender (HTTP Requests) Data Traffic in KB wird angezeigt
    Outgoing TrafficAusgehender (HTTP Response) Data Traffic in KB wird angezeigt
    ConnectionsAnzahl der gesamten bisherigen Verbindungen= Anzahl der HTTP Requests
    Active_ConnAnzahl der momentan offenen Verbindungen
    Root Pathhttpd4mobile Root Verzeichnis
    0>nGibt das bisherige verbrauchte und die Grösse der Begrenzung des Datenvolumens an welches, erreicht werden darf. n<< -1 = keine Begrenzung aktiv



    Abbildung 5

    “Exit“ beendet das httpd4mobile MIDlet
    „Help“ es erscheint ein Hilfefenster

    5. Webfrontend

    Als Einstiegsseite http://server oder http://server/index.html wird das Webfrontend geladen. Die einzelnen HTML Seiten befinden sich direkt im httpd4mobile.jar File. In der linken Menüleiste sind die einzelnen von httpd4mobile aktivierten Funktionen abrufbar. (siehe Abbildung 6)


    Abbildung 6

    5.1 CAM Picture

    Klicken Sie bitte auf den Menüpunkt "CAM Picture". Es wird die URL http://server/cam aufgerufen. httpd4mobile interpretiert /cam als Funktion und erzeugt ein Screenshot mit der Handycam und sendet das aufgenommene Foto als HTTP Response an den Browser zurück welches dann im Webfrontend angezeigt wird. (siehe Abbildung 7)


    Abbildung 7

    5.2 Audio Record

    Klicken Sie bitte auf den Menüpunkt "Audio Record". Es erscheint eine Seite mit einem Formular zur Eingabe der Aufnahmedauer. Der Maximalwert für die Aufnahmedauer beträgt 30 Sekunden. Nach dem bestätigen der Eingabe über den "Start" Button wird die entsprechende URL http://server/audio?dauer=aufnahmedauer>" ausgeführt. Dabei wird über das Handymikrofon eine Aufnahme gestartet und danach als HTTP Response an das Webfrontend gesendet und entsprechend abgespielt.


    Abbildung 8

    5.3 Send SMS

    Klicken Sie bitte auf den Menüpunkt "Send SMS". Es erscheint eine Seite mit den Formularfeldern für die Eingabe der Telefonnummer und des SMS Textes(siehe Abbildung 9). Über den Button "SMS Absenden" wird folgende URL mit den Parametern tel=telefonummer und message=SMS Text als POST Request http://server/sms an httpd4mobile gesendet. httpd4mobile liest die Parameter aus dem Post Request aus und generiert daraus eine SMS die über das Handy verschickt wird. Die Absenderadresse der SMS ist immer die Handy Nummer auf dem httpd4mobile gestartet ist. Nach Versand der SMS wird an das Webfrontend ein Status zurückgegeben z.B SMS Versand an Empfänger tel:+5550000 mit folgender Nachricht >Das ist eine Test SMS < war erfolgreich.


    Abbildung 9

    5.4 File Upload

    Klicken Sie bitte auf den Menüpunkt "File Upload". Die URL http://server/fileupload.html wird geladen. Es erscheint ein Formular mit einem Durchsuchen Button (Browse Dialog) zur Auswahl der Datei die auf das Handy übertragen werden soll (siehe Abbildung 10). Über den Button "Upload" wird die URL mit der Datei als POST Request http://server/upload an httpd4mobile übertragen. httpd4mobile liest aus dem Request die Datei aus und speichert diese im /laufwerk/htdocs/upload als Datei entsprechend ab. Als HTTP Response wird an das Webfrontend eine Statusmeldung über den Upload Vorgang gesendet z.B Datei wurde nach file:///E:/htdocs/upload/Daten.txt übertragen.


    Abbildung 10

    5.5 File Download

    Klicken Sie bitte auf den Menüpunkt "File Download". Folgende URL http://server/laufwerke wird aufgerufen. Als HTTP Response erscheint eine Seite (siehe Abbildung 11) die in verschiedene Teile gegliedert ist. Erster Teil ist eine Tabelle mit Info über die Grösse der einzelnen Speicherdevices. Die restlichen Abschnitte geben den Inhalt verschiedener Dateiverzeichnise (htdocs,photo,video,audio usw) als Download Link aus. Die einzelnen Dateien kann man über den entsprechenden Link direkt von der Webseite aus aufrufen. Diese werden dann in ein seperaten Browser Fenster geladen bzw. angezeigt.


    Abbildung 11

    5.6 Contact list

    Klicken Sie bitte auf den Menüpunkt "Contact list". Folgende URL http://server/contacts wird aufgerufen und als HTTP Response eine Seite (siehe Abbildung 12) mit einen Formular zum Anlegen einfacher Adressbucheinträge sowie eine Tabelle vorhandener Adressbuch- und Kalendereinträge angezeigt. Die Einträge in der Tabelle kann man über einen Download Link für jeden einzelnen Adressbuch- oder Kalendereintrag entsürechend herunterladen und dadurch einfach in viele Mail Programme wie z.B Outlook importieren. Zum Anlegen neuer Kontakte gibt es drei Formularfelder Vorname,Name und Telefonummer. Mit dem "Absenden" Button wird die URL http://server//pimentry?vorname=Max&nachname=Mustermann&telefon=012345678 an httpd4mobile übertragen und ein neuer Kontakt auf dem Handy angelegt. Danach wird eine Statusmeldung an das Webfrontend als HTTP Response übermittelt z.B Anlegen des Kontaktes(Vorname:Max Nachname:Mustermann Tel:012345678 war erfolgreich


    Abbildung 12

    5.7 Phone Jokes

    Klicken Sie bitte auf den Menüpunkt "Phone Jokes". Die URL http://server/jokes.html wird geladen und eine Seite (siehe Abbildung 13) mit drei verschiedenen Formularen (Vibrationsalarm,Flash und Töne abspielen) angezeigt. Über den Button "Vibrationsalarm" wird folgende URL http://server/vibration?vibration=in_sekunden an httpd4mobile gesendet und danach der Vibrationsalarm auf dem Handy ausgelöst. Durch betätigen des "Flash" Buttons wird die URL http://server//flash?flash=in_sekunden an httpd4mobile übermittelt und das Flash auf dem Handy für die entsprechende Dauer aktiviert. Über den Button "Töne abspielen" URL: http://server/tone?tone=Wert_zwischen_0-127&dauer=in_sekunden ist es möglich einen Ton auf dem Handy abzuspielen. Als HTTP Response wird vom httpd4mobile an das Webfrontend eine Statusinformation gesendet z.B Vibrationsalarm wurde für 10 Sekunden aktiviert.


    Abbildung 13

    5.8 Phone Info

    Klicken Sie bitte auf den Menüpunkt "Phone Info". Es wird die URL http://server/info geladen und eine Seite (siehe Abbildung 14) mit verschiedenen Handy Informationen in Tabellenform angezeigt.


    Abbildung 14

    5.9 Server Status

    Klicken Sie bitte auf den Menüpunkt "Server Status". Folgende URL http://server/status wird aufgerufen. Als HTTP Response wird eine Seite (siehe Abbildung 15) mit httpd4mobile Status-Connectioninformationen und dem HTTP Requestheader angezeigt.


    Abbildung 15

    5.10 Server Log

    Klicken Sie bitte auf den Menüpunkt "Server Log". Hierbei wird folgende URL http://server/logs geladen. Im Webfrontend wird die Seite (siehe Abbildung 16) mit den bisher bearbeiteten HTTP Requests in Tabellenform angezeigt. Jeder Log Eintrag enthält nachstehende Parameter: Zeitstempel, Client_IP, Request, Responsecode, Anzahl_Bytes_Request, Anzahl_Bytes_Response, User Agent --> Beispiel: Sun Apr 08 12:53:45 UTC 2007 127.0.0.1 GET / HTTP/1.1 200 /372 662 Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322)


    Abbildung 16

    5.11 Fehlerseiten

    Bei Aufruf einer nicht aktivierten httpd4mobile Funktion wird der HTTP Responsecode, 403 Forbidden, mit dem Requestheader im Webfrontend angezeigt (siehe Abbildung 17). Kann eine URL aufgrund der fehlenden Daten nicht geladen werden, wird der HTTP Responsecode 404 Error im Webfrontend ausgegeben. (siehe Abbildung 18)


    Abbildung 17




    Abbildung 18