MOBOTIX AG
Luxemburger Str. 6 / Germany
67657 Kaiserslautern
http://www.mobotix.com/
Time-stamp: <2004-06-29 08:46:01 gerald> by Gerald Eberhard (MX)
$Id: README.TXT,v 1.7 2004/06/29 06:46:09 gerald Exp $


-------------------- BEGIN OF GERMAN VERSION --------------------

		  Hinweise zum Programm MXGuard V1.6
		  ==================================

* Installationshinweis
  --------------------

Bei einigen nicht deutschsprachigen Windowsversionen sind Probleme
beim Installieren des MXGuard V1.6 aufgetreten, die noch nicht
beseitigt werden konnten. In diesen Fällen empfiehlt es sich, das
Programm neu aus den Quellen zu kompilieren.


* Was ist MXGuard?
  ----------------

MXGuard ist ein kleines Programm, das auf PC mit Microsoft Windows
95/98/ME/NT4/2000/XP installiert werden kann. Mit Hilfe dieses
Programms kann eine MOBOTIX M1-Kamera über ein IP-Notify auf dem PC
ein Browserfenster mit dem aktuellen Kamerabild öffnen oder einen Text
ausgeben. Die Alarmierung kann zusätzlich mit einem akustischen Signal
verbunden werden.

Das Programm und sein Quelltext unterliegen der GNU Public License
(GPL). Siehe http://www.gnu.org/licenses/gpl.html.

MXGuard wird von MOBOTIX AG unter GPL und damit im Quellcode kostenlos
zur Verfügung gestellt. Es darf unter den Bedingungen der GPL von
jedermann weiterentwickelt werden. Wesentlichen Gegenstand der GPL
ist, dass der Quelltext nach Veränderungen wieder frei weitergegeben
wird.

Das Programm wurde mit Microsoft Visual Basic geschrieben.

Wichtiger Hinweis:
   Die Funktion "IP notify" ist im Grundmodell MOBOTIX M1 basic nicht
   enthalten. Das Program MXGuard kann daher ab Kameramodell MOBOTIX
   M1 IT verwendet werden.



* Haftungsausschluss
  ------------------

MXGuard und seine Sourcen werden von der MOBOTIX AG so wie sie sind
zur Verfügung. Ein Anspruch auf bestimmte Eigenschaften des Programms
besteht nicht.

Die Installation und Verwendung des Programms erfolgt auf eigene
Gefahr des Anwenders. Die MOBOTIX AG übernimmt keine Haftung für
Schäden, die durch Installation oder Betrieb des Programms entstehen.


* Supportausschluss
  -----------------

Für Installation, Inbetriebnahme und Betrieb des Programms wird kein
Support durch die MOBOITX AG übernommen.


* Distributionsumfang
  -------------------

README.TXT  	   - diese Text
MXGuard.zip        - komprimiertes Archiv mit Installationsprogrammen
MXGuard_Source.zip - komprimiertes Archiv mit Quelltexten (MS
gpl.txt		   - englischer Text der GNU Public License
		     (Lizenzbedingung)
gpl_deutsch.txt	   - Übersetzung der GNU Public License (nur informativ)
		     VisualBasic)


* Programminstallation auf dem PC
  -------------------------------

Systemvoraussetzungen
- Windows 95/98/ME/NT4/2000/XP
- Internetexplorer ab Version 4

Installationsschritte
- Entpacken Sie die Datei MXGuard.zip in ein leeres Verzeichnis
  ihrer Wahl.
- Starten Sie dort setup.exe und folgen Sie den Anweisungen.

Starten des Programms
- Starten Sie MXGuard über das Windows Startmenue.
- Klicken Sie mit der rechten Maustaste auf das MOBOTIX-Symbol
  in der Taskleiste um zu den Einstellungen zu gelangen oder
  die Hilfe aufzurufen.

Konfigurieren des Programms

- Klicken Sie mit der linken Maustaste auf das MOBOTIX-Symbol in der
  Taskleiste

- Geben Sie eine Portnummer an, über die die Kamera mit dem PC
  kommunizieren soll. Wählen Sie üblicherweise einen Port > 1024,
  bsplw. 8110.

