FB_EcCoeSdoWrite

FB_EcCoeSdoWrite 1:

Mit dem Funktionsbaustein FB_EcCoeSdoWrite kann per SDO-Download ein Objekt aus dem Objektverzeichnis eines EtherCAT Slaves beschrieben 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 beschrieben werden soll.

       

VAR_INPUT

VAR_INPUT
    sNetId      : T_AmsNetId; 
    nSlaveAddr  : UINT; 
    nSubIndex   : BYTE; 
    nIndex      : WORD;
    pSrcBuf     : DWORD; 
    cbBufLen    : UDINT; 
    bExecute    : BOOL;
    tTimeout    : TIME := DEFAULT_ADS_TIMEOUT; 
END_VAR

sNetId: Ist ein String, der die AMS-Netzwerkkennung des EtherCAT Master Gerätes enthält.

nSlaveAddr: Feste Adresse des EtherCAT Slaves and den das SDO-Download Kommando geschickt werden soll.

nSubIndex: Subindex des Objektes, das geschrieben werden soll.

nIndex: Index des Objektes, das geschrieben werden soll.

pSrcBuf: Die Adresse (Pointer) auf den Sendepuffer.

cbBufLen: Die Anzahl der zu sendenden Daten in Bytes.

bExecute: Über eine positive Flanke an diesem Eingang wird der Baustein aktiviert.

tTimeout: Maximale Zeit, die bei der Ausführung des Funktionsbausteins nicht überschritten werden darf.

VAR_OUTPUT

VAR_OUTPUT
    bBusy       : BOOL;
    bError      : BOOL;
    nErrId      : UDINT;
END_VAR

bBusy: Dieser Ausgang wird bei der Aktivierung des Funktionsbausteins gesetzt und bleibt gesetzt, bis eine Rückmeldung erfolgt.

bError: Dieser Ausgang wird, nachdem der bBusy-Ausgang zurückgesetzt wurde, gesetzt, sollte ein Fehler bei der Übertragung des Kommandos erfolgen.

nErrId: Liefert bei einem gesetzten bError-Ausgang den ADS-Fehlercode des zuletzt ausgeführten Befehles

 

Beispiel für eine Implementierung in ST: 

PROGRAM TEST_SdoWrite

VAR
    fbSdoWrite      : FB_EcCoESdoWrite;
    sNetId          : T_AmsNetId := '172.16.2.131.2.1'; (* NetId of EtherCAT Master *)
    nSlaveAddr      : UINT := 1005; (* Port Number of EtherCAT Slave *)
    nIndex          : WORD := 16#4062; (* CoE Object Index *)
    nSubIndex       : BYTE := 1; (* Subindex of CoE Object *)
    nValue          : UINT := 2; (* variable to be written to the CoE Object *)
    bExecute        : BOOL; (* rising edge starts writing to the CoE Object *)
    bError          : BOOL;
    nErrId          : UDINT;
END_VAR


fbSdoWrite(
    sNetId      := sNetId,
    nSlaveAddr  := nSlaveAddr,
    nIndex      := nIndex,
    nSubIndex   := nSubIndex,
    pSrcBuf     := ADR(nValue),
    cbBufLen    := SIZEOF(nValue),
    bExecute    := bExecute
);


IF NOT fbSdoWrite.bBusy THEN
    bExecute := FALSE;
    IF NOT bError THEN 
        (* write successful *)
        bError := FALSE;
        nErrId := 0;
    ELSE 
        (* write failed *)
        bError := fbSdoWrite.bError;
        nErrId := fbSdoWrite.nErrId;
    END_IF

    fbSdoWrite(bExecute := FALSE);
END_IF

 

Voraussetzungen

Entwicklungsumgebung

Zielplattform

Einzubindende SPS Bibliotheken

TwinCAT v2.10.0 oder höher

PC or CX (x86)

TcEtherCAT.Lib
( Standard.Lib; TcBase.Lib; TcSystem.Lib, TcUtilities.Lib werden automatisch eingebunden )

TwinCAT v2.10.0 Build >= 1301 oder höher

CX (ARM)