FB_CoERead_ByDriveRef

Mit dem Funktionsbaustein FB_CoERead_ByDriveRef können Antriebsparameter mit Hilfe des "CANopen over EtherCAT (CoE)"-Protokolls gelesen werden. Dazu muss der Slave eine Mailbox besitzen und das "CANopen over EtherCAT (CoE)"-Protokoll unterstützen. Mit Hilfe der Parameter nSubIndex und nIndex wird ausgewählt, welches Objekt ausgelesen werden soll. Über bCompleteAccess := TRUE kann der Parameter mit Unterelementen gelesen werden.

Eingänge

VAR_INPUT
    stDriveRef       :  ST_DriveRef; (*Contains sNetID of EcMaster, nSlaveAddr of EcDrive, nDriveNo of EcDrive, either preset or read from NC*)
    nIndex           :  WORD; (*SoE IDN: e.g. “S_0_IDN+1” for S-0-0001 or “P_0_IDN+23” for P-0-0023*)
    nSubIndex        :  BYTE; 
    pDstBuf          :  PVOID; (*Contains the address of the buffer for the received data*)
    cbBufLen         :  UDINT; (*Contains the max. number of bytes to be received*) 
    bExecute         :  BOOL; (*Function block execution is triggered by a rising edge at this input*)
    tTimeout         :  TIME; (*States the time before the function is cancelled*)
    bCompleteAccess  :  BOOL;
END_VAR

Name	Typ	Beschreibung
stDriveRef	ST_DriveRef	Struktur, welche die AMS- Netzwerkkennung des EtherCAT-Master-Gerätes und die Adresse des Slave-Gerätes enthält. Die Referenz auf den Antrieb kann im System Manager direkt in die SPS gelinkt werden. Hierzu muss eine Instanz der ST_PlcDriveRef verwendet werden und die NEtID vom Bytearray in einem String konvertiert werden.
nIndex	WORD	Index des Objekts, das gelesen werden soll.
nSubIndex	BYTE	Subindex des Objekts, das gelesen werden soll.
pDstBuf	PVOID	Adresse (Pointer) auf den Empfangspuffer.
cbBufLen	UDINT	Maximal verfügbare Puffergröße für die zu lesenden Daten in Bytes
bExecute	BOOL	Über eine positive Flanke an diesem Eingang wird der Baustein aktiviert.
tTimeout	TIME	Maximale Zeit, die bei der Ausführung des Funktionsbausteins nicht überschritten werden darf.
bComplete Access	BOOL	Bei gesetztem bCompleteAccess kann der gesamte Parameter in einem Zugriff eingelesen werden.

Ausgänge

VAR_OUTPUT
    bBusy         : BOOL;
    bError        : BOOL;
    iAdsErrId     : UINT;
    iCANopenErrId : UINT;    
END_VAR

Name	Typ	Beschreibung
bBusy	BOOL	Dieser Ausgang wird bei der Aktivierung des Funktionsbausteins gesetzt und bleibt gesetzt, bis eine Rückmeldung erfolgt.
bError	BOOL	Dieser Ausgang wird gesetzt, nachdem der bBusy-Ausgang zurückgesetzt wurde, wenn bei der Übertragung des Kommandos ein Fehler auftritt.
iAdsErrId	UINT	Liefert bei gesetztem bError-Ausgang den ADS-Fehlercode des zuletzt ausgeführten Befehls.
iCANopenErrId	UINT	Liefert bei gesetztem bError-Ausgang den CANopen-Fehlercode.

Beispiel für eine Implementierung in ST:

PROGRAM MAIN
VAR
    fbCoERead       : FB_CoERead_ByDriveRef;
    stDriveRef      : ST_DriveRef; 
    nIndex          : WORD := 16#1018;
    nSubIndex       : BYTE := 1; 
    bExecute        : BOOL := TRUE;
    tTimeout        : TIME := T#5S;
    bCompleteAccess : BOOL := TRUE;
    vendorId        : UDINT;
    bError          : BOOL;
    nAdsErrId       : UDINT;
    nCANopenErrId   : UDINT;
END_VAR

fbCoERead(
    stDriveRef:= stDriveRef, 
    nIndex:= nIndex, 
    nSubIndex:= nSubIndex, 
    pDstBuf:= ADR(vendorId), 
    cbBufLen:= SIZEOF(vendorId), 
    bExecute:= bExecute, 
    tTimeout:= tTimeout, 
    bCompleteAccess:= bCompleteAccess, 
);

IF NOT fbCoERead.bBusy THEN
    bError:=fbCoERead.bError;
    nAdsErrId:=fbCoERead.iAdsErrId;
    nCANopenErrId:=fbCoERead.iCANopenErrId;
    bExecute := FALSE;
    fbCoERead(bExecute := bExecute);
END_IF

Voraussetzungen

Entwicklungsumgebung	Zielplattform	Einzubindende SPS- Bibliotheken
TwinCAT v3.1.0	PC oder CX (x86, x64, ARM)	Tc2_EtherCAT