Receive

Diese Methode ermöglicht das Empfangen eines UDP-Frames. Die Methode gibt TRUE zurück, wenn ein sACN-Frame empfangen wurde.

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: IPv4-Zieladresse, von der sACN-Frames empfangen werden. Unicast- und Multicast-Adressen sind möglich.

nTargetUniverse: Ziel-Universe, von dem der sACN-Frame empfangen wird.

 

REFERENCE TO … (OUTPUT)

sSourceName: Quellname der empfangenen sACN-Daten-Frames.

nDMXUniverse: DMX-Universe der empfangenen sACN-Daten-Frames.

aDMXData: Empfangene DMX-Daten.

sSrcHost: IPv4-Adresse des Remote-Geräts, von dem die sACN-Frames empfangen wurden.

nSrcPort: IPv4-Portnummer des Remote-Geräts, von dem die sACN-Frames empfangen wurden.

bStreamTerminated: Ist gleich TRUE, wenn die Datenquelle für das Universe die Übertragung beendet hat. In der Folge empfängt dieser Client keine sACN-Frames mehr.

stFrameCounter: Zähler der empfangenen sACN-Frames.

nSynchronUniverse: Synchronisations-Universe der empfangenen sACN-Daten-Frames.

sDiscoveredUniverse: Eine Liste der Universes, von denen sACN-Daten- und Synchronisations-Frames innerhalb von 10 s übertragen wurden.

1. sDiscoveredUniverse zeigt, welche Universes derzeit aktiv sind. Es wird aktualisiert, nachdem ein neuer Universe Discovery Frame angekommen ist. Es zeigt nichts (leerer String) bei FB_sACN.

2. Der Universe Discovery Frame und der Synchronization Frame sind neue Typen von sACN-Frames, die in sACN-2016 definiert werden. Diese beiden Frame-Typen können vom Zähler von FB_sACN (sACN-2009) nicht erkannt werden. Diese Frames können zwar empfangen werden, werden aber als „unbekannte“ Frames gezählt.