FB_ArtNetReceive

Dieser Funktionsblock empfängt Art-Net Telegramme über UDP.

VAR_INPUT

    bExecute          : BOOL;
    sSrvNetId         : T_AmsNetId,
    sLocalHost        : T_IPv4Addr;
    nLocalPort        : UDINT;
    tTimeout          : TIME;

bExecute: Über eine positive Flanke an diesem Eingang beginnt der Baustein mit der Abarbeitung. Eine negative Flanke beendet die Abarbeitung.

sSrvNetId: String mit der Netzwerkadresse des TwinCAT TCP/IP Connection Servers. Für den lokalen Rechner (default) kann auch ein Leerstring angegeben werden.

sLocalHost: Die lokale IP-Adresse (IPv4) des UDP Client/Server-Sockets als String (z.B. '2.168.0.5'). Für den Default-Netzwerkadapter kann auch ein Leerstring angegeben werden.

nLocalPort: Die lokale IP-Portnummer des UDP Client/Server-Sockets (z.B. 6454).

tTimeout: Gibt die Timeout-Zeit an, die bei der Ausführung des Kommandos nicht überschritten werden darf.

VAR_OUTPUT

    bBusy                 : BOOL;
    bError                : BOOL;
    nErrorID              : UDINT;
    bArtPollReceived      : BOOL;
    stDmxData             : ST_DmxArtNetData;
    stFrameCounter        : ST_FrameCounter;
    aAvailableNodes       : ARRAY[0..31] OF ST_PollReplyParameter;

bBusy: Bei der Aktivierung des Funktionsbausteins wird dieser Ausgang gesetzt und bleibt gesetzt, bis eine Rückmeldung erfolgt.

bError: Sollte ein Fehler bei der Übertragung des Kommandos erfolgen, dann wird dieser Ausgang gesetzt, nachdem der bBusy-Ausgang zurückgesetzt wurde.

nErrorID: Liefert bei gesetztem bError-Ausgang den Fehlercode des zuletzt ausgeführten Arbeitsschritts.
Siehe Fehlercodes.

stDmxData: Diese Struktur beinhaltet die zuletzt empfangenen Daten.

stFrameCounter: Struktur mit Information über die Anzahl eingegangener 'ArtPoll'-, 'ArtPollReply'- und 'ArtDmx'-Telegramme.

aAvailableNodes: Liefert ein Array einer Struktur mit Informationen zu weiteren Art-Net™ Geräten, von denen ein 'ArtPollReply'-Telegramm gesandt wurde.

VAR_IN_OUT

    hSocket           : T_HSOCKET;

hSocket: Ein- und Ausgangsvariable mit dem Handle eines geöffneten UDP-Sockets; wird am Eingang 0 übergeben, so wird versucht, einen neuen Socket zu erstellen.
Bei Erfolg wird ein neuer Socket geöffnet und hSocket liefert das dazugehörige Socket-Handle.