Server-Erweiterung
Das NuGet-Paket Beckhoff.TwinCAT.HMI.Vision (TwinCAT-Paket „TwinCAT.HMI.Vision“) enthält die HMI Server-Erweiterung TcHmiVision, mit der Bilder aus der SPS in der TwinCAT HMI angezeigt werden können. Dazu werden alle ADS-Symbole vom Typ ITcVnDisplayableImage aus den konfigurierten Runtimes aufgelistet und können in verschiedenen Formaten mit einem HMI-Symbol verknüpft werden. Siehe Systemvoraussetzungen für die benötigte .NET Version.
Konfiguration
Nachdem das Paket erfolgreich in das HMI-Projekt eingebunden wurde, tragen Sie unter Server > TcHmiVision > General die Ziel-SPS ein:
Zudem können einzelne Zielsysteme über die Einstellung Enabled aktiviert oder deaktiviert werden.
Der Streaming server port definiert, welcher Streaming Port für das Senden der Bilder, die mit Stream als Übertragungsformat konfiguriert wurden, verwendet wird.
Wenn einzelne Bildsymbole aus der SPS von der Extension nicht gelistet werden sollen, können diese mit dem SPS-Attribut TcHmiSymbol.Hide ausgeblendet werden. Wenn dagegen nur bestimmte Bildsymbole gelistet werden sollen, muss die Einstellung Use Whitelisting aktiviert werden. Dann können entsprechende Variablen mit dem SPS-Attribut TcHmiSymbol.Show gekennzeichnet werden.
Statistiken
Setzen Sie unter Server > TcHmiVision > General die Number of image transmissions for statistics auf einen höheren Wert als 0, um die Erfassung der statistischen Daten zu aktivieren. Wenn Sie beispielsweise den Wert 100 einstellen, fließen die letzten 100 Bildübertragungen in die Statistik ein.
Unter Server > TcHmiVision > Diagnostics > Statistics werden statistische Daten aufgelistet. Die einzelnen Werte werden pro konfiguriertem Bild-Symbol berechnet.
- Image resolution: Bildauflösung in Pixeln
- Received image size: Bildgröße des empfangenen Bildes
- Converted image size: Bildgröße nach der Konvertierung zuerst z.B. nach Jpeg oder Png abhängig vom konfigurierten Bildformat und dann in einen Base64-String
- Framerate: Bildübertragungen pro Sekunde
- ADS transmission time: Dauer der Übertragung eines Bildes per ADS
- Image conversion time: Dauer der Konvertierung eines Bildes
- Processing time: Die Zeit, die von der Extension für eine Bildübertragung inklusive Konvertierung in Anspruch genommen wird.
- Time between image requests: Die Zeit, die von einer Antwort der Extension bis zur nächsten Bildanfrage des Servers vergeht. Das eingestellte Symbolintervall wird in dieser Phase vom Server abgewartet. Wenn die Bildübertragung pausiert wurde, kann dieser Wert verzerrt sein. Um verfälschte Werte zu verhindern, können die Statistiken wie nachfolgend erklärt, zurückgesetzt werden. Alternativ kann auch gewartet werden, bis weitere Bilder übertragen wurden und die Statistik angepasst wurde. Weiterhin kann dieser Wert variieren, wenn mehrere Databindings auf dasselbe Symbol existieren.
- Evaluated image transmissions: Anzahl der Bildübertragungen, die aktuell in die Statistik einfließen
Grafische Darstellung des Ablaufs einer Bildübertragung, mit den in rot markiert statistischen Werten:
Um die Statistiken aus der Applikation zurückzusetzen, muss ein leerer Wert in das Symbol TcHmiVision.ResetStatistics geschrieben werden. Ziehen Sie dafür beispielsweise ein Write To Symbol in die Actions and Conditions eines Events. Klicken Sie beim linken Feld auf Create data binding… Damit das Symbol aufgelistet wird, müssen Sie in den Einstellungen des Fensters Show advanced items aktivieren. Verlinken Sie jetzt das entsprechende Symbol unter: Mapped symbols > TcHmiVision > ResetStatistics.
Diagnose
Unter Server > TcHmiVision > Diagnostics erhalten Sie Informationen zum Verbindungsstatus des konfigurierten Zielsystems:
Anwendung
- 1. Navigieren Sie zu einem HMI-View und fügen Sie ein Image-Control ein.
- 2. Öffnen Sie die Eigenschaften des Controls und klicken Sie beim Parameter Src auf Create data binding…
- 3. Verlinken Sie den Src-Parameter des Image-Controls mit dem entsprechenden Bildsymbol an folgender Stelle: Server symbols > TcHmiVision > PLC > MAIN > ipImage > <Bildformat>
 | Verlinken von Bildern Das Verlinken von Bildern ist nur möglich, wenn im Prozessabbild des konfigurierten Zielsystems entsprechende Bildvariablen enthalten sind. |
| Intervall Die Geschwindigkeit, mit der Bilder aus der SPS abgerufen werden können, hängt von dem System, der Bildgröße und der Auslastung ab. Wir empfehlen daher, im Binding-Dialog unter Settings ein festes Intervall anzugeben um eine Überlastung des Systems zu verhindern. Wenn mehrere Bilder auf einer Seite angezeigt werden sollen, empfiehlt es sich weiterhin, unterschiedliche Intervalle zu verwenden z. B. 200 ms und 201 ms. Dadurch werden die Bilder getrennt voneinander abgerufen, was bei größeren Datenmengen vorteilhaft sein kann. |
Übertragungsformate
Die Server-Erweiterung erhält die Bilddaten von der SPS im BMP-Format und sendet sie als Base64-String an den TwinCAT HMI Client weiter. Um die Datenmenge, die an einen Client übertragenen wird zu reduzieren, können Bilder in der Server-Erweiterung komprimiert werden. Folgende Bildformate stehen zur Verfügung:
- BMP: unkomprimiert
- JPEG: verlustbehaftet komprimiert, gut für natürliche Bilder
- PNG: verlustfrei komprimiert, gut für künstlich erstellte Bilder
- Stream: Für kontinuierliche Bild-Streams (z. B. Live-Bild der Kamera, nicht empfohlen!)
| Für die Übertragung als Stream muss der HMI-Server als Administrator gestartet werden. Sonst ist keine Bildübertragung möglich. |