******** DataExplorer README *********** 12 Jul 2024 WB

Der GNU DataExplorer ist freie Software, siehe http://www.gnu.org/philosophy/free-sw.html. Sie wird kostenfrei und ohne Spende
zur Verf�gung gestellt. Es gibt aber auch keinerlei Gew�hrleistung. Durch die Implementierung in Java auf der Basis von der freien Bibliotheken
jSerialComm, libjava4usb und SWT ist die Ausf�hrung des Programms auf vielen popul�ren Betriebssystemplattformen in 32 oder 64 Bit wie Windows, GNU/Linux
und MAC OS X m�glich. Die einzige Voraussetzung dazu ist die Installation einer Java Run-time der Version 11 bis Java 21, wie z.B. IcedTea oder openJDK
oder der SUN/Oracle Java Runtime, soweit die Runtime nicht Teil der Installation ist. Vorzugsweise Versionen mit Long Term Support (LTS) verwenden.
Der Einfachheit halber werden die 64 Bit Versionen f�r Windows und MAC OS mit integrierter Java Laufzeit bereitgestellt. Eine Java Laufzeit muss f�r
diese F�lle nicht mehr installiert werden. Da die MAC OS Versionen auf Intel Code basieren l�uft der DataExplorer in der Emulationsschicht Rosetta.

Der GNU DataExplorer nimmt Daten von angeschlossenen Ger�ten oder als Textdateiimport entgegen, zeigt diese f�r verschiedene Auswertungen an.
Die Liste der unterst�tzten Ger�te findet man hier http://www.nongnu.org/dataexplorer/index.de.html.

Weitere Ger�te sind in Arbeit. Hilfe bei der Einbindung von zus�tzlichen Ger�ten ist herzlich willkommen.

Eine Ger�te API (IDevice) wird zur Verf�gung gestellt, die ein relativ einfaches Einbinden eigener Ger�te erm�glichen soll.

F�r das Verzeichnis der Nutzerdaten (Logdateien) ist der Anwender selbst verantwortlich, es wird nach dem ersten Start des Programms
in den Anwendungkonfigurationsdatei (DataExplorer.properties) hinterlegt.

Hinweis: Soll der DataExplorer gleichzeitig auf mehreren Betriebssystemen verwendet werden, oder werden die Daten auf zentraler Stelle abgelegt,
sind Umlaute in den Dateinamen und Objektnamen zu vermeiden. (Umwandlung ISO-8859-1 nach UTF-8 und umgekehrt). Dateilinks unterscheiden sich von den
verschiedenen Betriebssystemen. Objekt bezogene Dateien werden nicht dupliziert, sondern �ber Dateilinks referenziert. Vor einem Umzug der gesammelten
Daten auf ein anderes Betriebssystem sind die Objekt bezogenen Dateilinks zu entfernen und auf der Zielplatform wieder herzustellen. Dazu bitte den
Einstellungsdialog, "Wartung" Tabulator benutzen.

Um Fehler oder Anregungen zu melden, bitte eine e-Mail an die Adresse auf der Downloadseite http://www.nongnu.org/dataexplorer/download.de.html.



Windows:

Zur Installation sind Administratorrechte n�tig.
Achtung: Bitte keine Umlaute im Installationspfad benutzen, Java arbeitet standardm��ig mit UTF-8, da kann es Probleme mit der Konvertierung in der Laufzeitumgebung geben!
Beim ersten Start des Programms werden dann noch Anwendungkonfigurationsverzeichnisse unter %APPDATA%\DataExplorer angelegt. Hierunter werden
auch Anwendungkonfiguration und Tracelogdaten abgelegt.

Je nach verwendeter Windows Version und Patchlevel kann es n�tig sein das System mit dem
"Microsoft Visual C++ 2008 Redistributable Package" von www.microsoft.com/downloads nachzur�sten (Desktopicon, Objektlink).


GNU/Linux:

Entsprechend der Prozessorarchitektur sollte die Java-Laufzeitumgebung installiert werden.
Eine Installation ist nicht n�tig, das im Archiv enthaltene Verzeichnis "DataExplorer" mit den darunter liegenden Verzeichnissen und Dateien
einfach an einen Ort entpacken, wo Ausf�hrungsrechte vorliegen. (tar -xzvf dataexplorer_..)
F�r den ersten Start des Programms �ber ein Kommando-Shell in das DataExplorer Verzeichnis wechseln und DataExplorer ausf�hren.
Beim ersten Start des Programms werden dann noch Anwendungkonfigurationsverzeichnisse unter /home/<Benutzer>/.DataExplorer angelegt. Hierunter werden auch
Anwendungkonfiguration und Tracelogdaten abgelegt.


MAC OS X:

Die DMG Datei enth�lt eine Java-Laufzeitumgebung. Das funktiioniert auch mit einem ARM (M) Prozessor, dann unter Rosetta.
Die bereit gestellt DMG Datei zeigt die Anwendung DataExplorer.app, die einfach auf den Applications Ordner zu ziehen ist.
Beim ersten Start des Programms werden dann noch Anwendungkonfigurationsverzeichnisse unter /User/<Benutzer>/Library/Application Support/DataExplorer
angelegt. Hierunter werden auch Anwendungkonfiguration und Tracelogdaten abgelegt.