Zum Hauptinhalt springen

COM-Port Schnittstelle

Mit dieser Schnittstelle können Daten von verschiedenen lokalen COM-Ports an das diaLIMS übertragen werden. Sind die COM-Ports im diaLIMS korrekt konfiguriert, so können die Daten direkt nach dem Start des LIMS eingelesen werden. Grundsätzlich wird die Schnittstelle verwendet, um Messwerte, zum Beispiel von Waagen, zum diaLIMS zu übertragen. Andere Anwendungsfälle sind jedoch auch denkbar.

Konfiguration der COM-Ports im diaLIMS​

Um Daten von einem COM-Port einlesen zu können, muss dieser im diaLIMS korrekt konfiguriert werden. Standardmäßig sind alle vorhandenen COM-Ports für das diaLIMS deaktiviert.

Jeder COM-Port verfügt über eine eigene Konfigurationsdatei. Diese ist unter den Arbeitsplatzeinstellungen zu finden und heißt "COM[n]_DCommPortReader.properties", wobei [n] die Nummer des jeweiligen COM-Ports ist (Beispiel für COM4: "COM4_DCommPortReader.properties").

In den Einstellungsdateien können folgende Werte konfiguriert werden:

Schlüsselwort

Beschreibung

Standardwert

baudrate

Gibt die Baudrate des COM-Ports an

2400

databits

Gibt die Anzahl der Datenbits des COM-Ports an

8

parity

Gibt die Anzahl der Paritätsbits an

0 steht für NONE, 1 steht für ODD, 2 steht für EVEN

0

stopbits

Gibt die Anzahl der Stopbits an

1

active

Gibt an, ob der COM-Port an das diaLIMS senden darf. Dabei steht 0 für inaktiv und 1 für aktiv

0

faktor

Wenn ein Messwert gelesen wird, wird dieser mit dem Faktor multipliziert

1

divider

Gibt das Dezimaltrennzeichen an, welches bei Messerten den Ganzzaligen und Nachkommateil trennt.

,

keyevent

Gibt das abschließende Zeichen des Datenstroms, welcher über den COM-Port gelesen wird, an. Dabei sind die Werte "enter" oder "tab" möglich.

enter

keyeventDelay

Gibt die Verzögerung in Millisekunden vor dem letzten "keyevent" an

100

blacklistRegex

Regulärer Ausdruck zur Erkennung von Zeichen, die bei der Messwertverarbeitung entfernt werden sollen.

leer

identificationRegex

Regulärer Ausdruck zur Erkennung der Zahlenwerte, die als Werte importiert werden sollen.

[0-9]+$divider?[0-9]*

Kommentare können mittels Raute \("\#"\) am Beginn einer Zeile eingeleitet werden und gelten bis zum Ende der jeweiligen Zeile.

Attention:

Eine fehlerhafte Konfiguration der Felder blacklistRegex oder identificationRegex kann übertragene Daten verfälschen oder zu Fehlermeldungen führen, welche die Datenübertragung vollständig blockieren.

Testen Sie eigene Anpassungen an den Standardeinstellungen immer vorher mit einem Regex-Validator (z.B. RegExr) und halten Sie im Zweifelsfall Rücksprache mit dem diaLIMS-Support.

hinweis

Für die Einstellungen blacklistRegex und identificationRegex kann über den Platzhalter $divider eine Referenz zum Wert der Einstellung divider gemacht werden.

Beispiel: Wurde divider als , festgelegt, interpretiert die Schnittstelle die Angabe [0-9]+$divider?[0-9]* als [0-9]+\,?[0-9]*.

Tip:

Manche Waagen kennzeichnen unsichere Nachkommastellen an Messungen über eckige Klammern, z.B. als 1,234[5].

Möchten Sie diese Ungenauigkeiten übertragen, müssen Sie die Einstellung blacklistRegex auf den Wert [\[\]] setzen.

Bei der Übertragung werden dadurch alle eckigen Klammern entfernt und die Schnittstelle kann mit dem Wert 1,2345 arbeiten.

Tip:

Beispieldatei COM4_DCommPortReader.properties

#################################################################### # Properties-Datei für die Anbindung # eines beliebigen Gerätes an die # serielle Schnittstelle #################################################################### # "#", "REM", ";", "-" und "'" markieren Kommentare. # # # Die benötigten Keys heißen "baudrate", "databits", "active" # "parity", "stopbits" und "divider", "faktor", "keyevent", "keyeventDelay". # - "divider" ist dabei das Dezimaltrennzeichen, das vom Gerät verwendet wird. # - "keyevent" ist dabei das abschließende Zeichen z.B. "enter" oder "tab" # - "keyeventDely" ist die Verzögerung in ms, die vor dem letzten "keyevent" erfolgt #################################################################### baudrate = 2400 databits = 8 parity = 0 stopbits = 1 active = 1 faktor = 1 divider = , verbose = 1 keyevent = tab keyeventDelay = 50

Damit die Schnittstelle fehlerfrei arbeiten kann, müssen unter Umständen die Dateien aus dem Ordner "Programm/lib/commapi" in folgende Verzeichnisse kopiert werden:

  • comm.jar:

    "java/lib" und "java/lib/ext"

  • win32com.dll:

    "java/bin" und "C:\Windows\System32"

  • javax.comm.properties:

    "java/lib"

Einlesen von (Mess-)Werten​

Sobald Daten am COM-Port verfügbar sind, werden sie vom diaLIMS eingelesen und augenblicklich in das aktuell ausgewählte Textfeld geschrieben. Daher ist darauf zu achten, welches Textfeld markiert ist, bevor die Daten über den COM-Port an den Computer gesendet werden. Werden mehrere COM-Ports verwendet, ist zu Bedenken, dass das diaLIMS nicht unterscheidet, welche Daten von welchem Port kommen, sondern sie direkt in das aktuell ausgewählte Textfeld geschrieben werden.

Logging​

Die Schnittstelle loggt ihre Meldungen mittels "log4j". Das LOG-Level kann dementsprechend über die "log4j.properties" mittels des Eintrags "com.dialog.dialims.anbindung.DCommPortReader" bestimmt werden.