Receive

This method enables to receive UDP frame. The method returns TRUE if a sACN frame has been received.

Syntax

Method Receive : BOOL
VAR_INPUT
    sTargetHost                 : T_IPv4Addr := ‘239.255.0.1’;
    nTargetUniverse             : UINT;
    sSourceName                 : REFERENCE TO STRING(64);
    nDMXUniverse                : REFERENCE TO UINT;
    aDMXData                    : REFERENCE TO ARRAY[1..512] OF BYTE;
    sSrcHost                    : REFERENCE TO T_IPv4Addr;
    nSrcPort                    : REFERENCE TO UDINT;
    bStreamTerminated           : REFERENCE TO BOOL;
    stFrameCounter              : REFERENCE TO ST_FrameCounter;
    nSynchronUniverse           : REFERENCE TO UINT;
    sDiscoveredUniverse         : REFERENCE TO T_MaxString;
END_VAR

 

VAR_INPUT

sTargetHost: Target IPv4 address from which sACN frames will be received. Unicast and multicast addresses are possible.

nTargetUniverse : Target universe from which the sACN frame will be received.

 

REFERENCE TO … (OUTPUT)

sSourceName: Source Name of received sACN data frames.

nDMXUniverse : DMX universe of received sACN data frames.

aDMXData : Received DMX Data.

sSrcHost : IPv4 address of remote device from which the sACN frames have been received.

nSrcPort : IPv4 port number of remote device from which the sACN frames have been received.

bStreamTerminated : Is TRUE if data source for the universe has terminated transmission. In consequence this client will stop receiving sACN frames.

stFrameCounter : Counter of received sACN frames.

nSynchronUniverse : Synchronization universe of received sACN data frames.

sDiscoveredUniverse : A list of universes from which sACN data and synchronization frames have been transmitted within 10s.

1. sDiscoveredUniverse presents which universes are currently active. It refreshes after a new Universe Discovery frame has been arrived. It presents nothing (empty string) at FB_sACN.

2. The Universe Discovery Frame and Synchronization Frame are new types of sACN frames and they are defined in sACN-2016. These two types of frames cannot be recognized by the counter of FB_sACN (sACN-2009). These frames can be received but are counted as "Unknown" frames.