FB_ArtNetSend

This function block sends Art-Net telegrams via UDP.

VAR_INPUT

    bExecute                  : BOOL;
    bArtPoll                  : BOOL;
    bArtPollReply             : BOOL;
    stPollReplyParameter      : ST_PollReplyParameter;
    sSrvNetId                 : T_AmsNetId,
    sLocalHost                : T_IPv4Addr;
    nLocalPort                : UDINT;
    sRemoteHost               : T_IPv4Addr;
    sDirectedBroadcastAddress : T_IPv4Addr;
    nRemotePort               : UDINT;
    tCycleTimeTransmit        : TIME;
    tTimeout                  : TIME;
    stDmxData                 : ST_DmxArtNetData;

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

bArtPoll: A one-off 'ArtPoll' telegram is sent via a positive edge at this input.
All Art-Net™ devices (including the sender) then respond with an 'ArtPollReply' telegram.

bArtPollReply: A one-off 'ArtPollReply' telegram is sent via a positive edge at this input.

stPollReplyParameter: This structure provides information for other Art-Net™ devices.

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).

sRemoteHost: The remote IP address (IPv4) of the UDP client/server socket as a string (e.g. '2.17.54.239').

sDirectedBroadcastAddress: The IP address (IPv4) for 'directed broadcasts' as a string (e.g. '2.255.255.255').
This address is used in 'broadcast' mode, and also for sending 'ArtPoll' and 'ArtPollReply' telegrams.

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

tCycleTimeTransmit: Determines the cycle in which the telegrams are sent (e.g. t#20ms).

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

stDmxData: This structure contains the data to be sent.

VAR_OUTPUT

    bBusy                     : BOOL;
    bError                    : BOOL;
    nErrorID                  : UDINT;
    stFrameCounterErrorID     : ST_FrameCounter;

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

bError: In the event of an error during the command transfer, this output is set once the bBusy output has been reset.

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

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

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.