Inhaltsverzeichnis
Werbung
SmartRunner Explorer
Konfiguration
5
Konfiguration
5.1
VsxProtocolDriver
Allgemein
Der SmartRunner Explorer verfügt über eine VSX-Programmierschnittstelle. Der Treiber Vsx-
ProtocolDriver bietet den vollen Zugriff auf die Ein- und Ausgangsdaten des Sensors und
ermöglicht die Einbindung in eine C#-basierte Programmierumgebung. Hierzu stellt der Treiber
eine Verbindung mit dem Sensor her und übernimmt die Kommunikation entsprechend dem
Kommunikationsprotokoll. Dem Benutzer werden Funktionen zur Verfügung gestellt, mit denen
Parameter auf dem Sensor eingestellt, Parameterwerte vom Sensor abgefragt und ganze Para-
metersätze sowohl lokal als auch auf dem Sensor gespeichert und geladen werden können.
Weiterhin können Sensorbilder empfangen werden. Jede Funktion enthält darüber hinaus ein
Error-Objekt, welchem im Falle eines Fehlers der Funktion Informationen entnommen werden
können.
Der Treiber ist in C# implementiert und benötigt als Voraussetzung .NET Standard 5.0 oder
höher.
Die Funktionen des Treibers können synchron oder asynchron verwendet werden. Hierfür
muss jeweils die gewünschte Instanz unter Verwendung der Init-Funktion erstellt werden.
In diesem Handbuch werden aus Gründen der Übersichtlichkeit nur die wichtigsten Funktionen
und Variablen beschrieben. Die DLL enthält zudem weitere Funktionen, die für andere Pep-
perl+Fuchs-Vision-Sensoren verwendet werden. Diese Funktionen werden im zugehörigen
Produkthandbuch beschrieben. Bei einigen Funktionen gibt es mehrere Deklarationsmöglich-
keiten. Im Nachfolgenden werden die präferierten Funktionen fett markiert.
Hinweis!
Einbinden des NuGet
Um die DLL verwenden zu können, muss das NuGet eingebunden werden. In Visual Studio
kann dies z.B. durch den NuGet-Pakte-Managers durchgeführt werden. Die DLL findet Sie auf
der Produktseite des SmartRunner Explorer von Pepperl und Fuchs im Softwareordner. In der
dort abgelegten ZIP-Datei befindet sich das NuGet unter dem Projektordner ext.
Synchrone und asynchrone Funktionen
Die in den Parametern verwendeten Hilfsklassen werden im Anschluss beschrieben.
Initialisierung
UDP-Broadcast
Die statische Funktion gibt eine Liste der Vsx-Geräte zurück, welche über einen UDP-Broad-
cast im Netzwerk gefunden werden.
Asynchrone Funktion
public static async Task<(bool Succ, List<Device> DeviceList, Error
ErrorDesc)> UdpDeviceList()
Synchrone Funktion
public static (bool Succ, List<Device> DeviceList, Error ErrorDesc)
UdpDeviceList()
Mögliche Error-IDs: VSX_DRIVER_CONNECTION_ERROR
27
Werbung
Inhaltsverzeichnis
