Balluff BVS ID-M1280-F1 Series Configuration Manual

Balluff BVS ID-M1280-F1 Series Configuration Manual

Hide thumbs Also See for BVS ID-M1280-F1 Series:
Table of Contents
  • Table of Contents
  • Zu dieser Anleitung
  • Gültigkeit
  • Verwendete Symbole und Konventionen
  • Bedeutung der Warnhinweise
  • Verwendete Fachbegriffe und Abkürzungen
  • Rechtliche Bedingungen
  • Updates und Upgrades
  • Marken
  • Sensorapp / Webinterface
  • Einleitung

Advertisement

Available languages

Available languages

Quick Links

BVS ID-M1280-F1-xx-xxx
deutsch
Konfigurationsanleitung
Configuration Guide
english

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the BVS ID-M1280-F1 Series and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for Balluff BVS ID-M1280-F1 Series

  • Page 1 BVS ID-M1280-F1-xx-xxx deutsch Konfigurationsanleitung Configuration Guide english...
  • Page 2 www.balluff.com...
  • Page 3                             BVS ID-M1280xF1-xx-xxx         deutsch Konfigurationsanleitung...
  • Page 4                       www.balluff.com...
  • Page 5: Table Of Contents

    Updates und Upgrades Marken SensorApp / Webinterface Einleitung Systemmenü Aktionsmenü Tools Geräte-Infos Balluff Engineering Tool (BET) Einleitung Anbindung an das Kundensteuerungssystem 47 UDP/TCP Prozessdatenprotokoll Kommunikation über REST API IO-Link / Feldbus Prozessdatenprotokoll Übersicht IO-Link-Daten und -Funktionen Kommunikation über MQTT deutsch ...
  • Page 6: Zu Dieser Anleitung

    Dokumente vollständig, bevor Sie das Produkt installieren und betreiben. Diese Anleitung wurde in Deutsch erstellt. Andere Sprachversionen sind Übersetzungen dieser Anleitung. © Copyright 2022, Balluff GmbH Alle Inhalte sind urheberrechtlich geschützt. Alle Rechte, einschließlich der Vervielfältigung, Veröffentlichung,...
  • Page 7: Bedeutung Der Warnhinweise

    → Maßnahmen zur Gefahrenabwehr Die Signalwörter bedeuten im Einzelnen:  ACHTUNG Kennzeichnet eine Gefahr, die zur Beschädigung oder Zerstörung des Produkts führen kann. Verwendete Fachbegriffe und Abkürzungen Balluff Vision Solutions CMOS Complementary metal-oxide-semiconductor DHCP Dynamic Host Configuration Protocol E/A-Port Digitaler Eingang- bzw. Ausgangsport...
  • Page 8   BVS ID-M1280xF1-xx-xxx Identsensor Input / Output IODD IO Device Description (Gerätebeschreibungsdatei) IO-Link Kommunikationssystem zur Anbindung intelligenter Sensoren und Aktoren Internet Protocol ISDU Indexed Service Data Unit Local Area Network Limited Power Source Media Access Control MQTT Offenes Netzwerkprotokoll für Machine-to-Machine-Kommunikation n.c.
  • Page 9: Rechtliche Bedingungen

    Die Balluff GmbH ist berechtigt – aber nicht verpflichtet – Updates oder Upgrades der Firmware über die Website der Balluff GmbH oder in jeder anderen Form zur Verfügung zu stellen. In solch einem Fall ist die Balluff GmbH berechtigt – aber nicht verpflichtet – Sie über die Updates oder Upgrades zu informieren. Die Inanspruchnahme solcher Upgrades oder Updates setzt voraus, dass Sie die Geltung die aktuellen AGB sowie die zusätzlichen Bedingungen in dem Bedienungshandbuch akzeptiert haben.
  • Page 10: Sensorapp / Webinterface

      BVS ID-M1280xF1-xx-xxx SensorApp / Webinterface Einleitung Im Normalfall wird die BVS ID per Auto-Setup-Prozess konfiguriert. Jedoch hat der Betreiber die Möglichkeit, über das Webinterface ("SensorApp") die Sensorkonfiguration anzupassen, Live-Bilder darzustellen, Statistiken anzuschauen und  Systemeinstellungen zu ändern. Systemstatus und Systemfehler einzusehen. Führen sie folgende Aktionen aus: Öffnen Sie einen Webbrowser.
  • Page 11   BVS ID-M1280xF1-xx-xxx Systemmenü Das Systemmenü befindet sich im oberen rechten Teil der Bedienoberfläche. Es besteht aus folgenden Menüpunkten: Menüpunkt Bedeutung Link zu den Anleitungen und den Open Source Lizenzen im ZIP- Format Systemeinstellungen 2.2.1 Hilfesystem Anleitungen Der Button öffnet eine Liste zu den ausführlichen Handbüchern im PDF-Format und zu den Open Source Lizenzen ZIP-Format.
  • Page 12   BVS ID-M1280xF1-xx-xxx 2.2.2 Systemeinstellungen Hier sind alle relevanten Daten zum BVS ID enthalten, sowie diverse Einstellungen für die Benutzeroberfläche. Die Systemeinstellungen sind in verschiedene Sub-Kategorien unterteilt (System, Netzwerk, Kommunikation und Berichte). Die Systemeinstellungen können nur im Konfigurations-Modus geändert werden. System Hier werden Informationen über das System angezeigt und systemweit wirksame Einstellungen können vorgenommen werden.
  • Page 13 Es existieren drei Arten von Log-Dateien: System Log-Dateien (system.log): Diese Log-Dateien enthalten Berichte über schwerwiegende Fehler sowie Abstürze und könnten Balluff-Entwicklern in der Suche nach der Fehlerursache unterstützen. Client Log-Dateien (client.log): Diese Log-Dateien enthalten Berichte über Ereignisse und Fehler in Webbrowsern, über welche die SensorApp bedient wird.
  • Page 14   BVS ID-M1280xF1-xx-xxx IIOT Network Hier können alle Netzwerkeinstellungen des BVS ID angepasst werden. Damit die Änderungen wirksam werden, muss der BVS ID neu gestartet werden.  HINWEIS Um nach der Änderung der Netzwerkeinstellungen mit dem BVS ID verbinden zu können, muss der BVS ID an ein entsprechendes Netzwerk gemäß...
  • Page 15   BVS ID-M1280xF1-xx-xxx Einstellung Beschreibung Statische IP-Adresse Falls eine statische IP-Adresse verwendet werden soll, so kann diese hier eingetragen werden.  HINWEIS Beim Einstellen einer statischen IP-Adresse ist der BVS ID nur über die angegebene IP-Adresse erreichbar, soweit der Hostname auf diese IP-Adresse in der DNS-Liste vom Netzwerkadministrator manuell nicht aufgelöst wird.
  • Page 16   BVS ID-M1280xF1-xx-xxx IIOT Communication Im Bereich Kommunikation kann eingestellt werden, wie mit angeschlossenen Geräten wie SPS oder Steuer- PCs kommuniziert wird. Einstellung Beschreibung Protokoll Die zu verwendende Kommunikationsschnittstelle: • IO-Link • • IO-Link-Status [IO-Link] Zeigt an, ob es eine aktive Verbindung zu einem IO-Link- Master gibt oder nicht.
  • Page 17   BVS ID-M1280xF1-xx-xxx Einstellung Beschreibung Statusinformationen senden  [UDP, Aktiviert das automatische Senden von Statusnachrichten bei TCP] jeder Statusänderung. Ist diese Einstellung deaktiviert, werden Statusnachrichten nur auf explizite Anforderung gesendet. TCP/UDP Endianness Zeigt die Byte-Reihenfolge der UDP- und TCP-Kommunikation an. Dies ist bei TCP/UDP generell das "Little Endian"-Format. ...
  • Page 18   BVS ID-M1280xF1-xx-xxx Setting Description Broker Bei Anonymous erfolgt die Anmeldung am angegeben MQTT-Broker ohne Authentication Zugangsdaten. Bei der Wahl von Benutzername/Passwort werden die entsprechenden Zeichenketten verwendet. Benutzername Der bei der Einstellung Username/Password zu verwendende Benutzername. Passwort Das ei der Einstellung Username/Password zu verwendende Passwort. Reconnect Verbindet eine getrennte Verbindung mit den angegebenen MQTT-Broker.
  • Page 19   BVS ID-M1280xF1-xx-xxx Einstellung Beschreibung Protokoll Das Protokoll, das zur Übermittlung der Berichte verwendet wird. Unterstützt werden FTP, FTPS und SMB. Server Die IP-Adresse oder die URL (beginnend mit //) des Servers, auf dem die Berichte abgelegt werden. Beispiel: //ftpserver/reports/ oder // 192.168.1.5/reports/ ...
  • Page 20   BVS ID-M1280xF1-xx-xxx Einstellung Beschreibung OK Inspektionsergebnisse Legt fest, ob Prüfergebnisse im Erfolgsfall als XML-Bericht abgelegt werden sollen. OK Bilder (JPG) Legt fest, ob Bilder im Erfolgsfall als JPG-Dateien abgelegt werden sollen. OK Bilder (RAW) Legt fest, ob Bilder im Erfolgsfall als BMP-Dateien abgelegt werden sollen.
  • Page 21   BVS ID-M1280xF1-xx-xxx 2.3.1 Monitor Über Monitor werden die aktuellen Ergebnisse der laufenden Prüfung dargestellt. Die Menüpunkte haben folgende Funktionalitäten: Menüpunkt Bedeutung Löst einen Trigger aus. Reset Statistics Setzt die Statistik der Inspektionsergebnisse zurück. Übersicht über Inspektionsergebnisse Die Tabelle zeigt die Liste der Inspektionsergebnisse an. Jedes Inspektionsergebnis besteht aus •...
  • Page 22   BVS ID-M1280xF1-xx-xxx 2.3.2 Configure Über Configure erstellen Sie Inspektionsprogramme. Menüpunkt Bedeutung Das Programm nimmt kontinuierlich Bilder auf ("Schleife") und wird bis zum selektierten Programmschritt durchlaufen. Falls in "Inputs" ein Trigger-Modus gewählt wurde, wird auf ein Trigger-Ereignis gewartet. Wenn die Schleife aktiviert ist und auf ein Trigger-Ereignis gewartet wird, kann hiermit ein Trigger ausgelöst werden.
  • Page 23   BVS ID-M1280xF1-xx-xxx Tools 2.4.1 Inputs Inputs besteht aus zwei Bereichen: External Parametrization Sensor Device Externe Parametrierung Aufgabe Hier wird der von der Datenschnittstelle empfangenen Datencontainer, welcher einen UTF-8-kodierten Referenzwert in beliebiger Länge enthalten kann, eingelesen. Der eingelesene Referenzwert kann mit dem gelesenen Code verglichen werden (siehe Abschnitt Analysis).
  • Page 24   BVS ID-M1280xF1-xx-xxx Parameter Parameter Beschreibung Datentyp Aktiv Einlesen eines Referenzwertes aktivieren oder deaktivieren. Bool String Länge Zahl der Byte des einzulesenden Referenzwertes. Uint16 Neue Referenzen Neue Referenz pro Testzyklus aktiviert, so wird der Eingabepuffer, der Bool pro Test-Zyklus den eingelesenen Referenzwert repräsentiert, nach Fertigstellung eines Inspektionsprogrammdurchlaufs gelöscht.
  • Page 25   BVS ID-M1280xF1-xx-xxx Sensor Device Aufgabe Hier können der Sensor ausgewählt und die Sensorparameter eingestellt werden. Parameter Parameter Beschreibung Datentyp Bildquelle Auswahl einer Bildquelle. Die Simulation ("Image Files") dient zur Anzeige und Verarbeitung gespeicherter Bilder. Triggermodus • Continuous - keine externe Triggerung aktiv. Der Sensor nimmt freilaufend Bilder auf.
  • Page 26   BVS ID-M1280xF1-xx-xxx Parameter Beschreibung Datentyp Blitzmodus • weiß - die weißen internen LEDs werden zum Blitzen verwendet. • rot/infrarot (je nach Modell) - die roten / infraroten internen LEDs werden zum Blitzen verwendet. • extern - eine externe Beleuchtung wird verwendet. Belichtungszeit [ms] Verschlusszeit des Bildsensors in Millisekunden (0,01 Double...
  • Page 27   BVS ID-M1280xF1-xx-xxx Parameter Beschreibung Datentyp Vertikale Startposition des rechteckigen Position Y [pixel] Bildausschnittes. Der BVS ID verwendet bei der Suche nach dem zu lesenden Code standardmäßig das volle Bildfeld. Um den Lesevorgang zu beschleunigen oder robuster zu machen, kann das Suchfeld mithilfe eines Bildausschnitts verkleinert werden.
  • Page 28   BVS ID-M1280xF1-xx-xxx 2.4.2 Analysis Analysis besteht aus folgenden Bereichen: 1D Barcodes / 2D Barcodes General settings 1D Barcodes / 2D Barcodes Aufgabe Hier werden die Codes bestimmt, nach welchem das Tool suchen soll. Codes werden dabei innerhalb des Auswertebereichs gesucht und auch dann erkannt, wenn diese gedreht sind oder in unterschiedlicher Größe vorliegen.
  • Page 29   BVS ID-M1280xF1-xx-xxx Parameter Beschreibung Datentyp Code-Typen 2D Liste mit Typen von Matrix-Codes (2D), die im Bild [Bool] gesucht werden. Alle anderen Matrix-Codes werden bei der Suche ignoriert.  HINWEIS Diese Auswahl wird bei einem erfolgreich durchlaufenen Auto-Setup-Prozess automatisch gesetzt. Lesemodus (2D) Legt fest, wie nach 2D-Codes gesucht wird und beeinflusst damit die Lesegeschwindigkeit und die...
  • Page 30   BVS ID-M1280xF1-xx-xxx Tipps zum Beschleunigen des Tools Falls das Tool für die vorliegende Anwendung nicht die erforderliche Geschwindigkeit erreicht, bieten sich folgende Schritte zur Optimierung an: Code-Typen eingrenzen Das Tool versucht, alle zu suchenden Code-Typen zu finden. Je mehr Code-Typen gesucht werden, desto höher ist die Ausführungsdauer des Tools.
  • Page 31   BVS ID-M1280xF1-xx-xxx General settings Aufgabe Hier werden die allgemeinen Einstellungen für das Tool vorgegeben. Parameter Parameter Beschreibung Datentyp Quelle des zu erwartenden Gibt an, welche Quelle für den zu erwartenden Wert Wertes verwendet werden soll. Standardwert Die enthaltenen Werte aller Codes werden mit dem String erwarteten Wert verglichen.
  • Page 32   BVS ID-M1280xF1-xx-xxx Parameter Beschreibung Datentyp Erwartete Anzahl Codes Die maximale Anzahl an Codes, die bei der Bildanalyse gesucht werden soll. Sobald die Bildanalyse diese Anzahl erreicht, wird die Codesuche abgebrochen. Auch dann, wenn sich noch weitere Codes im Bild befinden. ...
  • Page 33   BVS ID-M1280xF1-xx-xxx Parameter Beschreibung Datentyp Sortierkriterium Bestimmt das Kriterium, nach welchem die Enum gefundenen Codes im Anschluss an die Codesuche sortiert werden. Sortiermodus Beschreibung X-Position (links → Codes werden anhand der rechts) X-Koordinate des Mittelpunktes von links nach rechts sortiert. X-Position (rechts Codes werden anhand der →...
  • Page 34   BVS ID-M1280xF1-xx-xxx Parameter Beschreibung Datentyp Code-Qualität Schaltet die Berechnung von Code-Qualität ein/aus Enum und dient zur Wahl der verwendeten Norm an die die Qualitätsberechnung angelehnt ist. Ist Qualität berechnen aktiviert, kann Lesetimeout nicht verwendet werden.  HINWEIS Die Berechnung der Qualität erhöht die Ausführungszeit des Tools sichtlich.
  • Page 35   BVS ID-M1280xF1-xx-xxx Code-Qualität Die Code-Qualität wird für 1D-Codetypen in Anlehnung an die Norm ISO/IEC 15416 berechnet. Für 2D- Codetypen kann mittels Qualität berechnen eine Berechnung in Anlehnung an ISO/IEC 15415 oder in Anlehnung an ISO/IEC TR 29158 gewählt werden. Für PDF417 wird nur ISO/IEC 15415 unterstützt. Beachten Sie, dass die Normen Anweisungen zu Messaufbau und Messdurchführung enthalten.
  • Page 36   BVS ID-M1280xF1-xx-xxx Index Merkmal (de) Merkmal (en) Beschreibung Modulation Modulation Das Maß der Amplitude zwischen zwei Symbolelementen gibt an, wie zuverlässig Striche und Lücken voneinander unterschieden werden können. Defekte Defects Gibt an, in welchem Maße innerhalb des Grauwerteprofil Unregelmäßigkeiten oder Störungen in der Ruhezone auftreten.
  • Page 37   BVS ID-M1280xF1-xx-xxx Index Merkmal (de) Merkmal (en) Beschreibung Defekte der festen Fixed pattern damage Beschreibt, wie stark die Muster Verschlechterung oder Störung des Rahmenmusters und der benachbarten Ruhezonen ist. Dekodierung Decode Binäres Merkmal zur Lesbarkeit. Falls dekodierbar A, ansonsten F. Ist in dieser Implementation immer A.
  • Page 38   BVS ID-M1280xF1-xx-xxx Index Merkmal (de) Merkmal (en) Beschreibung Modulation Modulation Das Maß der Amplitude zwischen zwei Modulen gibt an, wie zuverlässig diese voneinander unterschieden werden können. Dekodierbarkeit Decodability Beschreibt, wie weit die tatsächliche Breite der Module vom Standard des Code-Typs abweicht.
  • Page 39   BVS ID-M1280xF1-xx-xxx Index Merkmal (de) Merkmal (en) Beschreibung Axiale Verzerrung Axial nonuniformity Verhältnis der Breite und Höhe der einzelnen Module und gibt damit eine Aussage zu affinen Verzerrung des Codes, wobei dafür sowohl Kameraverkippung wie auch Druckqualität verantwortlich sein kann. Allgemeine Verzerrung Grid nonuniformity Kommt zusätzlich zur affinen Verzerrung...
  • Page 40   BVS ID-M1280xF1-xx-xxx 2.4.3 Outputs Aufgabe Dient dazu, Ergebnisse des Inspektionsprogramms zu versenden. In den globalen Einstellungen wird definiert, ob das Ergebnis über IO-Link oder über die Ethernet-Schnittstelle (TCP/IP bzw. UDP) an die Steuerung verschickt wird. Das "Output"-Tool passt sich dynamisch an und bietet die Möglichkeit, zu definieren, welche Code-Informationen der gefundenen Ergebnisse über die konfigurierte Schnittstelle versendet werden.
  • Page 41   BVS ID-M1280xF1-xx-xxx Parameter Beschreibung Datentyp Standardlänge [Bytes] Total Result Das Gesamtergebnis eines Bool Inspektionsdurchlaufs Result Message String-Nachricht, die das Ergebnis String des Durchlaufs beschreibt Code Type 1...n Typbeschreibung des gefundenen String Codes Code Value 1...n Gelesener Text des gefundenen String Codes deutsch ...
  • Page 42   BVS ID-M1280xF1-xx-xxx Parameter Beschreibung Datentyp Standardlänge [Bytes] Expected Text 1...n Erwarteter Text entweder vom String Nutzer oder von der Steuerungsschnittstelle erhalten Minimum Quality 1...n Minimale Qualitätsbeschreibung des String gefundenen Codes Full Quality 1...n Volle Qualitätsbeschreibung des String gefundenen Codes Module Size 1...n Modulgröße des gefundenen Codes Float...
  • Page 43   BVS ID-M1280xF1-xx-xxx Geräte-Infos In diesem Bereich werden Geräteinformationen, Status und Fehler angezeigt. Zwischen reinen Informationen (beschriftete Ansicht des Sensors) und Status/Fehler kann mit einer Schaltfläche umgeschaltet werden. Die folgenden Status sind sichtbar: Status Bedeutung Ready Ob der BVS ID bereit ist. Die folgenden Fehler sind sichtbar: Fehler Bedeutung...
  • Page 44 Höhere Effizienz – einheitliche Software für Balluff IO-Link-Netzwerkblock (für PROFINET und EtherNet/ IP-Bus) und alle IO-Link-Geräte und Aktoren. 3.1.1 Software installieren Das Balluff Engineering Tool (BET) kann von der Balluff Website unter www.balluff.com bezogen werden. Der Installationsprozess besteht dann aus folgenden Schritten: Installationsdatei ausführen.
  • Page 45 Wurde das Balluff Engineering Tool (BET) erfolgreich initialisiert, kann im nächsten Schritt die Topologie eingerichtet werden. Beim Start hat das Balluff Engineering Tool (BET) hierfür schon eine leere Topologie erstellt. Als nächster Schritt werden der Topologie die IO-Link-Geräte wie beispielsweise der BVS ID hinzugefügt: Geräte-Scanner über "Geräte finden"...
  • Page 46   BVS ID-M1280xF1-xx-xxx Auf "Scan starten" klicken. → Nach dem Scan, werden alle gefundenen IO-Link-Geräte aufgelistet. Anschließend "Alle hinzufügen" auswählen und auf "Übernehmen & Aktualisieren" klicken: → Danach werden die Geräte in die Topologie übernommen:   deutsch...
  • Page 47   BVS ID-M1280xF1-xx-xxx Durch einen Doppelklick auf das jeweilige Gerät, können die IO-Link-Details angezeigt werden. deutsch ...
  • Page 48   BVS ID-M1280xF1-xx-xxx Weitere Details zur Bedienung des Balluff Engineering Tools (BET) kann dem "Balluff Engineering Tool - User manual" entnommen werden. Hierzu auf das Fragezeichen-Symbol in der Balluff Engineering Tool (BET) Oberfläche klicken:   deutsch...
  • Page 49   BVS ID-M1280xF1-xx-xxx Anbindung an das Kundensteuerungssystem UDP/TCP Prozessdatenprotokoll 4.1.1 Einleitung Über sogenannte UDP-Sockets oder TCP-Sockets kann der BVS ID über die Ethernet-Schnittstelle des Host- Systems gesteuert werden. Hierzu wird der Port 36701 verwendet. TCP- und UDP-Sockets unterscheiden sich grundsätzlich. Bei einem TCP-Socket wird zunächst eine Verbindung zum steuerndem System aufgebaut.
  • Page 50   BVS ID-M1280xF1-xx-xxx 4.1.2 Ablauf der Kommunikation Beispiel: Inspektion triggern  HINWEIS Ist der Trigger-Modus in BVS ID auf "kontinuierlich" eingestellt, warten die Kamera auf keinen Trigger und die Inspektion wird in einer Schleife ausgeführt. Bei "Flanke" wartet die Kamera auf einen Trigger. Hier muss immer der Status Waiting For Trigger abgefragt werden. ...
  • Page 51   BVS ID-M1280xF1-xx-xxx Aktionsnachrichten, Ereignisnachrichten und Antworten auf Aktionsnachrichten haben dieselbe Struktur: Länge in Bytes Struktur Bezeichnung UINT16 Nachrichten ID UINT16 Nutzdatenlänge in Bytes Nutzdaten Jede Nachricht hat eine eindeutige ID: Nachricht Connect Disconnect Statusnachricht und Status anfordern Fehler zurücksetzen Ergebniscontainer Inspektionsprogramm-ID abfragen Inspektionsprogramm-ID setzen...
  • Page 52   BVS ID-M1280xF1-xx-xxx Die Antwort auf eine Aktionsnachricht enthält einen Ergebniscode, der über den Erfolg der Anfrage informiert. Dieser Ergebniscode ist im ersten Wort der Nutzdaten enthalten. Dabei kann der Ergebniscode folgende Werte annehmen: Name Stat Bedeutung Befehl wurde erfolgreich ausgeführt. Antwort auf den Befehl "Inspektions-ID abfragen";...
  • Page 53   BVS ID-M1280xF1-xx-xxx 4.1.4 Ereignisnachrichten vom BVS ID Statusnachricht Bei jeder Statusänderung und auf Anforderung verschickt der BVS ID eine Statusnachricht.  HINWEIS Der BVS ID unterstützt zwei unterschiedliche Arbeitsweisen im Zusammenhang mit Statusnachrichten: • Push: Ist in den Systemeinstellungen die Option "Statusinformationen automatisch senden" aktiviert, dann wird bei jeder Statusänderung automatisch eine Statusnachricht verschickt.
  • Page 54   BVS ID-M1280xF1-xx-xxx Value Value Name Beschreibung Zurücksetzen auf (dez) (hex) binär "0" 08 00 Simulation Dieses Bit signalisiert, dass "File Device" Automatisch, sobald Mode als Bildquelle ausgewählt ist. Die eine andere Simulation ("File Device") dient zur Anzeige Bildquelle gewählt gespeicherter Bilder.
  • Page 55   BVS ID-M1280xF1-xx-xxx Value Value Name Beschreibung Zurücksetzen auf (dez) (hex) binär "0" 4096 00 10 Input Data Gesetzt bei Inputcontainer-Überlauf (mehr Durch Benutzer Error Inputcontainer als Inspektionsergebnisse, mittels Befehl Fehler daher wurde ein Inputcontainer verworfen zurücksetzen (0x16) oder empfangener Referenzwert mit zu und automatisch vielen Zeichen zum Zeitpunkt der beim Wechsel in...
  • Page 56   BVS ID-M1280xF1-xx-xxx Ergebniscontainer Nach Ablauf einer Inspektion im Monitor-Modus werden die Ergebnisdaten in dieser Nachricht gesendet. Länge in Bytes Struktur Wert Bezeichnung UINT16 Nachrichten-ID UINT16 Nutzdatenlänge in Bytes (die Inspektionsprogramm-ID zählt zu den Nutzdaten) UINT16 Inspektionsprogramm-ID. Dieses Feld zeigt das Inspektionsprogramm an, das den Ergebnis-Container erzeugt hat.
  • Page 57   BVS ID-M1280xF1-xx-xxx 4.1.5 Aktionsnachrichten an den BVS ID Connect Die Connect-Nachricht stellt eine Verbindung her. Länge in Bytes Struktur Wert Bezeichnung UINT16 Nachrichten-ID UINT16 Nutzdatenlänge in Bytes Der BVS ID antwortet darauf mit ihrer Connect-Nachricht. Länge in Bytes Struktur Wert Bezeichnung UINT16...
  • Page 58   BVS ID-M1280xF1-xx-xxx Disconnect Mit der Disconnect-Nachricht wird die Verbindung getrennt. Es werden fortan keine Ergebnis-Container und keine Statusnachrichten mehr gesendet; Nachrichten an den BVS ID werden ignoriert. Länge in Bytes Struktur Wert Bezeichnung UINT16 Nachrichten-ID UINT16 Nutzdatenlänge in Bytes Der BVS ID antwortet darauf mit ihrer Disconnect-Nachricht.
  • Page 59   BVS ID-M1280xF1-xx-xxx  HINWEIS Das Fehlerbit System Error bleibt solange binär "1" wie der Systemfehler besteht und wird automatisch auf binär "0" zurückgesetzt, sobald der Systemfehler behoben wurde. Dieses Fehlerbit wird folglich vom Befehl "Fehler zurücksetzen" nicht beeinflusst. Beispiel: Die letzte Statusnachricht vom BVS ID an den Client war: 12 00 02 00 20 01 Das Statuswort 20 01 kann als 0b 0010 0000 0000 0001 im Binärsystem interpretiert werden.
  • Page 60   BVS ID-M1280xF1-xx-xxx Inspektions-ID setzen Setzt die ID der aktiven Inspektion und wechselt somit das Inspektionsprogramm. Länge in Bytes Struktur Wert Bezeichnung UINT16 Nachrichten-ID UINT16 Nutzdatenlänge in Bytes UINT16 Inspektions-ID Der BVS ID antwortet darauf mit einer Antwortnachricht, welche anzeigt ob der Wechsel erfolgreich war und auch die Inspektions-ID, welche gesendet wurde enthält.
  • Page 61   BVS ID-M1280xF1-xx-xxx Ergebnistyp Ergebniscodes Beschreibung NOK Inspection Error Das Inspektionsprogramm konnte nicht gewechselt werden. Folgende Fehlerursachen sind möglich: • Über die Kommunikationsschnittstelle kann auf ein Inspektionsprogramm mit der ID 0  nicht gewechselt werden. • Das Inspektionsprogramm mit der angeforderten ID existiert nicht. •...
  • Page 62   BVS ID-M1280xF1-xx-xxx Datum und Zeit abfragen Wird an den BVS ID gesendet, um Datum und Uhrzeit abzufragen. Länge in Bytes Struktur Wert Bezeichnung UINT16 Nachrichten-ID UINT16 Nutzdatenlänge in Bytes Der BVS ID antwortet darauf mit folgender Nachricht, die den Zeitstempel enthält. Länge in Bytes Struktur Wert...
  • Page 63   BVS ID-M1280xF1-xx-xxx Datum und Zeit setzen Wird an den BVS ID gesendet, um Datum und Uhrzeit zu setzen. Länge in Bytes Struktur Wert Bezeichnung UINT16 Nachrichten-ID UINT16 Nutzdatenlänge in Bytes UINT16 Jahr UINT16 Monat UINT16 UINT16 Stunde UINT16 Minute UINT16 Sekunde Der BVS ID antwortet darauf mit folgender Antwortnachricht:...
  • Page 64   BVS ID-M1280xF1-xx-xxx Referenzwert setzen Manche Applikationen erfordern den Vergleich des Codeinhalts mit einem Referenzwert. Der Referenzwert kann mit dieser Nachricht geschickt werden. Er wird mit Hilfe des Tools "Inputs" eingelesen. Länge in Bytes Struktur Wert Bezeichnung UINT16 Nachrichten-ID UINT16 Nutzdatenlänge in Bytes, d.h.
  • Page 65   BVS ID-M1280xF1-xx-xxx Inspektion triggern Wird gesendet, um eine Inspektion zu triggern. Das Verhalten hängt von der Einstellung im BVS ID ab. Bei einer ungetriggerten Inspektion wird diese Nachricht ignoriert. Um zu prüfen, ob der BVS ID bereit ist einen Trigger entgegenzunehmen, kann das Waiting For Trigger-Bit der Statusnachricht ausgewertet werden.
  • Page 66 Programmierschnittstelle im YAML-Format angezeigt. Für die eigentlichen HTTP-Anfragen wird dem Einstiegspunkt der Programmierschnittstelle die aktuelle Version der Schnittstelle als Postfix angehangen, d.h. http://HOSTNAME/api/balluff/v1/. Alle Daten, die an die REST API gesandt und von ihr empfangen werden, entsprechen dem JSON-Datenformat (JavaScript Object Notation).
  • Page 67   BVS ID-M1280xF1-xx-xxx 4.2.3 Verfügbare Ressourcen API Version abfragen Ressource: versions URL: http://HOSTNAME/api/balluff/versions Antwort: Objekt Inhalt description Beschreibung der API Version. Die Versionsnummer, wie sie in der URL verwendet wird. version Die aktuelle API Version.  HINWEIS Im Gegensatz zu den anderen Befehlen, ist die Versionsnummer nicht Teil der URL.
  • Page 68 Name des Herstellers vendorUrl URL zur Website des Herstellers Beispiel: "firmwareRevision": "1.0.3", "hardwareRevision": "20", "nameOfStation": "B00000000000045", "productId": "BVS ID-M1280BF1-L3-000", "productInstanceUri": "https://products.balluff.com/BVS%20ID-M1280BF1-L3-000/ BVS0060", "productName": "BVS ID-M1280BF1-L3-000", "productText": "1D/2D code sensor, autofocus, w/r light, IO-Link", "serialNumber": "D800000000000045", "vendorName": "Balluff", "vendorUrl": "https://www.balluff.com"   deutsch...
  • Page 69   BVS ID-M1280xF1-xx-xxx Open Source Lizenzen verwendeter Programmbibliotheken abfragen Ressource: licenses URL: http://HOSTNAME/api/balluff/v1/licenses Antwort: Als Antwort werden Textdaten im Markdown-Format mit MIME-Typ text/plain generiert, auf der alle verwendeten Programmbibliotheken und deren Lizenzen gelistet sind. Handbuch abfragen Ressource: documents URL: http://HOSTNAME/api/balluff/v1/documents...
  • Page 70   BVS ID-M1280xF1-xx-xxx Beispiel: "categories": { "ConfigurationGuide": [ "lang": "de", "title": "Configuration guide" "lang": "en", "title": "Configuration guide" "documents": [ "category": "ConfigurationGuide", "lang": [ "de" "origin": "local", "title": "German configuration guide", "url": "http://localhost:9000/resources/help/Manual_BVSID_de.pdf" "category": "ConfigurationGuide", "lang": [ "en" "origin": "local", "title": "English configuration guide",...
  • Page 71   BVS ID-M1280xF1-xx-xxx Diagnosewerte abfragen Ressource: diagnostics URL: http://HOSTNAME/api/balluff/v1/diagnostics Antwort: Objekt Inhalt temperature Interne Temperatur signalQuality Signalqualität operatingHoursCounter Es werden zwei Betriebsstundenzähler unterschieden und zurückgegeben: operatingHoursCounter: Gesamtbetriebsstundenzähler für die Betriebsstunden seit Auslieferung des Geräts operatingHoursCounterSinceReset: Betriebsstundenzähler für die Betriebsstunden seit Start des Geräts bootCycleCounter Betriebsstartzähler...
  • Page 72 "value": 0.06870575994253159, "unit": "mm/s" "inclination": { "value": 92, "unit": "°" "supplyVoltage": { "value": 23, "unit": "V" "humidity": { "value": 9, "unit": "%"  HINWEIS Diagnosewerte können auch einzeln abgefragt werden, indem dem Befehl diagnostics angehängt wird (z.B. http://HOSTNAME/api/balluff/v1/diagnostics/vibration).   deutsch...
  • Page 73   BVS ID-M1280xF1-xx-xxx Gerätestatus abfragen (Health State) Ressource: diagnostics/health URL: http://HOSTNAME/api/balluff/v1/diagnostics/health Der Health State repräsentiert den Gerätestatus des BVS gemäß NAMUR Recommendation NE107. Clients können diese Variable auswerten, um den Gerätezustand zu bestimmen. Antwort: Objekt Inhalt deviceStatus Gerätestatus. Mögliche Werte sind •...
  • Page 74   BVS ID-M1280xF1-xx-xxx Datum/Uhrzeit abfragen Ressource: time URL: http://HOSTNAME/api/balluff/v1/time Antwort: Objekt Inhalt time Datum und Uhrzeit im Format "YYYY-MM-DDTHH:MM:SS.000+00:00Z" Beispiel: "time": "2024-09-01T07:20:06.000+00:00Z"  HINWEIS Die vier Zahlen zwischen "+" und "Z", getrennt durch einen Doppelpunkt, geben die Zeitverschiebung im Bezug zur UTC0-Zeitzone an und entsprechen somit der Zeitzone der SensorApp.
  • Page 75   BVS ID-M1280xF1-xx-xxx Ergebnisse abfragen Ressource: vision/inspection/results URL: http://HOSTNAME/api/balluff/v1/vision/inspection/results Antwort (in Abhängigkeit zu aktivierten Ergebnisdaten): Objekt Inhalt ID des aktiven Inspektionsprogramms inspectionResult Inspektionsergebnis resultMessage Ergebnisnachricht type Code-Typen text Gelesene Texte expectedText Erwartete Texte qualityMin Minimale Code-Qualitäten qualityFull Qualitätsstrings bestehend aus einer Reihe von Qualitätsmerkmalen...
  • Page 76   BVS ID-M1280xF1-xx-xxx Ergebnisse als Binärstring abfragen Ressource: vision/inspection/resultsAsBinaryString URL: http://HOSTNAME/api/balluff/v1/vision/inspection/resultsAsBinaryString Antwort:  Objekt Inhalt binaryData Ergebnisdaten in Bytes, repräsentiert als HEX-Werte Beispiel: "binaryData": "00 00 FF 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 51 52 20 43 6F 64 65 00 00 00 00 00 00 00 00 00 00 00 00 00 42 61 6C 6C 75 66 66 00 00 00 00 00 00 00 00 00 00 00 00 00 AF 56 4D 92 00 64 24 40"...
  • Page 77 Wahr, falls BVS ID auf ein Trigger-Signal wartet. Beispiel: "inputDataError": false, "ready": false, "reportError": false, "resultDataError": false, "simulationMode": true, "systemError": false, "triggerOverflow": false, "waitingForTrigger": false  HINWEIS Statuswerte können auch einzeln abgefragt werden, indem dem Befehl vision/status angehängt wird (z.B. http://HOSTNAME/api/balluff/v1/vision/status/ready). deutsch ...
  • Page 78   BVS ID-M1280xF1-xx-xxx IO-Link / Feldbus Prozessdatenprotokoll 4.3.1 Einleitung Zum Austausch von Daten und Befehlen zwischen BVS ID und dem steuernden Feldbussystem werden zwei Puffer benötigt (Eingangs- und Ausgangspuffer). Der Austausch der Pufferinhalte wird mittels zyklischem Polling durchgeführt. Beim Schreiben des Puffers werden die übertragenen Daten des vorherigen Zyklus überschrieben.
  • Page 79   BVS ID-M1280xF1-xx-xxx Ablaufdiagramm Handshake deutsch ...
  • Page 80   BVS ID-M1280xF1-xx-xxx 4.3.3 Toggle-Mechanismus Für den Fall, dass mit einem Befehl oder mit einer Antwort mehr Daten übertragen werden, sollen als im zyklischen Speicherbereich Platz zur Verfügung steht, kommt ein Toggle-Mechanismus innerhalb des Handshakes zum Einsatz. Dafür werden zwei zusätzliche Bits, TI (Toggle-In) und TO (Toggle-Out) im zyklischen Speicher verwendet.
  • Page 81   BVS ID-M1280xF1-xx-xxx Ablaufdiagramm Handshake mit Input Toggle deutsch ...
  • Page 82   BVS ID-M1280xF1-xx-xxx Ablauf Output Toggle Vor dem Handshake muss die SPS muss das TI-Bit auf 0 setzen. Die SPS sollte am Ende des Handshakes TI-Bit wieder auf 0 setzen. Der BVS ID setzt das TO-Bit am Ende des Handshakes auf 0. SPS setzt im Ausgangspuffer Befehlskennung, Datenlänge und den ersten Teil der Daten.
  • Page 83   BVS ID-M1280xF1-xx-xxx Ablaufdiagramm Handshake mit Output Toggle deutsch ...
  • Page 84   BVS ID-M1280xF1-xx-xxx 4.3.4 Fehler-Mechanismus Ablauf Handshake mit Fehler Handshake mit Fehler (im Befehl oder während Abarbeitung) kann in folgenden Fällen auftreten: • ungültiger Befehlscode • ungültiges Befehlsformat • ungültiger Zustand (Not Ready) • negatives Ergebnis eines Befehls (z.B. NOK Results)  ...
  • Page 85   BVS ID-M1280xF1-xx-xxx 4.3.5 Prozessdatenpuffer Doppelte Bitleiste Um die vollständige Übermittlung aller Daten im Datenpuffer zu gewährleisten, werden die Bytes mit den Kontroll-Bits (Bitleisten) am Anfang und am Ende des Datenpuffers für die Prozessdaten übertragen und verglichen. Sind die beiden Bitleisten gleich, dann wurden die Daten zwischen diesen Bytes vollständig aktualisiert und können übernommen werden.
  • Page 86   BVS ID-M1280xF1-xx-xxx Byte 0 und Byte 1 der Datenlänge werden als ganzzahliger 16-Bit-Wert ausgewertet. Aufbau Bit-Header (SPS → BVS ID) Der BVS ID reagiert auf 0–1 Übergänge der einzelnen Kommando Bits. Die Bits sollten so lange gesetzt sein, bis die entsprechende Quittierung kommt. Ferner müssen die Bits in beiden Bitleisten gesetzt sein. Bit Nummer Name Funktionsbeschreibung...
  • Page 87   BVS ID-M1280xF1-xx-xxx Eingangspuffer Über den Eingangspuffer werden Antworten (Statusinformationen und Ergebnisse) an die SPS übertragen. Byte Details Status Byte 0 Produktstatus Status Byte 1 Fehlerstatus 1. Bitleiste Kontroll/Status Bits (doppelte Bitleiste) Protocol Byte 0 Statusbyte (erster Toggle Zyklus) / Daten Protocol Byte 1  ...
  • Page 88   BVS ID-M1280xF1-xx-xxx Bit Nummer Name Funktionsbeschreibung Nicht verwendet Nicht verwendet Aufbau Status Byte 0 (BVS ID → SPS) Produktstatus Bit Nummer Name Funktionsbeschreibung Waiting for Trigger Dieses Bit signalisiert, dass der BVS ID auf ein Trigger Signal wartet. Result Data Available Diese Bit signalisiert, dass ein Ergebnis zum Abholen bereit ist.
  • Page 89   BVS ID-M1280xF1-xx-xxx Aufbau Status Byte 1 (BVS ID → SPS) Fehlerstatus Bit Nummer Name Funktionsbeschreibung Dieses Bit signalisiert, dass ein Trigger gekommen ist Trigger Overflow  während der BVS ID nicht auf einen Trigger gewartet hat, d.h. während das Bit Waiting For Trigger binär "0"...
  • Page 90   BVS ID-M1280xF1-xx-xxx Aufbau Protocol Byte 0 (BVS ID → SPS) Statusbytes Name Stat Bedeutung Befehl wurde erfolgreich ausgeführt. Antwort auf den Befehl Get Inspection ID; Übertragung der Inspektions Inspection OK Results Antwort auf den Befehl Get Results; Übertragung der Ergebnisse. OK Date Antwort auf Get Date Time Befehl;...
  • Page 91   BVS ID-M1280xF1-xx-xxx 4.3.6 Befehle und Antworten Für alle Befehle sind folgende Antworten möglich: Status Beschreibung NOK Error Allgemeine Fehler (z. B. Befehlsformatfehler, interner Fehler) NOK Communication Abort Der Auftrag wurde vorzeitig zurückgenommen bevor der Handshake beendet war (Abbruch durch SPS) NOK Invalid Command Invalider Befehlsode wurde gesetzt.
  • Page 92   BVS ID-M1280xF1-xx-xxx Befehl Antworte Bedeutung Setzen der Eingabedaten erfolgreich. Inputs Die Applikation befindet sich momentan in einem Zustand, in dem Anfragen nicht Busy bearbeitet werden können (Not-Ready Status). OK Date Antwort mit dem aktuellen Zeitstempel. Date Time Time Bei der Abfrage des Datums / der Zeit trat ein Fehler auf. Error Die Applikation befindet sich momentan in einem Zustand, in dem Anfragen nicht Busy...
  • Page 93   BVS ID-M1280xF1-xx-xxx Befehlsaufbau (SPS → BVS ID): Setzen von Eingabedaten – Set Inputs Byte Wert Bemerkung Message ID Length Byte 0 Input Length Byte 0 Length Byte 1 Input Length Byte 1 Data Byte 0 Input Byte 0 Data Byte n Input Byte n Inhalt und Format der Eingabedaten werden mit Hilfe des Tools "Inputs"...
  • Page 94   BVS ID-M1280xF1-xx-xxx Byte Wert Bemerkung Data Byte 5 Minuten ##hex Data Byte 6 Sekunden ##hex Ungültige Werte (z.B. Stunde 25) werden mit Fehlercode "NOK Error" abgelehnt. Alle Elemente des Zeitstempels werden binär codiert (z. B. Monat: 0Bhex = 11 = November). Beispiel: 31. August 2015 12:34:56 = 14 ...
  • Page 95   BVS ID-M1280xF1-xx-xxx Antwort (BVS ID → SPS): Holen der Inspektions ID - Get Inspection ID - Ergebnis: OK Inspection ID Byte Wert Bemerkung StatusCode Length Byte 0 (Little Endian) Length Byte 1 Data Byte 0 Aktuelle Inspektions-ID Byte 0 ##hex Data Byte 1 Aktuelle Inspektions-ID Byte 1...
  • Page 96   BVS ID-M1280xF1-xx-xxx Antwort (BVS ID → SPS): Setzen von Eingabedaten - Set Inputs - Ergebnis: OK Byte Wert Bemerkung StatusCode Length Byte 0 Length Byte 1 Antwort (BVS ID → SPS): Zeitstempel abholen - Get Date Time - Ergebnis: OK Date Time Byte Wert Bemerkung...
  • Page 97   BVS ID-M1280xF1-xx-xxx 4.3.7 Toggle-Befehle und Ergebnisdatenübertragung Die Daten der Befehle oder Ergebnis werden wie folgt im Toggle-Prozess übertragen: Befehle Beispiel mit der Befehllänge von 20 Bytes (Nutzlast 17 Bytes) und 7 Bytes für die Datenübertragung via Toggle- Zyklus. Byte 0 enthält den Befehlscodes, Byte 1 und 2 die Länge und Byte 3 bis 19 die Nutzlast. 1.
  • Page 98 BVS ID-M1280xF1-xx-xxx 4.Zyklus Unbenutzte Bytes werden im letzten Toggle-Zyklus ignoriert. 4.3.8 Funktionsbaustein Zur Vereinfachung der Kommunikation, stellt die Balluff GmbH je nach verwendeter Hardware entsprechende Funktionsbausteine zur Verfügung: • Für Siemens Steuerungen gibt es einen PROFINET Funktionsbaustein. Beide können von der Balluff Website (www.balluff.com) heruntergeladen werden.
  • Page 99   BVS ID-M1280xF1-xx-xxx Ergebniscontainer abholen (ohne Toggeln) (4 Byte Ergebniscontainer) BVS ID 1. Ausgangspuffer bearbeiten (Reihenfolge 2. Eingangspuffer bearbeiten (Reihenfolge beachten): beachten): → Befehlsstatus: (OK Results) Befehlskennung Datenlänge Byte 0 Datenlänge Byte 0 Datenlänge Byte 1 Datenlänge Byte 1 Job-Bit setzen Inspektions-ID Byte 0 Inspektions-ID Byte 1 Inspektions-ID Byte 2...
  • Page 100   BVS ID-M1280xF1-xx-xxx BVS ID Inspektions-ID kopieren (4 Bytes) Ergebnisbytes kopieren Ausgangspuffer bearbeiten: 4. Eingangspuffer bearbeiten: → Job-Bit Job End-Bit zurücksetzen zurücksetzen Ergebniscontainer abholen (mit Toggeln) (23 Byte Ergebniscontainer) BVS ID 1. Ausgangspuffer bearbeiten (Reihenfolge 2. Eingangspuffer bearbeiten (Reihenfolge beachten): beachten):  ...
  • Page 101   BVS ID-M1280xF1-xx-xxx BVS ID → Befehlsstatus: (OK Results) Befehlskennung Datenlänge Byte 0 Datenlänge Byte 0 Datenlänge Byte 1 Datenlänge Byte 1 Inspektions-ID Byte Job-Bit setzen Inspektions-ID Byte Inspektions-ID Byte Inspektions-ID Byte Datenbyte 0: Ergebnisbyte 0 Ergebnisbyte 3 Ergebnisbyte 4 Job End-Bit setzen ←...
  • Page 102   BVS ID-M1280xF1-xx-xxx BVS ID → TI invertieren Ergebnisbyte 5 Ergebnisbyte 15 Ergebnisbyte 16 TO invertieren ← 5. Eingangspuffer lesen: Zweite 12 Ergebnisbytes kopieren Ausgangspuffer bearbeiten: 6. Eingangspuffer bearbeiten: → TI invertieren Ergebnisbyte 17 Ergebnisbyte 22 TO invertieren ← 7. Eingangspuffer lesen: Letzte 6 Ergebnisbytes kopieren Ausgangspuffer bearbeiten:...
  • Page 103   BVS ID-M1280xF1-xx-xxx BVS ID Job-Bit Job End-Bit zurücksetzen zurücksetzen Ergebnisdaten: Inputdaten setzen (mit Toggeln) (27 Byte Inputdaten) BVS ID 1. Ausgangspuffer bearbeiten (Reihenfolge 2. Ausgangsspuffer lesen: beachten): → Erste 11 Inputbytes kopieren Befehlskennung Datenlänge Byte 0 Datenlänge Byte 1 Inputbyte 0 Inputbyte 1 Inputbyte 9 Inputbyte 10...
  • Page 104   BVS ID-M1280xF1-xx-xxx BVS ID → Inputbyte 11 Zweite 14 Inputbytes kopieren Inputbyte 12 Inputbyte 23 Inputbyte 24 TI invertieren Eingangspuffer bearbeiten (Reihenfolge beachten): ← Toggle-Out invertieren 5. Ausgangspuffer bearbeiten: 6. Ausgangspuffer lesen: → Inputbyte 25 Letzte 2 Inputbytes kopieren Inputbyte 26 TI invertieren Eingangspuffer bearbeiten (Reihenfolge...
  • Page 105   BVS ID-M1280xF1-xx-xxx BVS ID ← 7. Ausgangspuffer bearbeiten: 8. Eingangspuffer bearbeiten → Job-Bit Job End-Bit zurücksetzen zurücksetzen Inputdaten: • SPS setzt falsche Datenlänge (FF = 255), möchte aber nur vier Bytes Inspektions-ID übertragen. • Es werden nach Anfang des Handshakes weitere Daten erwartet und der Toggle-Vorgang wird gestartet. •...
  • Page 106   BVS ID-M1280xF1-xx-xxx Ablaufdiagramm eine Beispielinspektion mit Kamera Funktionsbaustein BVS_ID   deutsch...
  • Page 107   BVS ID-M1280xF1-xx-xxx Ablaufdiagramm Inspektionsumschaltung mit Kamera Funktionsbaustein BVS_ID deutsch ...
  • Page 108   BVS ID-M1280xF1-xx-xxx Übersicht IO-Link-Daten und -Funktionen 4.4.1 Übersicht der enthaltenen Funktionen Primäre Funktionen • Identifikation (Identification) • Geräteerkennung (Device Discovery) • Netzwerkeinstellungen (Network Settings) • Prozessdaten (Process Data)Ereignisnachrichten vom BVS ID • Signalqualität (Signal Quality) Sekundäre Funktionen • Grundlegende Statistik (Basic Statistics) •...
  • Page 109   BVS ID-M1280xF1-xx-xxx 4.4.2 Gerätevarianten Es sind folgende zwei Varianten verfügbar, die sich in ihren Prozessdatenprofilen unterscheiden: • Default • Comprehensive Condition Monitoring Die Funktionen bleiben dabei unverändert. In den Prozessdaten wird ein Protokoll übertragen. Variante Device ID Baudrate Anzahl  Anzahl ...
  • Page 110   BVS ID-M1280xF1-xx-xxx PD Output Byte 0 Byte 31 Protokoll-Eingangspuffer Comprehensive Condition Monitoring PD Input Byte 0 Byte 30 Protokoll-Eingangspuffer Byte 31 Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0 System Signal Reserv Reserv Temperature...
  • Page 111   BVS ID-M1280xF1-xx-xxx 4.4.4 ISDU – Identifikationsdaten Name Inde Subin Läng Datentyp Data Default riff Storag Identifikation Vendor Name STRING   “Balluff” 010  Byte  (16) Vendor Text STRING  "www.balluff.com” 011  Byte (17) Product Name [...] STRING  z. B. "BVS ID-M1280BF1- 012  L3-000"...
  • Page 112   BVS ID-M1280xF1-xx-xxx Product Type ≤ 64 STRING  z. B. "BVS ID-M1280BF1- Code 700  Byte L3-000" (179 Product Order STRING  z. B. "BVS0060" Code 701  Byte (179 Product Licenses ≤ 64 STRING Byte (179 Geräteerkennung Device Discovery  UINT16 Timeout 0FE  Byte (254 Netzwerkeinstellungen Network Settings...
  • Page 113   BVS ID-M1280xF1-xx-xxx Current Signal UINT8 Quality Byte Signal Quality Bad 1 Bit BOOL Grundlegende Statistik Statistics Data Configuratio 426  Byte (106 Input Signal UINT16( Nein Byte ENUM) Time Period Unit UINT8(E Nein Sekunden Byte NUM) Time Period Value UINT16 Nein Byte Moving Average UINT8(E...
  • Page 114   BVS ID-M1280xF1-xx-xxx Operating Hours Counter Byte (87) Current Operating UINT32 Hours Byte Total Operating UINT32 Hours Byte Custom Operating UINT32 Hours Byte Operating Hours UINT8(E Saving Mode Byte NUM) (116 Betriebsstartzähler  Boot Cycle Counter 058  Byte (88) Boot Cycle UINT32 Counter Byte...
  • Page 115   BVS ID-M1280xF1-xx-xxx Lifetime Extreme Status 0D1  Byte (209 State UINT8(E Byte NUM) Time UINT32 Byte Interne Temperatur Device Temperature  052  Byte (82) Device INT16 Temperature Byte Minimum Device INT16 Temperature Byte Since Reset Maximum Device INT16 Temperature Byte Since Reset Lifetime Minimum INT16 Device...
  • Page 116   BVS ID-M1280xF1-xx-xxx Inclination Alarm Configuration 151  Byte (852 Inclination Alarm BOOL Nein 0x00 (0) Enable Byte Inclination Alarm UINT8 Nein 0x0A (10) Threshold Byte Inclination Alarm  0x2 Status 152  Byte (853 Inclination Alarm BOOL Teaching Status Byte Inclination Alarm BOOL Status Byte...
  • Page 117   BVS ID-M1280xF1-xx-xxx Vibration Alarm 1 By BOOL Status 110  (846 Feuchtigkeitsdetektion Humidity 05C  Byte (92) Humidity Bad 1 By BOOL  Operating Hours UINT32  At Exceedance Byte Temperature At INT32  Exceedance Byte Gerätestatus und detaillierter Gerätestatus Device Status UINT8 024  Byte (36)  Detailed Device UINT8[ ] 0x00 0x00 …...
  • Page 118   BVS ID-M1280xF1-xx-xxx Resetbefehle System UINT8 Commands 002  Byte Variantenkonfiguration Device Variant UINT16( Nein 1 (Default) 055  Byte ENUM) (85) Bedeutung der LED-Zustände und Konfiguration LED Standard UINT8(E Selection 0FD  W  Byte NUM) (253 Prozessdateninformation und -konfiguration Process Data UINT8[ ] Input Descriptor 00E ...
  • Page 119   BVS ID-M1280xF1-xx-xxx 4.4.5 System Commands Command-Wert Geräteaktion 0x80 (128) Device Reset – Device Reset bedeutet einen Warmstart des BVS ID. Dabei werden der Microcontroller neu hochgefahren und alle Initialisierungen neu durchgeführt, ohne dass eine Änderung der Parameterwerte erfolgt. 0x81 (129)   Application Reset 0x82 (130) ...
  • Page 120   BVS ID-M1280xF1-xx-xxx 4.4.6 Events Event-Code  Event-Typ Event-Beschreibung-Abhilfe Device Status 0x1850 (6224) Benachrichtigu Process Data Profilauswahl 0 – Device is operating properly. nicht anwendbar – Standardwert  wird verwendet 0x1851 (6225) Benachrichtigu Process Data Update 0 – Device is operating properly. Timeout –...
  • Page 121   BVS ID-M1280xF1-xx-xxx Event-Code  Event-Typ Event-Beschreibung-Abhilfe Device Status 0x8CD1 (36049) Warnung Vibrationsalarm  0 – Device is operating properly. →  Maschine prüfen. 0x8CFF (36095)  Warnung Niedriges 0 – Device is operating properly. Signalqualitätsniveau 0x8D00 (36096)  Warnung Der Messwert liegt unterhalb 2 – Out-of-Specification des Messbereichs.
  • Page 122   BVS ID-M1280xF1-xx-xxx Event-Code  Event-Typ Event-Beschreibung-Abhilfe Device Status 0x8D0D (36109) Warnung Falsche Last/Kabelbruch, 2 – Out-of-Specification analoger Stromausgang Pin → Verkabelung bzw. angeschlossene Geräte prüfen. 0x8D0E (36110) Benachrichtigu Die Zeit ist abgelaufen. 0 – Device is operating properly. Dieses Event meldet die Zeitüberschreitung der Minimalwert-/Maximalwert-/ Durchschnitt-Berechnung.
  • Page 123   BVS ID-M1280xF1-xx-xxx Event-Code  Event-Typ Event-Beschreibung-Abhilfe Device Status 0x8D23 (36131) Fehler Schreibzyklenlimit erreicht – 1 – Maintenance-Required Speichern nicht mehr gewährleistet – Austausch empfohlen. 0x8D24 (36132) Warnung Parameterschreibfehler – 0 – Device is operating properly. dient nur zur Information. 0x8D25 (36133) Fehler Parameter nicht konsistent –...
  • Page 124   BVS ID-M1280xF1-xx-xxx 4.4.7 Kommunikationsparameter Die grundlegende IO-Link-Spezifikation für BVS ID-M1280BF1-L3-000 lautet wie folgt: Spezifikation IO-Link-Bezeichnung Wert Übertragungsrate COM  COM3 (230,4 kBaud) Minimale Zykluszeit Device min cycle time 0x27 (3,9 ms) Frame-Spezifikation: M-Sequence Capability: 0x1B – Anzahl Bedarfsdaten Preoperate – M-Sequence Type 2 Byte –...
  • Page 125   BVS ID-M1280xF1-xx-xxx Variantenna Geräte Übertrag Minimale Frame- IO-Link- Anzahl Prozessdaten kennun ungsrate Zykluszei Spezifikation Protokollve t Device (Anzahl rsion Bedarfsdaten Device Master Preoperate / Anzahl Master Device Bedarfsdaten Operate / ISDU) BVS ID- 0x061 M1280BF1- L3-090 (CCM) BVS ID- 0x061 M1280CF1- L3-000...
  • Page 126 Die Identifikationsdaten dienen zur Identifikation und Verwaltung der IO-Link-Devices. ISDU Name Inde Subin Läng Datentyp Data Default riff Storag Vendor Name STRING   “Balluff” 010  Byte  (16) Vendor Text STRING  "www.balluff.com” 011  Byte (17) Product Name [...] STRING  z. B. "BVS ID-M1280BF1- 012 ...
  • Page 127 Mit dem Parameter Location Tag kann ein String (maximal 32 Byte) in das Device geschrieben werden. Typischerweise beschreibt dieser Wert den Ort des Produkts im Einsatzbereich. Product Type Code Der Balluff Typenschlüssel ist fest im BVS ID hinterlegt. Product Order Code Der Balluff Bestellcode ist fest im BVS ID hinterlegt.
  • Page 128   BVS ID-M1280xF1-xx-xxx Geräteerkennung (Device Discovery) Beschreibung Mit der Funktion Device Discovery kann ein IO-Link-Device wiedergefunden werden, indem per System Command eine Signalisierung an der LED vom Device gestartet wird. ISDU Name Inde Subin Läng Datentyp Data Default riff Storag Device Discovery ...
  • Page 129   BVS ID-M1280xF1-xx-xxx Name Inde Subin Läng Datentyp Data Default riff Storag DHCP 1 Bit BOOL Nein IP Adresse Hier kann die feste IP-Adresse des BVS ID gesetzt und gelesen werden (Siehe Netzwerkeinstellungen SensorApp). Die IP-Adresse muss dem Format "x.x.x.x" entsprechen. Eine per DHCP dynamisch geholte IP-Adresse wird hier nicht angezeigt.
  • Page 130   BVS ID-M1280xF1-xx-xxx Signalqualität (Signal Quality) Beschreibung Die Signalqualität wird in Prozentschritten als Wert zwischen 0 und 100 % angegeben. Wenn die Signalqualität nicht bereitgestellt werden kann, wird ein Ersatzwert von 0xFF (255) ausgegeben. Der Schwellenwert für die Überwachungsfunktion kann eingestellt werden und dient zur Definition von zwei Zuständen der Signalqualität. Gleich oder oberhalb des Schwellenwerts gilt die Signalqualität als gut, unterhalb des Schwellenwerts gilt die Signalqualität als schlecht.
  • Page 131   BVS ID-M1280xF1-xx-xxx Codequalitätswert Signalqualitätswert Prozessdaten ID  Name  Beschreibung  Richtung 0x0020 Current Signal Ausgabe der aktuellen Signalqualität in Prozentschritten von 0 Eingang (32) Quality % bis 100 %. 0x0021 Signal Quality Ausgabe der aktuellen Signalqualitätsevaluation, TRUE Eingang (33) bedeutet eine Signalqualität unter dem Schwellenwert, FALSE bedeutet eine Signalqualität gleich oder über dem Schwellenwert.
  • Page 132   BVS ID-M1280xF1-xx-xxx Current Signal Quality Die aktuelle Signalqualität wird als Wert zwischen 0 und 100 in Prozent angezeigt. Wenn keine gültige Signalqualität verfügbar ist, wird der Wert auf 255 gesetzt. Signal Quality Bad Der Status der Signalqualität wird als boolescher Wert angezeigt. Wenn der Wert TRUE ist, liegt die Signalqualität unter dem Schwellenwert, wenn der Wert FALSE ist, ist die Signalqualität gleich oder über dem Schwellenwert.
  • Page 133   BVS ID-M1280xF1-xx-xxx 4.4.9 Sekundäre Gerätefunktionen Grundlegende Statistik (Basic Statistics) Beschreibung Mit der Funktion Basic Statistics können Statistikvorgänge ausgeführt werden, wie z. B. die Berechnung von Minimum, Maximum und Durchschnitt. Darüber hinaus ist es möglich, den gleitenden Durchschnitt zu berechnen. Mit Basic Statistics können Trends für die gewählte Eingabe über die angegebene Dauer (zwischen 1 Sekunde und 1 Woche oder 1 bis 1000 Abtastpunkte) anzeigt werden.
  • Page 134   BVS ID-M1280xF1-xx-xxx Process Data Object ID  Name  Beschreibung  Richtung 0x0053 (83) Minimum  Minimalwert  Eingang 0x0054 (84) Maximum  Maximalwert  Eingang 0x0055 (85) Average  Durchschnitt  Eingang 0x0056 (86) Moving Average   Wiederholt berechneter Durchschnittswert Eingang 0x0057 (87) Status  Statuswert  Eingang 0x0058 (88) Number Of Samples Anzahl der Messwerte für die Berechnung von Eingang...
  • Page 135   BVS ID-M1280xF1-xx-xxx Name Inde Subin Läng Datentyp Data Default riff Storag Time Period Unit UINT8(E Nein Sekunden Byte NUM) Time Period Value UINT16 Nein Byte Moving Average UINT8(E Nein Messwerte Window Unit Byte NUM) Moving Average UINT16 Nein Window Value Byte Statistics Data Output...
  • Page 136   BVS ID-M1280xF1-xx-xxx Wert Bedeutung Beschreibung 0x02 (2)  Minutes  Minuten 0x03 (3)  Hours  Stunden 0x04 (4)  Days  Tage 0x05 (5)  Samples  Messwerte Statistics Data Configuration: Time Period Value Time Period Value kann von 1 Sekunde bis 1 Woche oder 1 bis 1000 Messwerte eingestellt werden. Über welchen Durchschnitt Minimum, Maximum und Durchschnitt berechnet werden sollen.
  • Page 137   BVS ID-M1280xF1-xx-xxx Moving Average Window Unit  Moving Average Window Value (Wertebereich) Sekunden 1…1000 Minuten 1…100 Stunden 1…24 Messwerte 1…1000 Statistics Data Output: Minimum Minimalwert der gemessenen Werte über einen bestimmten Zeitraum. Statistics Data Output: Maximum Maximalwert der gemessenen Werte über einen bestimmten Zeitraum. Statistics Data Output: Average Durchschnitt der gemessenen Werte über einen bestimmten Zeitraum.
  • Page 138   BVS ID-M1280xF1-xx-xxx System Commands Command-Wert Geräteaktion 0xA7 (167) Statistics Reset – Setzt alle Ausgangsparameter auf 0 und alle Benutzereinstellungen auf die Defaultwerte zurück. 0xA8 (168) Statistics Start Min/Max/Avg – Startet die Statistik der Minimalwert-/ Maximalwert-/ Durchschnitt-Berechnung. 0xA9 (169) Statistics Stop – Stoppt den Statistikbetrieb vollständig. 0xAC (172) Statistics Start Moving Average –...
  • Page 139   BVS ID-M1280xF1-xx-xxx Betriebsstundenzähler (Operating Hours Counter) Beschreibung Der Betriebsstundenzähler kann die Betriebsstunden eines Device sekundengenau erfassen. Es gibt insgesamt drei Betriebsstundenzähler. Neben einem Betriebsstundenzähler für die Betriebsstunden seit Start des Device gibt es einen Gesamtbetriebsstundenzähler und einen kundenspezifischen Betriebsstundenzähler, der zurücksetzbar ist.
  • Page 140   BVS ID-M1280xF1-xx-xxx  HINWEIS Der maximal speicherbare Zählerwert beträgt 1.000.000 und bedeutet bei einer An- und Abschaltung alle 12 Minuten (mit statischem Zähler) eine Laufzeit von über 20 Jahren. Bei häufigerer An- und Abschaltung bzw. einem dynamischen Speichern verringert sich die maximale Speicherzeit je nach Anwendung.
  • Page 141   BVS ID-M1280xF1-xx-xxx Process Data Object ID  Name  Beschreibung  Richtun 0x001E (30) Boot Cycle Counter Ausgabe des aktuellen Boot Cycle Counters Eingang 0x001F (31) Custom Boot Cycle Ausgabe des rücksetzbaren Boot Cycle Counters Eingang Counter ISDU Name Inde Subin Läng Datentyp Data Default...
  • Page 142   BVS ID-M1280xF1-xx-xxx Spannungs- und Stromüberwachung (Voltage and Current Monitoring) Beschreibung Das Spannungs- und Strommodul sendet Benachrichtigungen über Überstrom, Kurzschluss, Drahtbruch, Über- und Unterspannung. Die Über- und Unterspannungserkennung startet einen Timer. Ist der Timer abgelaufen und der Spannungspegel nicht auf die normale  Betriebsspannungsschwelle zurückgekehrt, sendet das Modul die Benachrichtigungen aus.
  • Page 143   BVS ID-M1280xF1-xx-xxx ISDU Name Inde Subin Läng Datentyp Data Default riff Storag Voltage UINT16 Monitoring 200  Byte Detection  Time (870 Duration Voltage Monitoring Detection Time Duration Mit diesem Parameter wird festgelegt, wie lange die Unter- oder Überspannung vorhanden sein muss, bevor sie angezeigt wird.
  • Page 144   BVS ID-M1280xF1-xx-xxx Status extremer Umweltbedingung (Extreme Environment Status) Beschreibung Mithilfe des Extreme Environment Status wird die Zeit aufgezeichnet, in der sich der BVS ID unter extremen Bedingungen aufgehalten hat. Im Parameter Lifetime Extreme Thresholds können Grenzwerte für die jeweiligen Bedingungen parametriert werden.
  • Page 145   BVS ID-M1280xF1-xx-xxx  HINWEIS Für die interne Feuchtigkeit können keine eigenen Grenzwerte parametriert werden. Threshold Vibration Schwellenwert für die Erkennung von zu hohen Vibrationen. Upper Threshold Temperature Schwellenwert für die Erkennung von zu hoher Temperatur. Lower Threshold Temperature Schwellenwert für die Erkennung von zu niedriger Temperatur. State Unter State kann der aktuelle Status abgelesen werden.
  • Page 146   BVS ID-M1280xF1-xx-xxx Variantenabhängigkeit Die Funktionalität ist in allen Varianten verfügbar. Interne Temperatur (Internal Temperature) Beschreibung Der BVS ID verfügt über eine interne Temperaturüberwachung. Dabei wird die Gerätetemperatur erfasst sowie Maximal- und Minimalwerte seit Produktion und seit letztem Neustart des BVS ID. Für das Modul Gerätetemperatur kann ein oberer und ein unterer Schwellenwert festgelegt werden.
  • Page 147   BVS ID-M1280xF1-xx-xxx Name Inde Subin Läng Datentyp Data Default riff Storag Lifetime Minimum INT16 Device Byte Temperature Lifetime Maximum INT16 Device Byte Temperature Device INT16 Temperature 053  Byte Alarm (83) Configuration Lower Alarm Level INT16 Nein Device Byte Temperature Upper Alarm Level INT16 Nein...
  • Page 148   BVS ID-M1280xF1-xx-xxx Event- Event-Typ Event-Beschreibung-Abhilfe Device-Status Code 0x4220 Warnung Device Temperature Underrun – Insulate Device – 2 – Out-of-Specification (16928) Gefahr von Geräteschaden. Der BVS ID ist zu kalt. → BVS ID isolieren. 0x8D10 Warnung Device Temperature Upper Warning – Die 0 –...
  • Page 149   BVS ID-M1280xF1-xx-xxx Erkennbare Verstellungen Nichterkennbare Verstellungen Erkennbare und nichterkennbare Verstellungen: Die Verstellung kann Rotation, Neigung oder Bewegung sein. Mit der Funktion kann die Neigung (grüner Pfeil) erkannt werden, Verschiebungen oder Rotation (rote Pfeile) nicht. Mathematik/Algorithmus Die Neigungsabweichung wird weder mit der horizontalen Ebene noch mit dem vertikalen Gravitationsfeld verglichen, sondern mit der vom Endbenutzer eingelernten Orientierung.
  • Page 150   BVS ID-M1280xF1-xx-xxx ISDU Name Inde Subin Läng Datentyp Data Default riff Storag Inclination Alarm Configuration 151  Byte (852 Inclination Alarm BOOL Nein 0x00 (0) Enable Byte Inclination Alarm UINT8 Nein 0x0A (10) Threshold Byte Inclination Alarm  0x2 Status 152  Byte (853 Inclination Alarm...
  • Page 151   BVS ID-M1280xF1-xx-xxx • Werte: 1…180 • Einheit: Grad (°) • Default_Wert: 10° Alarm Teaching Status Beschreibung Device ist noch nicht eingelernt, keine Referenzorientierung eingestellt, Neigungswert nicht verfügbar. Device ist eingelernt, Referenzorientierung ist eingestellt, Neigungswert ist verfügbar. System Command 0xC0 zum Einlernen und Referenzorientierung festlegen verwenden. ...
  • Page 152   BVS ID-M1280xF1-xx-xxx System Commands System Commands zum Einlernen (Teach-in) und Festlegen der Referenzorientierung.  HINWEIS Das Device kann die Neigung erst berechnen, wenn die Referenzposition eingelernt ist. Command-Wert Geräteaktion 0xC0 (192) Set Reference Orientation – Referenzorientierung der Ist-Position des BVS ID einstellen.
  • Page 153   BVS ID-M1280xF1-xx-xxx Vibrationsdetektion (Vibration) Beschreibung Der BVS ID stellt zwei Schwingungswerte zur Verfügung, die wertvolle Informationen zur vorbeugenden Wartung liefern: • Gesamtgeschwindigkeit in [mm/s], die den allgemeinen Maschinenzustand angibt (unterer Frequenzbereich) • Gesamtbeschleunigung in [g], die den Lagerzustand anzeigt (höherer Frequenzbereich) Diese sekundäre Gerätefunktion ermöglicht die Messung der Schwinggeschwindigkeit als physikalische Umgebungseigenschaft eines mechanischen Systems.
  • Page 154 Vibrationsquelle gemessen, sondern die Vibrationen des gesamten mechanischen Systems. Diese Funktion ist dem ISO-10816-3-Standard angelehnt, aber für eine detaillierte Schwingungsdiagnose bietet Balluff spezielle Sensoren an. Die Produktfamilie ist so konzipiert, dass sie eine vollständige Überwachungsfunktionalität bietet, wobei die Zustandsüberwachung die primäre Funktion des Sensors ist und dieser am Objekt oder an der Maschine montiert wird.
  • Page 155   BVS ID-M1280xF1-xx-xxx Process Data Object ID  Name  Beschreibung  Richtun 0x004A (74) Vibration Level Vibrationslevel Eingang 0x004B (75) Vibration Alarm Status Vibrationsalarmstatus Eingang Für Vibration Level ist die Einheit [mm/s]. Das Vibrationsalarm-Statusflag ist einheitenlos. ISDU Name Inde Subin Läng Datentyp Data Default riff...
  • Page 156   BVS ID-M1280xF1-xx-xxx Vibration Alarm Threshold Schwellenwert der Schwingung zur Auslösung eines Events. Der Vergleich wird für jede Achse und Größe mit logischer ODER-Verknüpfung durchgeführt. Die Hysterese ist fest und basiert auf der Zeit (nicht auf der Amplitude). Wenn der Schwingungswert den Schwellenwert 50 ms lang überschreitet, wird der Alarm aktiviert. Ziel: Entprellung und Vermeidung von Stoßwerten.
  • Page 157   BVS ID-M1280xF1-xx-xxx ISDU Name Inde Subin Läng Datentyp Data Default riff Storag Humidity 05C  Byte (92) Humidity Bad 1 Byt BOOL  Operating Hours UINT32  At Exceedance Byte Temperature At INT32  Exceedance Byte Humidity Bad Der Status der Feuchtigkeit wird als boolescher Wert angezeigt. Wenn der Wert TRUE ist, liegt die Feuchte über dem Schwellenwert, wenn der Wert FALSE ist, liegt die Feuchte unter dem Schwellenwert.
  • Page 158   BVS ID-M1280xF1-xx-xxx Events Event- Event-Typ Event-Beschreibung-Abhilfe Device-Status Code 0x8D22 Warnung Warnlimit für Schreibzyklen erreicht – 0 – Device is operating (36130) Wartungsüberwachung nicht mehr gewährleistet properly. – dient nur zur Information. 0x8D23 Fehler Schreibzyklenlimit erreicht – Speichern nicht mehr 1 –...
  • Page 159 ID ist nicht in der Lage, seine vorgesehene Funktion auszuführen. Eine Neukonfiguration (Zurücksetzen auf Werkseinstellungen) kann  weiterhelfen. Sonst muss der Balluff-Service kontaktiert oder der BVS ID ausgetauscht werden. Detailed Device Status Detailed Device Status zeigt die aktuell anstehenden Diagnosemeldungen (Fehler, Warnung) an. Für eine Event- Übersicht siehe Kapitel "Events".
  • Page 160   BVS ID-M1280xF1-xx-xxx Diagnoseunterdrückung (Diagnosis Suppression) Beschreibung Die Diagnoseunterdrückung dient dazu, Diagnosemeldungen des BVS ID zu unterdrücken. Hierfür gibt es 2 Möglichkeiten: • Diagnoseunterdrückungslevel, das ein generelles Unterdrücken von Meldungen eines bestimmten Niveaus (Benachrichtigung, Warnung, Fehler) zulässt. • Event-Code-Unterdrückung von bis zu 5 Events als Liste oder über ein Teach-in. ISDU Name Inde...
  • Page 161   BVS ID-M1280xF1-xx-xxx Events Für eine Event-Übersicht siehe Kapitel "Events". Event Code Suppression Dieser Parameter zeigt die aktuell unterdrückten Event-Meldungen an. Der Benutzer kann über den Subindex 0 oder einen speziellen Subindex auf die einzelnen Nachrichten zugreifen. Dieser Index ist Teil der Datenspeicherung und wird im nichtflüchtigen Speicher gespeichert.
  • Page 162   BVS ID-M1280xF1-xx-xxx Command-Wert Geräteaktion 0x82 (130) Reset Factory Settings – Dieses Zurücksetzen wird anhand der IO-Link- Spezifikation  V1.1.2 durchgeführt. – Alle Parameter und Geräteeinstellungen auf Default-Einstellungen zurücksetzen (einschließlich Identifikations- und Tagging-Parameter) – Rücksetzen der Konfiguration der Gerätevariante auf die Default-Variante –...
  • Page 163 Verfügung. Bedeutung der LED-Zustände und Konfiguration (LED Meaning and Configuration) Beschreibung Es wird immer nur das Signal mit der höchsten Priorität angezeigt. Die Signale werden mit absteigender Priorität aufgelistet. Balluff Standard (LED 1 - IO-Link) Name  Signal Bedeutung Device Discovery Blau blinkend 3 Hz Das Device Discovery kann über ein...
  • Page 164   BVS ID-M1280xF1-xx-xxx Name  Signal Bedeutung Ready Grün statisch Der BVS ID ist bereit. Firmware Update LED aus Die IO-Link Firmware wird aktualisiert. Namur Standard (LED 1 - IO-Link) Name  Signal Bedeutung Device Discovery Blau blinkend 3 Hz Das Device Discovery kann über ein System Command aktiviert werden, um der BVS ID wiederzufinden.
  • Page 165 Es kann mit Hilfe eines Parameters zwischen zwei verschiedenen Signalisierungsstandards gewählt werden. Der Parameter definiert, welcher Signalisierungsstandard verwendet werden soll: Wert Standard BALLUFF NAMUR Der Parameter wird durch die Application Reset und Factory Reset zurückgesetzt. Prozessdateninformation und -konfiguration (Process Data Info and Configuration) Beschreibung Prozessdateninformation und -Konfiguration bietet verschiedene Möglichkeiten rund um Prozessdaten:...
  • Page 166   BVS ID-M1280xF1-xx-xxx ISDU Name Inde Subin Zugr Läng Datentyp Data Default Storag Process Data 0x00 UINT8[ ] Input Descriptor 0E  Byte (14) Process Data 0x00 UINT8[ ] Output Descriptor 0F  Byte (15) PD Description Dieser Parameter dient dazu, die Struktur des aktuell gewählten Prozessdatenprofils für Ein- und Ausgangsdaten anzugeben.
  • Page 167   BVS ID-M1280xF1-xx-xxx Event- Event-Typ Event-Beschreibung-Abhilfe Device-Status Code 0x1850 Benachrichtig Process Data Profilauswahl nicht anwendbar 0 – Device is operating (6224) – Standardwert wird verwendet. properly. Die Selektion des Prozessdatenprofils ist variantenabhängig – die PD-Profil-IDs sind einer oder mehreren Gerätevarianten zugeordnet. PD Invalid PD Inputs Invalid: Eingangsdaten (Device-zu-Master) werden als ungültig gekennzeichnet, wenn der Device Status des BVS ID...
  • Page 168   BVS ID-M1280xF1-xx-xxx Parametermanager (Parameter Manager) Beschreibung Der Parameter-Manager ist für die Speicherung von Parametern im permanenten Speicher im BVS ID verantwortlich. Beim Start werden alle gespeicherten Parameter aus dem Permanentspeicher gelesen, bei Parameteränderungen werden die Daten durch den Parameter-Manager innerhalb des Permanentspeichers gespeichert. Alle Daten sind mit einer CRC32-Prüfsumme geschützt.
  • Page 169 Gibt eine Liste aller Produktinformationen zurück.  "firmwareRevision": "1.0.0",  "hardwareRevision": "00",  "nameOfStation": "B00005521200115",  "productId": "BVS ID- M1280CF1-L3-000",  "productInstanceUri": "https:// products.balluff.com/ BVS%20ID-M1280CF1-L3-000/ BVS0061",  "productName": "BVS ID- M1280CF1-L3-000",  "productText": "1D/2D code sensor, autofocus, w/IR light, IO-Link",  "serialNumber": "D800005521200115",  "vendorName": "Balluff",  "vendorUrl": "https:// www.balluff.com" deutsch ...
  • Page 170   BVS ID-M1280xF1-xx-xxx Diagnosewerte Topic Bedeutung Example /diagnostics Gibt einer Liste aller unten genannten Signalzustände zurück. /diagnostics/ Anzahl der Betriebsstunden. operatingHoursCoun "operatingHoursCounter": {"value":193,"unit": "h"}, "operatingHoursCounterSince Reset":{"value": 21,"unit": "h"} /diagnostics/ Anzahl der Boot-Zyklen. {"bootCycleCounter": bootCycleCounter {"value":49}} /diagnostics/ Aktuelle Vibration. {"vibration": vibration {"value":0.060,"unit":"mm/ s"}} /diagnostics/...
  • Page 171   BVS ID-M1280xF1-xx-xxx Prozessbefehle Topic Bedeutung Example /vision/inspection/id Liefert die ID der aktiven Inspektion zurück. {"inspectionID": 0} /vision/inspection/ Liefert die aktuelle Ergebnisliste zurück. Die results Ergebnisliste enthält alle Einträge, die im  "id":1, Ausgabereiter der Konfigurationsseite  "inspectionResult":true, selektiert sind. Es ist zu beachten, dass die  "resultMessage":"", aktuell gelesene Ergebnisliste auch von der  "type":{"Code 1":"QR...
  • Page 172   BVS ID-M1280xF1-xx-xxx Produkt- und Fehlerstatusinformationen Topic Bedeutung Example /vision/status Gibt eine Liste der unten genannten Statusinformationen zurück. /vision/status/ready Ist false, falls der BVS ID gerade beschäftigt {"ready":false} ist, und aktuell keine Nachrichten oder Signale verarbeitet werden können. /vision/status/ Dieses Topic gibt darüber Auskunft, ob das {"simulationMode": false} simulationMode Gerät aktuell konfiguriert wird oder der...
  • Page 173 956115_AA · DE · K22; Änderungen vorbehalten.
  • Page 175                             BVS ID-M1280xF1-xx-xxx         english Configuration Guide...
  • Page 176                       www.balluff.com...
  • Page 177 SensorApp / Webinterface Introduction System Menu Action menu Tools Deviceinfo Balluff Engineering Tool (BET) Introduction Connection to the customer control system UDP/TCP Process Data Protocol Communication via REST API IO-Link / Fieldbus Process Data Protocol Overview of IO-Link Data and Functions Communication via MQTT english ...
  • Page 178 This guide was created in German. Other language versions are translations of this guide. © Copyright 2022, Balluff GmbH All content is protected by copyright. All rights reserved, including the right to reproduce, publish, edit and translate this document.
  • Page 179 → Measures to avoid hazards The individual signal words mean:  ATTENTION Indicates a danger that can lead to damage or destruction of the product. Used Technical Terms and Abbreviations Balluff Vision Solutions CMOS Complementary metal-oxide-semiconductor DHCP Dynamic Host Configuration Protocol I/O port...
  • Page 180   BVS ID-M1280xF1-xx-xxx I/O port Digital input / output port Identsensor Input / Output IODD IO Device Description (Gerätebeschreibungsdatei) IO-Link Communications networking standard used for connecting digital sensors and actuators Internet Protocol ISDU Indexed Service Data Unit Local Area Network Limited Power Source Media Access Control MQTT...
  • Page 181 Balluff GmbH is authorized – but not obligated – to make updates or upgrades of the firmware available via the website of Balluff GmbH or in any other form. In such a case, Balluff GmbH is authorized – but not obligated –...
  • Page 182   BVS ID-M1280xF1-xx-xxx SensorApp / Webinterface Introduction Normally, the BVS ID is configured via Auto Setup process. However, the operator has the possibility to adjust the configuration via the web interface ("SensorApp"). • to adjust the sensor configuration, • display live images, •...
  • Page 183   BVS ID-M1280xF1-xx-xxx System Menu The System menu is located in the top right section of the user interface. It consists of the following menu items: Menu item Description Link to the manuals and the Open Source licenses (ZIP format) System settings 2.2.1 Help system Manuals...
  • Page 184   BVS ID-M1280xF1-xx-xxx 2.2.2 System Settings Information about the BVS ID are summarized here. Additionally, the appearance of the user interface can be altered.  The system settings are categorized as different Sub- Categories (System, Network, Communication, Reports). The system settings can only be changed in the configuration mode. System Information about the system is displayed and system wide settings can be made.
  • Page 185 • Client log files (client.log): These log files contain events and errors of web browsers used to access the SensorApp. They may help the local service or the Balluff developers to track bugs and errors, as well. •...
  • Page 186   BVS ID-M1280xF1-xx-xxx IIOT Network All network settings of the BVS ID can be configured here. A reboot of the BVS ID is required in order to apply the changes.  NOTE To connect to the BVS ID after changing network settings, the BVS ID must be plugged in a corresponding network according to the given settings.
  • Page 187   BVS ID-M1280xF1-xx-xxx Setting Description Subnet mask You can set the subnet mask here.  NOTE Use different subnet masks, when using both network interfaces (Gigabit Ethernet and Fieldbus). Otherwise you can lose data packages because of unclear routing. Gateway If the IP address is static, the gateway can be set here.
  • Page 188   BVS ID-M1280xF1-xx-xxx Process Communication The communication settings allow to setup how to communicate with plugged devices such as PLCs or control PCs. These settings affect all data that is sent with the "Outputs" tool to these device types. Setting Description Protocol The communication interface to use:...
  • Page 189   BVS ID-M1280xF1-xx-xxx Setting Description TCP/UDP Shows the Endianness of the TCP/UDP communication. With UDP and TCP, message Endianness elements are always transferred using little endian.  NOTE If no network cable is connected to the BVS ID at startup all above-mentioned communication parameters are not editable.
  • Page 190   BVS ID-M1280xF1-xx-xxx Setting Description Password Password to be used when username/password has been selected. Reconnect Reconnects a lost connection to the selected MQTT broker. IIOT Reports The reports settings allow to define which data the reports will contain and to set up where the reports are stored on.
  • Page 191   BVS ID-M1280xF1-xx-xxx Setting Description User Name to be used for authentication on the server or network share. When specifying a domain user for authentication over SMB, the domain has to also be specified, i.e.: domain/ user Password Password to be used for authentication on the server or network share. Connectio Checks, if a connection can be established to the target share with the given parameters.
  • Page 192   BVS ID-M1280xF1-xx-xxx Setting Description OK images (RAW) Determines whether images of successful inspections are stored as BMP files NOK inspection results Determines whether results of failed inspections are stored as XML reports NOK images (JPG) Determines whether images of failed inspections are stored as JPG files NOK images (RAW) Determines whether images of failed inspections are stored as BMP files ...
  • Page 193   BVS ID-M1280xF1-xx-xxx 2.3.1 Monitor You can use Monitor to display the actual results for the current inspection. Menu item Meaning Causes a trigger. Reset Statistics Resets the statistics of the inspection results. Overview of inspection results The table on the left shows the list of inspection results. Each inspection results consists of •...
  • Page 194   BVS ID-M1280xF1-xx-xxx 2.3.2 Configure You can use Configure to create inspection programs. Menu item Meaning The program takes images continuously and runs through to the selected program step ("Loop"). If a trigger mode has been selected in "Inputs", it is waiting for a trigger event. Emits a trigger if the Loop is activated and a trigger event is waited for.
  • Page 195   BVS ID-M1280xF1-xx-xxx External Parametrization Sensor Device External Parametrization Task Here, the data container received from the data interface is read. The data container may contain an UTF-8 encoded reference value of arbitrary length. The read in reference value can subsequently be compared to the read code (see section Analysis).
  • Page 196   BVS ID-M1280xF1-xx-xxx Parameters Description Data type Active Activates or deactivates the reading of a reference value. Bool String Length Number of bytes representing the characters of the reference value. Uint16 New Reference If New Reference Per Cycle is activated, the input buffer representing the Bool Per Test Cycle read in reference value is deleted after completion of an inspection program...
  • Page 197   BVS ID-M1280xF1-xx-xxx Sensor Device Task Used for selecting the sensor and setting sensor parameters. Parameters Parameters Description type Image source Selection of an image source. The simulation ("Image Files") can be used to display and process stored images. Trigger mode •...
  • Page 198   BVS ID-M1280xF1-xx-xxx Parameters Description type Flash mode • white - the white internal LEDs are used. • red/infrared (according to the model) - the red / infrared internal LEDs are used. • external - an external flash is used. Exposure time Shutter speed of the image sensor in milliseconds (0.01 to 1000 ms) [ms]...
  • Page 199   BVS ID-M1280xF1-xx-xxx 2.4.2 Analysis It consists of following sections: 1D Barcodes / 2D Barcodes General settings 1D Barcodes / 2D Barcodes Task Specifiy the 1D or 2D codes, which should be read. The tool searches for codes within the area of interest and detects them even if they are rotated or in different sizes. ...
  • Page 200   BVS ID-M1280xF1-xx-xxx Parameters Description Data type Code types 2D List with types of matrix codes (2D) that are searched [Bool] in the image. All other matrix codes are ignored during the search.  NOTE This selection is set automatically when the auto setup process is completed successfully.
  • Page 201   BVS ID-M1280xF1-xx-xxx Reduce the code types The tool tries to find all chosen code types. More code types leads to a longer execution time of the tool. Therefor it is reasonable to search only for the code types available in the image. Choose unstructured background Principally, the search algorithm assumes a code behind every structure.
  • Page 202   BVS ID-M1280xF1-xx-xxx General settings Task Hier werden die allgemeinen Einstellungen für das Tool vorgegeben. Parameters Source of the expected Specifies the source of the expected value. value Find Text The included value of all read codes are compared with String the expected value.
  • Page 203   BVS ID-M1280xF1-xx-xxx Sorting criterion Determines the criteria by which found codes will be Enum sorted. Sort mode Description Position x (left → Codes are sorted by the x right) coordinate of their midpoint from left to right. Position x (right → Codes are sorted by the x left) coordinate of their midpoint...
  • Page 204   BVS ID-M1280xF1-xx-xxx Code quality Activates/deactivates code quality assessment and is Enum used to specify the norm that is used as the basis for this quality assesment. If Assess quality is active, Read timeout can't be used.  NOTE Assessing the code quality will increase the execution duration of this tool significantly.
  • Page 205   BVS ID-M1280xF1-xx-xxx Code quality The code quality is determined for 1D cody types borrowing from ISO/IEC 15416. For 2D code types, quality assesment borrowing from ISO/IEC 15415 or borrowing from ISO/IEC TR 29158 can be chosen by Asses quality. For PDF417 only ISO/IEC 15415 is supported. Please note, that the norms contain instructions for the measurement setup and the measurement procedure.
  • Page 206   BVS ID-M1280xF1-xx-xxx Index Characteristic Description Decodability Describes, how far the true width of the symbol elements differ from the standard of the barcode types. Additional requirements Depending on the code type, the ISO/IEC 15416 defines additional requirements like the quiet zone widths, the wide/narrow ratio, the inter character gaps.
  • Page 207   BVS ID-M1280xF1-xx-xxx For PDF417 the form is a (bcdefg) and has the following meaning: Index Characteristic Description Overall quality The minimum or worst quality of all characteristics. Start/Stop pattern The quality of the start and stop patterns. Codeword yield Amount of Codewords that are decoded correctly.
  • Page 208   BVS ID-M1280xF1-xx-xxx Index Characteristic Description Axial nonuniformity Measures and grades the spacing of the mapping centers and tests for uneven scaling of the symbol along the X or Y axis. Reasons for this behavior can be the print quality or the tilt of the camera. Grid nonuniformity Measures and grades the largest vector deviation of the grid intersections, determined by the theoretical...
  • Page 209   BVS ID-M1280xF1-xx-xxx 2.4.3 Outputs Task Used to send inspection program results. Global settings specify whether the result is sent to the PLC via IO- Link or via the ethernet interface (TCP/IP or UDP). The Outputs tool gets dynamically adapted and offers specifying which details of the code reader result information is sent using the specified interface.
  • Page 210   BVS ID-M1280xF1-xx-xxx Parameter Beschreibung Datentyp Standardlänge [Bytes] Total Result The total result of the inspection. Bool Result Message String message which describes String details of the inspection run Code Type 1...n Type of the found code String Code Value 1...n Read text of the found code String  ...
  • Page 211   BVS ID-M1280xF1-xx-xxx Parameter Beschreibung Datentyp Standardlänge [Bytes] Expected Text 1...n Expected text set by the user or String received by the control interface Minimum Quality 1...n Minimal qualitäty description of the String found code Full Quality 1...n Volle quality description of the String found code Module Size 1...n...
  • Page 212   BVS ID-M1280xF1-xx-xxx Deviceinfo In this area device information, states and errors are visible. The switch button in the top right corner of the area can be used to switch between device information (image of the sensor) and states/errors. The following states are visible: State Meaning Ready...
  • Page 213 BVS ID-M1280xF1-xx-xxx Balluff Engineering Tool (BET) Introduction For IO-Link topologies, the Balluff Engineering Tool (BET) enables the configuration and commissioning of any IO-Link device that complies with the IO-Link standard for sensors and actuators. The BET offers the following advantages: •...
  • Page 214 BVS ID-M1280xF1-xx-xxx 3.1.2 Set up topology As soon as the Balluff Engineering Tool (BET) is initiated successfully, a project can be created, the next step is to set up the topology. At startup, the Balluff Engineering Tool (BET) has already created an empty topology for this purpose. The next step is to add to the topology the IO-Link devices such as the BVS ID are added: Open the device scanner via "Scan":...
  • Page 215   BVS ID-M1280xF1-xx-xxx Click on "Start Scan". → After the scan, all the IO-Link devices found are listed. Then select "Add all" and click on "Apply & Update": english ...
  • Page 216   BVS ID-M1280xF1-xx-xxx → The devices are then added to the topology: By double-clicking on the respective device, the IO-Link details can be displayed.   english...
  • Page 217 BVS ID-M1280xF1-xx-xxx Further details on the operation of the Balluff Engineering Tool (BET) can be found in the "Balluff Engineering Tool - User manual". To do this, click on the question mark symbol in the Balluff Engineering Tool (BET) interface:...
  • Page 218   BVS ID-M1280xF1-xx-xxx Connection to the customer control system UDP/TCP Process Data Protocol 4.1.1 Introduction It is possible to control BVS ID using UDP sockets or TCP sockets via the Ethernet interface of the host system. For this, the port 36701 is used. TCP and UDP sockets are essentially different.
  • Page 219   BVS ID-M1280xF1-xx-xxx 4.1.2 Communication sequence Example: Trigger inspection  NOTE If the trigger mode is set to continuous in BVS ID, it will not wait for a trigger and executes the inspection in a loop. Using edge, the camera waits for a trigger. Here you have to query the Waiting for Trigger state. ...
  • Page 220   BVS ID-M1280xF1-xx-xxx All event, request and response messages have the same structure: Length in bytes Structure Description UINT16 Message ID UINT16 User data length in bytes User data Every message has a unique ID: Message Connect Disconnect Status message and get status Reset errors Result container Get inspection program ID...
  • Page 221   BVS ID-M1280xF1-xx-xxx The response to an action message contains a result code that informs about the success of the request. This result code is contained in the first word of the user data. The result code can have the following values: Name Stat Meaning...
  • Page 222   BVS ID-M1280xF1-xx-xxx 4.1.4 Event messages from BVS ID Status message For each status change and upon request BVS ID sends a status message.  NOTE BVS ID supports two different modes of operation regarding status messages: • Push: If the option "Send status information automatically" is activated, a status message is sent each time a status changes.
  • Page 223   BVS ID-M1280xF1-xx-xxx Value Value Name Description Reset to binary "0" (dez) (hex) 20 00 Ready This bit signals that BVS ID is currently Automatically, as ready. It is reset while BVS ID performs an soon as the BVS ID administrative task that prevents it from performs an processing commands.
  • Page 224   BVS ID-M1280xF1-xx-xxx Value Value Name Description Reset to binary "0" (dez) (hex) 32768 00 80 System This bit becomes active if Automatically, as Error soon as the system • A critical temperature of 90 °C was error is resolved. exceeded inside the device.
  • Page 225   BVS ID-M1280xF1-xx-xxx Result container The inspection in monitor mode will send the result data in this message after processing the inspection. Length in bytes Structure Value Description UINT16 Message ID UINT16 User data length in bytes (the inspection program ID is considered as user data) UINT16 Inspection program ID.
  • Page 226   BVS ID-M1280xF1-xx-xxx 4.1.5 Request messages to the BVS ID Connect The Connect message creates a connection to BVS ID. Length in bytes Structure Value Description UINT16 Message ID UINT16 User data length in bytes BVS ID answers with a Connect response message. Length in bytes Structure Value...
  • Page 227   BVS ID-M1280xF1-xx-xxx Disconnect With the Disconnect message the connection will be disconnected. Afterwards, no more result containers or status messages will be transmitted; messages to BVS ID will be ignored. Length in bytes Structure Value Description UINT16 Message ID UINT16 User data length in bytes Example: Message from the client to BVS ID: 02 00 00 00 Reset errors...
  • Page 228   BVS ID-M1280xF1-xx-xxx Das 0th bit of the high byte, which indicated Trigger Error is being reset to binary "0". The 4th bit of the low byte, which indicates Ready is unaffected by the reset. Get inspection ID Gets the program number of the active inspection. Length in bytes Structure Value...
  • Page 229   BVS ID-M1280xF1-xx-xxx Length in bytes Structure Value Description UINT16 User data length in bytes UINT16 Result code UINT16 The currently set Inspection ID Result code type Result code Description The inspection program change has been successfully completed. NOK Busy The application is currently in a mode in which requests can not be processed (ready status is curently false).
  • Page 230   BVS ID-M1280xF1-xx-xxx Get date and time Gets the system date and time of BVS ID. Length in bytes Structure Value Description UINT16 Message ID UINT16 User data length in bytes BVS ID answers with a response message containing the current date and time of the system. Length in bytes Structure Value...
  • Page 231   BVS ID-M1280xF1-xx-xxx Set date and time Sets the system date and time of BVS ID. Length in bytes Structure Value Description UINT16 Message ID UINT16 User data length in bytes UINT16 Year UINT16 Month UINT16 UINT16 Hour UINT16 Minute UINT16 Second BVS ID answers with the following response message:...
  • Page 232   BVS ID-M1280xF1-xx-xxx Set reference value Some applications require the code content to be compared with a reference value. The reference value can be sent using this message. The tool "Inputs" reads this reference value. Length in bytes Structure Value Description UINT16 Message ID...
  • Page 233   BVS ID-M1280xF1-xx-xxx Trigger inspection It is sent from the client to start an inspection pass. The behavior depends on the setting in the BVS ID. If an inspection is untriggered, this message is being ignored. To check whether the device is ready to receive a trigger, the Waiting For Trigger bit of the status message may be evaluated.
  • Page 234 It is not necessary to adapt any system settings to use the REST API. The REST API is always active and can always be used without restrictions. 4.2.2 General API structure general entry point to the BVS ID API is http://HOSTNAME/api/balluff/v1/apidocs, where HOSTNAME either the device’s IP address or its host name as known by the respective DHCP server.
  • Page 235   BVS ID-M1280xF1-xx-xxx 4.2.3 Available resources Get API version Resource: versions URL: http://HOSTNAME/api/balluff/versions Response: Object Content description Description of the API version. The version number how it is used in the URL. version The current API version.  Contrary to all the other commands, the version number is not part of the URL.
  • Page 236 Name the vendor vendorUrl URL tpo the vendor's website Example: "firmwareRevision": "1.0.3", "hardwareRevision": "20", "nameOfStation": "B00000000000045", "productId": "BVS ID-M1280BF1-L3-000", "productInstanceUri": "https://products.balluff.com/BVS%20ID-M1280BF1-L3-000/ BVS0060", "productName": "BVS ID-M1280BF1-L3-000", "productText": "1D/2D code sensor, autofocus, w/r light, IO-Link", "serialNumber": "D800000000000045", "vendorName": "Balluff", "vendorUrl": "https://www.balluff.com"   english...
  • Page 237   BVS ID-M1280xF1-xx-xxx Get Open Source licenses of all used software libraries Resource: licenses URL: http://HOSTNAME/api/balluff/v1/licenses Response: Text data in Markdown format of MIME type text/plain containing the license information of all used software libraries. Get manuals Resource: identification URL:...
  • Page 238   BVS ID-M1280xF1-xx-xxx Get condition monitoring data Resource: diagnostics URL: http://HOSTNAME/api/balluff/v1/diagnostics Response: Object Content temperature Internal Temperature signalQuality Signal Quality operatingHoursCounter Two operating hours counters are differentiated and returned: operatingHoursCounter: Total number of operating hours since device production operatingHoursCounterSinceReset: Current number of...
  • Page 239 "unit": "%"  NOTE Individual condition monitoring values can be requested by appending their name to the command diagnostics (e.g. http://HOSTNAME/api/balluff/v1/vision/diagnostics/vibration). Get device state (health state) Resource: diagnostics/health URL: http://HOSTNAME/api/balluff/v1/diagnostics/health The device health indicates the status of the BVS ID as defined by NAMUR Recommendation NE107. Clients can read this variable to determine the device condition.
  • Page 240 SensorApp are not included in this calculation. For example, the device state does not change to Functional-Check, when changing into the configuration mode in the web interface. Example: "deviceStatus": { "value": "OK" Get date/time Resource: time URL: http://HOSTNAME/api/balluff/v1/time Response: Object Content time Date and time in the format "YYYY-MM-DDTHH:MM:SS.000+00:00Z" Example: "time": "2024-09-01T07:20:06.000+00:00Z"...
  • Page 241   BVS ID-M1280xF1-xx-xxx Get Results Ressource: vision/inspection/results URL: http://HOSTNAME/api/balluff/v1/vision/inspection/results Response (depending on set parameters in outputs): Object Content ID of the active inspection program inspectionResult Inspection result resultMessage Result message expectedNumberOfCodes Expected number of codes type Code types text Read texts...
  • Page 242 "AAABABBA" "moduleSize": { "Code 1": 20.83460968299469 Get results as a binary string Ressource: vision/inspection/resultsAsBinaryString URL: http://HOSTNAME/api/balluff/v1/vision/inspection/resultsAsBinaryString Response:  Objekt Inhalt binaryData Result bytes represented in hex values Example: "binaryData": "00 00 FF 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 51 52 20 43 6F 64 65 00 00 00 00 00 00 00 00 00 00 00 00 00 42 61 6C 6C 75 66 66 00 00 00 00 00 00 00 00 00 00 00 00 00 AF 56 4D 92 00 64 24 40"...
  • Page 243 True if trigger was discarded because BVS ID could not process the previously triggered inspection before receiving another trigger. waitingForTrigger True if BVS ID is waiting for a trigger signal.  NOTE Individual status values can be requested by appending their name to the command vision/status (e.g. http://HOSTNAME/api/balluff/v1/vision/status/ready). english ...
  • Page 244   BVS ID-M1280xF1-xx-xxx IO-Link / Fieldbus Process Data Protocol 4.3.1 Introduction Two buffers are needed to exchange data and commands between BVS ID and the fieldbus controller (input buffer and output buffer). The buffer contents are exchanged using cyclical polling. When writing to the buffer, the transmitted data from the previous cycle is overwritten.
  • Page 245   BVS ID-M1280xF1-xx-xxx Handshake flow chart english ...
  • Page 246   BVS ID-M1280xF1-xx-xxx 4.3.3 Toggle mechanism If more data is to be transferred with a command or with a response than the cyclical memory area can hold, a toggle mechanism within the handshake is being used. For this purpose, two additional bits, TI (Toggle-In) and TO (Toggle-Out) are used in the cyclical memory.
  • Page 247   BVS ID-M1280xF1-xx-xxx Handshake flow chart with input toggle english ...
  • Page 248   BVS ID-M1280xF1-xx-xxx Process output toggle The PLC has to set the TI bit to 0. After the handshake, the PLC has to set the TI bit to 0 again. The BVS ID sets the TO bit to 0 at the end of the handshake. The PLC sets command ID, data length and the first part of the data in the output buffer.
  • Page 249   BVS ID-M1280xF1-xx-xxx Handshake flow chart with output toggle english ...
  • Page 250   BVS ID-M1280xF1-xx-xxx 4.3.4 Error mechanism Process handshake with error Handshake with error (command or during the process) can happen in the following cases: • invalid command • invalid format • invaid state (Not Ready) • negative result of a command (z.B. NOK Results)  ...
  • Page 251   BVS ID-M1280xF1-xx-xxx 4.3.5 Process data buffer Double bit string To ensure the complete transmission of all the data in the data buffer, the bytes are transferred with the control bits (bit strings) at the start and end of the data buffer for the process data and compared. If both bit strings are the same, then the data between these bytes were updated completely and can be taken over.
  • Page 252   BVS ID-M1280xF1-xx-xxx Structure bit header (PLC → BVS ID) BVS ID responds to 0-1 transitions of the individual command bits. The bits should be set until the corresponding acknowledgment arrives. Bit number Name Function description Indicates a job is present Trigger Triggers camera image aquisition.
  • Page 253   BVS ID-M1280xF1-xx-xxx Input buffer The input buffer is used to transfer responses (status information and results) to the PLC. Byte Details State byte 0 Product state State byte 1 Error state 1st bit string Control bits (double bit string) Protocol byte 0 State byte (first toggle cycle) / data Protocol byte 1...
  • Page 254   BVS ID-M1280xF1-xx-xxx Bit number Name Function description Not used Structure state byte 0 (BVS ID → PLC) Product State Bit number Name Function description Waiting for Trigger This bit signals that BVS ID is wating for a trigger signal. Result Data Available This bit signals that a result is ready to be picked Simulation Mode...
  • Page 255   BVS ID-M1280xF1-xx-xxx Structure state 1 (BVS ID → PLC) Error State Bit number Name Function description This bit signals that a trigger has been received while Trigger Overflow BVS ID was not waiting for a trigger, i.e. while the bit Waiting For Trigger was binary "0".
  • Page 256   BVS ID-M1280xF1-xx-xxx Structure protocol byte 0 (BVS ID → PLC) State Bytes Name Status code Meaning Command was successfully executed. OK Inspection ID Response to the command Get Inspection ID; transfer of the inspection OK Results Response to the command Get Results; transfer of results.
  • Page 257   BVS ID-M1280xF1-xx-xxx 4.3.6 Commands and responses The following responses are possible for all commands: Status Beschreibung NOK Error General error (e.g. command format error, internal error) NOK Communication Abort The Job bit was removed before the handshake was finished (abort by PLC) NOK Invalid Command Invalid command code was set...
  • Page 258   BVS ID-M1280xF1-xx-xxx Command Responses Meaning Get Results Response with the last calculated result data. NOK Results No result data available. Set Inputs Setting the input data was successful. NOK Busy The application is currently in a mode in which requests can not be processed (ready status is curently false).
  • Page 259   BVS ID-M1280xF1-xx-xxx Command format Command structure (PLC → BVS ID): Getting the inspection program ID - Get Inspection ID Byte Value Note Message ID Length byte 0 Length byte 1 Command structure (PLC → BVS ID): Getting the results - Get Results Byte Value Note...
  • Page 260   BVS ID-M1280xF1-xx-xxx Command structure (PLC → BVS ID): Getting the timestamp - Get Date Time Byte Value Note Message ID Length byte 0 Length byte 1 Command structure (PLC → BVS ID): Setting the timestamp - Set Date Time Byte Value Note Message ID...
  • Page 261   BVS ID-M1280xF1-xx-xxx Structure of responses  NOTE All values are represented with the little-endian setting. Response (BVS ID → PLC): Setting the inspection program ID - Result: OK Byte Value Note Result code Length byte 0 (little-endian) Length byte 1 Data byte 0 Current inspection ID byte 0 ##hex...
  • Page 262   BVS ID-M1280xF1-xx-xxx Byte Value Note Length byte 0 Length result byte 0 Length byte 1 Length result byte 1 Inspection ID byte 0 Inspection ID byte 0 - the inspection program that generated the result container. Inspection ID byte 1 Inspection ID byte 1 Inspection ID byte 2 Inspection ID byte 2...
  • Page 263   BVS ID-M1280xF1-xx-xxx Response (BVS ID → SPS): Setting the input data - Set Inputs - Result: OK Set Inputs Byte Value Note Result Code Length byte 0 Length byte  1 Response (BVS ID → PLC): Getting the time stamp - Get Date Time - Result: OK Get Date Time Byte Value Note...
  • Page 264   BVS ID-M1280xF1-xx-xxx 4.3.7 Toggle commands and result data transmission The data of a command or result is transmitted the following way with the toggle process. Commands Example with command lenght of 20 bytes (payload length 17) and 7 bytes for data transmission per toggle cycle.
  • Page 265 4.Cycle Unused bytes in the last toggle cycle are ignored. 4.3.8 Function module To simplify the communication, Balluff GmbH provides following function blocks: • For Siemens controllers there is a PROFINET function block. Both can be downloaded from the Balluff website (www.balluff.com).
  • Page 266   BVS ID-M1280xF1-xx-xxx Get result container (without toggling) (4 byte result container) BVS ID 1. Process output buffer (observe 2. Process input buffer (observe sequence): sequence): → Command status: Command identifier Results) Data length byte 0 Data length byte 0 Data length byte 1 Data length byte 1 Set Job bit Inspection...
  • Page 267   BVS ID-M1280xF1-xx-xxx BVS ID Copy Inspection ID (4 hex ... bytes) ... 0D Copy result bytes Process output buffer: 4. Process input buffer: → Reset Job bit Reset Job End Get result container (with toggling) (23 byte result container) BVS ID 1. Process output buffer (observe 2.
  • Page 268   BVS ID-M1280xF1-xx-xxx BVS ID → Command status: Command identifier Results) Data length byte 0 Data length byte 0 Data length byte 1 Data length byte 1 Set Job bit Inspection ID byte 0 Inspection ID byte 1 Inspection ID byte 2 Inspection ID byte 3 Data byte 0: Result...
  • Page 269   BVS ID-M1280xF1-xx-xxx BVS ID → Invert TI Result byte 5 Result byte 15 Result byte 16 Invert TO ← 5. Read input buffer: Copy second 12 result bytes Process output buffer: 6. Process input buffer: → Invert TI Result byte 17 Result byte 22 Invert TO ←...
  • Page 270   BVS ID-M1280xF1-xx-xxx BVS ID Reset Job bit Reset Job End Result data: Set input data (with toggling) (27 byte input data) BVS ID 1. Process output buffer (observe 2. Read output buffer: sequence): → Copy first 11 input bytes Command identifier Data length byte 0 Data length byte 1 Input byte 0...
  • Page 271   BVS ID-M1280xF1-xx-xxx BVS ID → Input byte 11 Copy second 14 input bytes Input byte 12 Input byte 23 Input byte 24 Invert TI Process input buffer (observe sequence): ← Invert TO 5. Process output buffer: 6. Read output buffer: →...
  • Page 272   BVS ID-M1280xF1-xx-xxx BVS ID 7. Process output buffer: 8. Process input buffer → Reset Job bit Reset Job End Input data: • PLC sets wrong data length (FF = 255), but wants to transfer only four inspection ID bytes. • After the start of the handshake additional data is expected and toggle process is started.
  • Page 273   BVS ID-M1280xF1-xx-xxx Flow chart of a sample inspection with camera function module BVS_ID english ...
  • Page 274   BVS ID-M1280xF1-xx-xxx Flow chart of insepction switch with camera function module BVS_ID   english...
  • Page 275   BVS ID-M1280xF1-xx-xxx Overview of IO-Link Data and Functions 4.4.1 Overview of the included functions Primary functions • Identification • Device Discovery • Network Settings • Process Data • Signal Quality Secondary functions • Basic Statistics • Operating Hours Counter •...
  • Page 276   BVS ID-M1280xF1-xx-xxx 4.4.2 Device Variants The following two variants are available, which differ in their process data profiles: • Default • Comprehensive Condition Monitoring The functions remain unchanged in the process. A protocol is transferred in the process data. Variant Device ID Baud rate...
  • Page 277   BVS ID-M1280xF1-xx-xxx PD Output Byte 0 Byte 31 Protocol input buffer Comprehensive Condition Monitoring PD Input Byte 0 Byte 30 Protocol input buffer Byte 31 Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0 System Signal...
  • Page 278   BVS ID-M1280xF1-xx-xxx 4.4.4 ISDU – Identification Data Name Inde Subin Leng Data Data Default type Storage Identification Vendor Name STRING   “Balluff” 010  byte (16) s  Vendor Text STRING  "www.balluff.com” 011  byte (17) Product Name [...] STRING  e.g. "BVS ID-M1280BF1- 012 ...
  • Page 279   BVS ID-M1280xF1-xx-xxx Product Type ≤ 64 STRING  e.g. "BVS ID-M1280BF1- Code 700  byte L3-000" (179 Product Order STRING  e.g. "BVS0060" Code 701  byte (179 Product Licenses ≤ 64 STRING Byte (179 Device Identification Device Discovery  UINT16 Timeout 0FE  byte (254 Network Settings Network Settings Byte...
  • Page 280   BVS ID-M1280xF1-xx-xxx Current Signal UINT8 Quality Byte Signal Quality Bad 1 Bit BOOL Basic Statistics Statistics Data Configuration 426  byte (106 Input Signal UINT16( byte ENUM) Time Period Unit UINT8(E Seconds byte NUM) Time Period Value UINT16 byte Moving Average UINT8(E Measured values Window Unit...
  • Page 281   BVS ID-M1280xF1-xx-xxx Number Of UINT32 Samples byte Status UINT8 byte Operating Hours Counters Operating Hours Counter Byte (87) Current Operating UINT32 Hours Byte Total Operating UINT32 Hours Byte Custom Operating UINT32 Hours Byte Operating Hours UINT8(E Saving Mode Byte NUM) (116 Boot Cycle Counter...
  • Page 282   BVS ID-M1280xF1-xx-xxx Lifetime Extreme Thresholds byte   (208 Threshold FLOAT3 100.0 Vibration byte Upper Threshold INT16 Temperature  byte Lower Threshold INT16 Temperature  byte Lifetime Extreme Status byte   (209 State UINT8(E byte NUM) Time UINT32 byte Internal Temperature Device Temperature ...
  • Page 283   BVS ID-M1280xF1-xx-xxx Lifetime Maximum INT16 Device byte Temperature Device INT16 Temperature 053  byte Alarm (83) Configuration Lower Alarm Level INT16 Device byte Temperature Upper Alarm Level INT16 Device byte Temperature Inclination and Installation Aid Inclination Alarm Configuration 151  byte (852 Inclination Alarm BOOL...
  • Page 284   BVS ID-M1280xF1-xx-xxx Z Reference Value FLOAT3 byte Inclination UINT8 Deviation Value 154  byte (853 Vibration Detection Vibration Level FLOAT3 10E  byte 2  (846 Vibration Alarm Configuration 10F  byte (846 Vibration Alarm 1 byt BOOL Enable Vibration Alarm FLOAT3 Threshold byte 2 ...
  • Page 285   BVS ID-M1280xF1-xx-xxx Device Status UINT8 024  byte (36)  Detailed Device UINT8[ ] 0x00 0x00 … 0x00 Status 025  byte (37) Diagnosis Suppression Diagnosis Level UINT8(E Configuration 070  byte NUM) (112 Event Code Suppression 071  byte (113 Event Code 1...5 UINT16 Suppression byte...
  • Page 286   BVS ID-M1280xF1-xx-xxx Process Data Information and Configuration Process Data UINT8[ ] Input Descriptor 00E  byte (14) Process Data UINT8[ ] Output Descriptor 00F  byte (15) Profile Characteristic Profile UINT16[ Characteristic byte   (13)  Device Access Locks Device Access UINT16  Locks ...
  • Page 287   BVS ID-M1280xF1-xx-xxx 4.4.5 System Commands Command Value Device Action 0x80 (128) Device Reset – Device Reset means a warm start of the BVS ID. During this process, the microcontrollers are restarted and all initializations performed again without any change made to the parameter values 0x81 (129)  ...
  • Page 288   BVS ID-M1280xF1-xx-xxx 4.4.6 Events Event Code  Event Type Event – Description – Device Status Remedy 0x1850 (6224) Notification Process Data profile 0 – Device is operating properly. selection non applicable – Default value is used. 0x1851 (6225) Notification Process Data Update 0 –...
  • Page 289   BVS ID-M1280xF1-xx-xxx Event Code  Event Type Event – Description – Device Status Remedy 0x8CFF (36095)  Warning Low signal quality level 0 – Device is operating properly. 0x8D00 (36096)  Warning The measured value is below 2 – Out-of-Specification the measurement range. Accuracy cannot be warranted.
  • Page 290   BVS ID-M1280xF1-xx-xxx Event Code  Event Type Event – Description – Device Status Remedy 0x8D0E (36110) Notification The time has elapsed. This 0 – Device is operating properly. event reports the timeout of the minimum value/ maximum value/average calculation. It does not report a timeout for the calculation of the moving average because the timer repeats and it does not...
  • Page 291   BVS ID-M1280xF1-xx-xxx Event Code  Event Type Event – Description – Device Status Remedy 0x8D25 (36133) Error Parameters not consistent – 4 – Failure basic settings are used, service required. Parameterization processes and resets can no longer be performed. 0x8DC0 (36288) Notification Teach-in Timeout –...
  • Page 292   BVS ID-M1280xF1-xx-xxx 4.4.7 Communication parameters The basic IO-Link specification of BVS ID-M1280BF1-L3-000 is described as follows. Specification IO-Link Description Value Transmission rate COM  COM3 (230.4 kBaud) Minimum cycle time of device min cycle time 0x27 (3.9 ms) Frame specification: M-sequence capability: 0x1B –...
  • Page 293   BVS ID-M1280xF1-xx-xxx Variant name Device Transmis Minimum Frame IO-Link Qty. of process data identifi sion rate cycle specification protocol cation time of (Number of  version from the from the  device Preoperate on device to master to demand data the  required / master device...
  • Page 294 The identification data is used for the identification and management of the IO-Link devices. ISDU Name Inde Subin Leng Data Data Default Type Storag Vendor Name STRING   “Balluff” 010  byte (16) Vendor Text STRING  "www.balluff.com” 011  byte (17) Product Name [...] STRING ...
  • Page 295 With the Location Tag parameter, a string (maximum 32 bytes) can be written to the device. This value typically describes the location of the product in the application area. Product Type Code The Balluff type code is stored permanently in the BVS ID. Product Order Code The Balluff order code is stored permanently in the BVS ID.
  • Page 296   BVS ID-M1280xF1-xx-xxx Device Discovery Description With the Device Discovery function, an IO-Link device can be found again by starting signaling on the LED of the device by means of a system command. ISDU Name Inde Subin Leng Data Data Default Type Storag...
  • Page 297   BVS ID-M1280xF1-xx-xxx Name Inde Subin Leng Data Data Default Type Storag Gateway Address ≤ 15 STRING byte DHCP 1 Bit BOOL IP Address Here the fixed IP address of the BVS ID can be set and read (see SensorApp network settings). The IP address must correspond to the format "x.x.x.x".
  • Page 298   BVS ID-M1280xF1-xx-xxx Mathematics/Algorithm Signal quality if no codes were read If no codes were read, the signal quality is defined as undefined, represented by a signal quality value of 255. Signal quality of a read code The values of individual elements of the code quality of a read code are between A (best quality) and F (worst quality).
  • Page 299   BVS ID-M1280xF1-xx-xxx Object Name  Description Direction 0x0021 Signal Quality Output of the current signal quality evaluation; TRUE means a Input (33) signal quality below the threshold value, FALSE means a signal quality equal to or above the threshold value ISDU Name Inde...
  • Page 300   BVS ID-M1280xF1-xx-xxx Command Value Device Action 0x82 (130) Reset Factory Settings – Sets the threshold value with ISDU index 0xCE Low Signal Quality Threshold to default 0. The feature is thereby deactivated and the evaluation of index 0xCF subindex 2 always results in FALSE. Events Event Code Event Type...
  • Page 301   BVS ID-M1280xF1-xx-xxx 4.4.9 Secondary Device Functions Basic Statistics Description With the Basic Statistics function, statistics processes can be executed, such as the calculation of minimum, maximum and average. Furthermore, it is possible to calculate the moving average. With Basic Statistics, trends can be displayed for the selected entry over the specified duration (between 1 second and 1 week or 1 to 1000 sampling points).
  • Page 302   BVS ID-M1280xF1-xx-xxx Process Data Object ID Name  Description Direction 0x0053 (83) Minimum  Minimum value Input 0x0054 (84) Maximum  Maximum value Input 0x0055 (85) Average  Average  Input 0x0056 (86) Moving Average   Repeatedly calculated average value Input 0x0057 (87) Status  Status value Input 0x0058 (88) Number Of Samples...
  • Page 303   BVS ID-M1280xF1-xx-xxx Name Inde Subin Leng Data Data Default Type Storag Input Signal UINT16( byte ENUM) Time Period Unit UINT8(E Seconds byte NUM) Time Period Value UINT16 byte Moving Average UINT8(E Measurement values Window Unit byte NUM) Moving Average UINT16 Window Value byte...
  • Page 304   BVS ID-M1280xF1-xx-xxx Statistics Data Configuration: Input Signal All data types of process data objects can be used for input configuration, with the exception of Boolean. The respective Object IDs can be found in the respective section on the function. Default value is 0, this corresponds to No Object.
  • Page 305   BVS ID-M1280xF1-xx-xxx Value Meaning Description 0x02 (2)  Minutes  Minutes  0x03 (3)  Hours  Hours  0x04 (4)  Samples  Measurement  values Statistics Data Configuration: Moving Average Window Value The value for the moving average (moving average window) must be in the value range. To calculate the moving average, it is possible to select, for example, 1…1000 measurement values.
  • Page 306   BVS ID-M1280xF1-xx-xxx Bit position Meaning Description Buffer Overflow Event 1 – buffer overflow Timeout Event 1 – the set time for the minimum value/maximum value/ average  calculation has elapsed Reserved Reserved Reserved System Commands Command Value Device Action 0xA7 (167) Statistics Reset –...
  • Page 307   BVS ID-M1280xF1-xx-xxx Operating Hours Counter Description The operating hours counter can record the operating hours of a device accurately to the second. There are a total of three operating hours counters. In addition to an operating hours counter for the operating hours since the ...
  • Page 308   BVS ID-M1280xF1-xx-xxx Name Inde Subin Leng Data Data Default Type Storag Operating Hours UINT8(E Saving Mode byte NUM) (116  NOTE The maximum counter value that can be saved is 1,000,000 and, with a switch-on and switch-off every 12 minutes (with static counter), this means a service life of over 20 years. If switched on and off more frequently or in the case of dynamic storage, the maximum storage time is reduced depending on the application.
  • Page 309   BVS ID-M1280xF1-xx-xxx The output of the current boot cycle can serve as a control for the service interval as well as for preventative maintenance. Schedules for regular maintenance can be tied to the values of the Boot Cycle Counter. Process Data Object ID Name ...
  • Page 310   BVS ID-M1280xF1-xx-xxx Command Value Device Action 0xA5 (165) Maintenance Reset – Resets the Custom Boot Cycle Counter with ISDU-index 0x58 subindex 2 to the default value 0. Voltage and Current Monitoring Description The voltage and current module sends messages about over-current, short-circuit, wire breakage, over-voltage and under-voltage.
  • Page 311   BVS ID-M1280xF1-xx-xxx ISDU Name Inde Subin Leng Data Data Default Type Storag Voltage 0x22 UINT16 Monitoring 00  byte Detection  Time (870 Duration Voltage Monitoring Detection Time Duration This parameter is used to define how long the undervoltage or over-voltage must be present before it is displayed.
  • Page 312   BVS ID-M1280xF1-xx-xxx conditions. Parameter Lifetime Extreme Status can be used to read out the current status as well as the summed time. The calculation is based on the features Temperature, Moisture, Vibration. Mathematics/Algorithm If one (or more) extreme conditions are met, the BVS ID begins to record the time. ...
  • Page 313   BVS ID-M1280xF1-xx-xxx  NOTE For the internal humidity, it is not possible to parameterize your own limit values. Threshold Vibration Threshold value for the detection of excessive vibrations. Upper Threshold Temperature Threshold value for the detection of excessive temperature. Lower Threshold Temperature Threshold value for the detection of temperature that is too low.
  • Page 314   BVS ID-M1280xF1-xx-xxx Internal Temperature Description The BVS ID has internal temperature monitoring. This records the device temperature as well as the maximum and minimum values since production and since the last time the BVS ID was restarted. An upper and a lower threshold value can be defined for the device temperature module. If the threshold is exceeded or if device limit values are exceeded or undercut, the BVS ID triggers IO-Link events.
  • Page 315   BVS ID-M1280xF1-xx-xxx Name Inde Subin Leng Data Data Default Type Storag Lifetime Minimum INT16 Device byte Temperature Lifetime Maximum INT16 Device byte Temperature Device 0x00 INT16 Temperature 53  byte Alarm (83) Configuration Lower Alarm INT16 Level Device byte Temperature Upper Alarm Level INT16 Device...
  • Page 316   BVS ID-M1280xF1-xx-xxx Event Event Type Event – Description – Remedy Device Status Code 0x8D10 Warning Device Temperature Upper Warning – The set 0 – Device is operating (36112) upper temperature warning threshold has been properly. exceeded. 0x8D20 Warning Device Temperature Lower Warning – The set 0 –...
  • Page 317   BVS ID-M1280xF1-xx-xxx Non-recognizable adjustments Recognizable and non-recognizable adjustments: The adjustment can be a rotation, inclination or movement. With the function, the inclination (green arrow) can be detected, but shifts or rotation (red arrows) cannot. Mathematics/Algorithm The inclination deviation is compared neither directly with the horizontal plane nor with the vertical gravitational field, but rather with the orientation taught-in by the end user.In summary: •...
  • Page 318   BVS ID-M1280xF1-xx-xxx Name Index Subin Leng Data Data Default Type Storag Inclination Alarm  0x2 Status 152  byte (853 Inclination Alarm BOOL Teaching Status byte Inclination Alarm BOOL Status byte Reference Taught 0x21 Position 53  byte (853 X Reference Value FLOAT3 byte Y Reference...
  • Page 319   BVS ID-M1280xF1-xx-xxx Alarm Teaching Status Description Device has not yet been taught-in, no reference orientation set, inclination value not available. Device has been taught-in, reference orientation is set, inclination value is available. Use system command 0xC0 for teaching-in and defining reference orientation. ...
  • Page 320   BVS ID-M1280xF1-xx-xxx  NOTE The device cannot calculate the inclination until the reference position has been taught-in Command Vlaue Device Action 0xC0 (192) Set Reference Orientation – Sets the reference orientation of the  actual position of the BVS ID. Responses: ACK: command successful, reference stored.
  • Page 321 This function is based on the ISO-10816-3 standard, but for a detailed vibration analysis Balluff offers special sensors.
  • Page 322   BVS ID-M1280xF1-xx-xxx Process Data Object ID Name  Description Directio 0x004A (74) Vibration Level Vibration level Input 0x004B (75) Vibration Alarm Status Vibration alarm status Input The unit for Vibration Level is [mm/s]. The vibration alarm status flag is without units. ISDU Name Inde...
  • Page 323   BVS ID-M1280xF1-xx-xxx Vibration Alarm Threshold Threshold value of the vibration for triggering an event. The comparison is performed for each axis and variable with logical OR-link. The hysteresis is fixed and is based on time (not on amplitude). If the vibration value exceeds the threshold value for 50 ms, the alarm is activated.
  • Page 324   BVS ID-M1280xF1-xx-xxx ISDU Name Inde Subin Leng Data Data Default Type Storag Humidity 05C  byte (92) Humidity Bad BOOL  byte Operating Hours UINT32  At Exceedance byte Temperature At INT32  Exceedance byte Humidity Bad The status of the humidity is displayed as a Boolean value. If the value is TRUE, the signal quality is above the threshold value;...
  • Page 325   BVS ID-M1280xF1-xx-xxx Events Event Event Type Event – Description – Remedy Device Status Code 0x8D22 Warning Warning limit for write cycles reached – 0 – Device is operating (36130) maintenance monitoring no longer guaranteed – properly. for information purposes only. 0x8D23 Error Write cycle limit reached –...
  • Page 326   BVS ID-M1280xF1-xx-xxx Device Status and Detailed Device Status Description The Device Status feature provides information about the current device status Each Device Status is combined with a corresponding diagnostic message It also gives the user the possibility to actively read out currently pending events of the BVS ID. Process Data Object ID ...
  • Page 327 ID  or its peripheral devices. The BVS ID is not able to perform its intended function. Re-configuration (resetting to factory settings) can help. Otherwise, Balluff service must be contacted or the BVS ID device replaced. Detailed Device Status Detailed Device Status indicates the currently pending diagnosis messages (error, warning). For an event overview, see chapter "Events".
  • Page 328   BVS ID-M1280xF1-xx-xxx Diagnosis Suppression Description Diagnosis suppression is used to suppress diagnosis messages from the BVS ID. There are two possibilities here: • Diagnosis suppression level that permits a general suppression of messages of a certain level (message, warning, error). •...
  • Page 329   BVS ID-M1280xF1-xx-xxx Value Diagnosis Level Descriptions No events All diagnosis messages from the BVS ID are suppressed. Events For an event overview, see chapter "Events". Event Code Suppression This parameter indicates the currently suppressed event messages. The user can access the individual messages via subindex 0 or a specific subindex.
  • Page 330   BVS ID-M1280xF1-xx-xxx Command Value Device Action 0x81 (129) Application Reset – This reset is performed using IO-Link specification V1.1.2. – Resets all parameters and device settings to default values (with the exception of the  identification and tagging parameters) – No reset of the configuration of the device variant –...
  • Page 331 LED Meaning and Configuration Description Only the signal with the highest priority is displayed. The signals are listed in descending priority. Balluff Standard (LED 1 - IO-Link) Name  Signal Meaning Device Discovery...
  • Page 332   BVS ID-M1280xF1-xx-xxx Name  Signal Meaning Ready Green, static The BVS ID is ready. Firmware Update LED off The IO-Link firmware is updated. Namur Standard (LED 1 - IO-Link) Name  Signal Bedeutung Device Discovery Blue, flashing 3 Hz The Device Discovery can be activated via a system command to find the BVS ID again.
  • Page 333 It is possible to select between two different signaling standards with the help of a parameter. The parameter defines which signaling standard is to be used: Value Standard BALLUFF NAMUR The parameter is reset by Application Reset and Factory Reset.  Process Data Info and Configuration...
  • Page 334   BVS ID-M1280xF1-xx-xxx Name Inde Subin Leng Data Data Default Type Storag Process Data 0x00 UINT8[ ] Output Descriptor 0F  byte (15) PD Description This parameter is used to specify the structure of the currently selected process data profile for input and output data.
  • Page 335   BVS ID-M1280xF1-xx-xxx Event Event Type Event – Description – Remedy Device Status Code 0x1850 Notification Process data profile selection cannot be used – 0 – Device is operating (6224) default value is used. properly. The selection of the process data profile is dependent on the variant – the PD-profile IDs are assigned to one or more device variants.
  • Page 336   BVS ID-M1280xF1-xx-xxx Parameter Manager Description The parameter manager is responsible for the saving of parameters in the permanent memory of the BVS ID. On startup, all stored parameters are read from permanent memory; if parameters are changed, the data is stored within the permanent memory by the parameter manager.
  • Page 337 Description Example Returns list of all identificat identification topics. "firmwareRevision": "1.0.0", "hardwareRevision": "00", "nameOfStation": "B00005521200115", "productId": "BVS ID-M1280CF1-L3-000",  "productInstanceUri": "https:// products.balluff.com/BVS%20ID-M1280CF1-L3-000/ BVS0061", "productName": "BVS ID-M1280CF1-L3-000", "productText": "1D/2D code sensor, autofocus, w/IR light, IO-Link", "serialNumber": "D800005521200115", "vendorName": "Balluff",  "vendorUrl": "https://www.balluff.com" english ...
  • Page 338   BVS ID-M1280xF1-xx-xxx Diagnostics Topic Bedeutung Example /diagnostics Returns the list of Condition Monitoring data entries defined below. /diagnostics/ Number of operational hours. operatingHoursCou "operatingHoursCounter": nter {"value":193,"unit": "h"}, "operatingHoursCounterSin ceReset":{"value": 21,"unit": "h"} /diagnostics/ Number of boot cycles. {"bootCycleCounter": bootCycleCounter {"value":49}} /diagnostics/ Current vibration.
  • Page 339   BVS ID-M1280xF1-xx-xxx Operational Commands Topic Bedeutung Example /vision/inspection/id Returns the ID of the active inspection program. {"inspectionID": 0} /vision/inspection/ Returns the available result data. The result data results includes all entries which are specified by the "id":1, user in the Outputs tab of the configuration page. Note, that only one result is available which might "inspectionResult":true originate from the previous inspection run if the...
  • Page 340   BVS ID-M1280xF1-xx-xxx Product Status Signals Topic Bedeutung Example /vision/status Returns the list of status information entries defined below. /vision/status/ready Is set to false, if BVS ID is currently busy, and {"ready":false} cannot process any messages or signals at this moment.
  • Page 341 956115_AA · EN · K22; Subject to modification.
  • Page 342 Americas Service Center Asia Pacific Service Center Poland Greater China Balluff Sp. z o.o. Balluff Inc. Balluff Automation (Shanghai) Co., Ltd. Ul. Graniczna 21A 8125 Holton Drive No. 800 Chengshan Rd, 8F, Building A, 54-516 Wrocław Florence, KY 41042 Yunding International Commercial Plaza...

Table of Contents