FB_ArtNetReceive

This function block receives Art-Net telegrams via UDP.

VAR_INPUT

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

bExecute: The block starts processing if a positive edge is encountered at this input. A negative edge terminates processing.

sSrvNetId: String containing the network address of the TwinCAT TCP/IP Connection Server. For the local computer (default) an empty string may be specified.

sLocalHost: The local IP address (IPv4) of the UDP client/server socket as a string (e.g. '2.168.0.5'). An empty string may be specified for the default network adapter.

nLocalPort: The local IP port number of the UDP client/server socket (e.g. 6454).

tTimeout: States the length of the timeout that may not be exceeded during execution of the command.

VAR_OUTPUT

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

bBusy: When the function block is activated this output is set. It remains set until a feedback is received.

bError: If an error should occur during the transfer of the command, then this output is set once the bBusy output was reset.

nErrorID: Returns the error code of the last executed step, if the bError output is set.
See Error codes.

stDmxData: This structure contains the most recently received data.

stFrameCounter: Structure with information about the number of received 'ArtPoll', 'ArtPollReply' and 'ArtDmx' telegrams.

aAvailableNodes: Provides an array of a structure with information on further Art-Net™ devices, from which an 'ArtPollReply' telegram was sent.

VAR_IN_OUT

    hSocket       : T_HSOCKET;

hSocket: Input/output variable with the handle of an opened UDP socket. If the transfer takes place at input 0, the system tries to create a new socket.
If successful, a new socket is opened, and hSocket provides the associated socket handle.