- Hier können Sie auch festlegen, ob bei Eingang eines Signals ein
  Soundfile abgespielt wird.

- Durch Aktivieren von "Auch bei Textmeldungen Browser öffnen" wird
  auch bei reinen Textmeldungen (also keine gültige URL) ein Browser
  auf die IP-Adresse der sendenden Kamera geöffnet.

- Der Alarmton kann deaktiviert werden.

- Bestätigen Sie die Auswahl.


* Konfiguration der MOBOTIX M1
  ----------------------------

- Stellen Sie sicher, dass Kamera und PC über das Netzwerk
  kommunzieren können. Sie müssen ein Bild der Kamera auf Ihrem PC
  sehen können.

- Aktivieren Sie auf der Kamera einen oder mehrere Events.
  Beispielsweise unter http://<Camera-IP>/control/event den "User
  Click (UC)".

- Übernehmen Sie diese Einstellung mit "Save to Config-File".

- Aktivieren Sie "IP-Notify" (ab M1-V1.8 unter
  http://<Camera-IP>/control/message)

- Tragen Sie in das erste Feld die IP-Adresse Ihres PC mit durch
  Doppelpunkt abgetrennter Portnummer, wie oben gewählt, ein.
  Beispielsweise: 192.168.77.50:8110

- Im nächsten Feld können Sie:
  * einen Link eintragen, dann wird MXGuard eine Browser mit diesem
    Link öffnen (z. B. http://www.mobotix.com/),
  * einen Text eintragen, dann wird MXGuard ein kleines Fenster mit dem
    Text öffnen.
  * Wenn Sie die Zeile leer lassen, dann wird ein Browser mit
    Eingangsseite der Kamera geöffnet.

- Übernehmen Sie diese Einstellung mit "Save to Config-File".

- Falls die Einstellung dauerhaft bleiben soll, dann sichern Sie die
  Einstellung in den Flash-Speicher ("Store...")

- Wechseln Sie in das Benutzermenü
  http://<Camera-IP>/control/userimage.html und lösen Sie dort mit der
  Taste "UC Event" eine Event aus.

- Sofern die Konfiguration und Netzverbindung funktioniert, sollte
  daraufhin ein Fenster mit dem aktuellen Kamerabild oder die
  angegebenen URL auf dem PC erscheinen.


* Release-Informationen
  ---------------------
V1.0  Erstversion

V1.1
      - Ausgabe einer Textmeldung, falls keine gültige URL an den Port
	geschickt wird.
      - Eintreffen einer Portmeldung wird akustisch signalisiert.

V1.2
      - Akkustisches Signal
      - Browser wird nur geöffnet, wenn gültiger Link (http:// oder
	file://) oder Meldung leer ansonsten Textfenster
      Bugfixes:
      - Laufzeitfehler beseitigt, wenn angezeigter Text nicht
	quittiert wird.
      - Funktion, auch wenn kein Text eingetragen.

V1.3
      - Alarmton abschaltbar
      - Optional kann Browser auch bei reinen Textmeldungen geöffnet
	werden (Verhalten wie in V1.1)


V1.4
      - Sprachanpassung bei Installation derzeit Deutsch und Englisch
        (Voreinstellung)

V1.5
      - Absturz nach Öffnen eines zweiten Browser-Fensters bei Eingabe
	des Passworts beseitigt.

V1.6
      - Software unter GPL gestellt.
      - GNU Public License in Englisch und Deutsch beigestellt.
      - Kopfleiste in Einstellfenster zum Aufruf von Hilfe und
	Kurzdokumentation.

-------------------- END OF GERMAN VERSION --------------------


-------------------- BEGIN OF ENGLISH VERSION --------------------

		     Hints for Using MXGuard V1.6
		     ============================

* Installation Note
  -----------------

Using some non-German versions of Windows sometimes errors occure when
setting up MxGuard V1.6. This problems are not catched till now. In
that cases please rebuild the MXGuard again from its sources.


* What is MXGuard?
  ----------------

MXGuard is a simple small programm for installation on PC with
Microsoft 95/98/ME/NT4/2000/XP. Running this program a MOBOTIX M1
Camera can open on the PC a browser window using its IP Notify feature
showing the current image or simply a text. Getting the notify an
alarm can be triggered.

The program and its sources are distributed under GNU Public License
(GPL). See http://www.gnu.org/licenses/gpl.html.

MXGuard is offered by MOBOTIX AG under GPL, so you can get source free
of charge. It may be changed by anybody respecting terms of GPL. A main
subject of GPL is to offer the source after changes again free.

The program is written in Microsoft Visual Basic.

Important Note:
   The function "IP notify" is not implemented in MOBOITX M1 basic.
   To use MXGuard you need a MOBOTIX M1 IT or higher.


* Deny of Claim
  -------------

MXGuard and its sources are published "as they are". There is no claim
of any properties of the program.

Installation and use of this software is done by the user of his own
risk. MOBOTIX AG is not responsible for any damages etc. that might be
caused by installation or running this program.


* Deny of Support
  ---------------

MOBOTIX AG does not give any support for installation or running
MXGuard.


* Distribution Set
  ----------------

README.TXT	   - this text
MXGuard.zip        - compressed archiv with executables
MXGuard_Source.zip - compressed archiv with source code (MS
		     VisualBasic)
gpl.txt		   - GNU Public License (license conditions)
gpl_deutsch.txt	   - German translation of GNU Public License
		     (for information only)


* Installation Instructions for PC
  --------------------------------

System Requirements
- Windows 95/98/ME/NT4/2000/XP
- Internetexplorer at least Version 4

Steps of Installation
- Extract the archiv MXGuard.zip in any empty directory.
- Start there setup.exe und follow the instruction, maybe in German
  :-(.

Starting the Program
- Start MXGuard using Window's startmenue.
- Click with right mouse button on the MOBOTIX symbol in the task bar
  of you computer.  Here you will find a menu for setup and some more
  help pages.

Configuration of Program
- Click with left mouse button on the MOBOTIX symbol in the task bar
  of your computer.
- Type in any unused port number, which will be used by the camera to
  connect to your PC for the purpose of IP notify. Usually port larger
  than 1024 are used, we suggest 8110.
- Selection of "Auch bei Textmeldungen Browser öffnen" will open a
  browser window to the sending camera although only a text message
  was send.
- Audio signaling can be turned of by selection "Alarmton abschalten"
- Confirm your selection.


* Configuration of MOBOTIX M1
  ---------------------------

- Be aware the your computer and your MOBOTIX camera are sucessfully
  configured in the network. They should be able to communicate. You
  have to see a camera image on your PC:

- Activate on the cmaera one or more events. For example use
  http://<camera -IP>/control/event den "User
  Click (UC)".

- Accept those settings using  "Save to Config-File".

- Activate  "IP-Notify" (at least version M1-V1.8 at
  http://<Camera-IP>/control/message)

- Insert the IP address of your computer to the first form. Append the
  port number you have selected before after a colon. E.g.
  192.168.77.50:8110

- Into the next field:
  * insert a link, MXGuard will open a browser following that link
    (e.g. http://www.mobotix.com/),
  * insert a simple Text, MXGuard will open a small window showing
    that text.
  * If you keep that line empty, MXGuard will open a browser showing
    the cameras entry page.

- Insert into the next field any text (e.g. "Hello"). If you instead
  of an URL (e.g. http://www.mobotix.com/) here, this one will later
  be opened instead of the camera's page.

- Accept all settings pressing "Save to Config-File".

- If your setting should be resistant against power-fail, store the
  configuraiton to flash memory (use "Store").

- Change to user menu that have softbuttons beside
  http://<camera-IP>/control/userimage.html und click to button "UC
  Event" for starting an event.

- If your computer and your camera are properly set up to the network
  a Window with the current image of the camera (or the given URL)
  will be opened.


* Release-Informationen
  ---------------------
V1.4
      - Internationalization at installation, currently German and
        English (default) is supported.

V1.5
      - Avoid program crash after opening a second browser window
	while asking for password.

V1.6
      - Software distributed under terms of GNU Public License.
      - Text of GNU Public License in Englisch und German included.
      - Pull-down menu in setup window to get help and a short
	documentation.


-------------------- END OF ENGLISH VERSION --------------------

Osaka, 2002-05-10
Kaiserslautern, 2002-04-26, 2003-06-17, 2003-10-30

Gerald Eberhard
