FB_MDP_ReadIndex

	Update: Tc3_IPCDiag Bibliothek Die TwinCAT 3 SPS Bibliothek Tc2_MDP ist der Vorgänger zur Tc3_IPCDiag. Mit der neuen Tc3_IPCDiag Bibliothek wurde zum einen die Menge lesbarer Parameter vergrößert und zum anderen die Anwenderschnittstelle optimiert. Es wird empfohlen die Tc3_IPCDiag Bibliothek zu verwenden. Zukünftige Erweiterungen werden nicht mehr in der Tc2_MDP Bibliothek durchgeführt. Eine Verwendung der Tc2_MDP Bibliothek für neue Projekte wird nicht empfohlen. Alle Funktionalitäten der Tc2_MDP Bibliothek sind ebenfalls in der neuen Tc3_IPCDiag Bibliothek zu finden.

Der Funktionsbaustein ermöglicht das Abfragen eines beliebigen Elementes der IPC Diagnose. Neben der Configuration-Area sind auch Daten aus der Device-Area zugänglich.

VAR_INPUT

VAR_INPUT
    bExecute    : BOOL;             (* Function block execution is triggered by a rising edge at this input.*)
    nIndex      : WORD;
    nSubIndex   : BYTE;
    pDstBuf     : DWORD;            (* Contains the address of the buffer for the received data. *)
    cbDstBufLen : UDINT;            (* Contains the max. number of bytes to be received. *)
    tTimeout    : TIME := DEFAULT_ADS_TIMEOUT; (* States the time before the function is cancelled. *)
    sAmsNetId   : T_AmsNetId;       (* keep empty '' for the local device *)
END_VAR

bExecute: Mit einer positiven Flanke am Eingang bExecute wird der Funktionsbaustein aufgerufen, sofern der Baustein nicht aktiv ist.

nIndex: An diesem Eingang wird der erste Teil der Adressierung der geforderten IPC Diagnosedaten angegeben.

nSubIndex: An diesem Eingang wird der zweite Teil der Adressierung der geforderten IPC Diagnosedaten angegeben.

pDstBuf: An diesem Eingang wird die Speicheradresse des Datenpuffers angegeben. Dort werden bei erfolgreicher Abfrage die empfangenen Daten abgelegt.

cbDstBufLen: An diesem Eingang wird die Länge in Byte des Datenpuffers angegeben.

tTimeout: Gibt eine maximale Zeitdauer für die Ausführung des Funktionsbausteines an.

sAmsNetId: Um die Anfrage auf dem lokalen Gerät durchzuführen bedarf es keiner Angabe dieser Eingangsvariablen. Alternativ kann ein leerer String angegeben werden. Um die Anfrage an einen anderern Computer zu richten kann hier dessen AMS Net Id (vom Typ T_AmsNetId) angegeben werden.

VAR_OUTPUT

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

bBusy: Dieser Ausgang ist TRUE solange der Funktionsbaustein aktiv ist.

bError: Wird TRUE, sobald eine Fehlersituation eintritt.

nErrID: Liefert bei einem gesetzten bError-Ausgang einen Fehlercode.

nCount: Dieser Ausgang gibt die Anzahl der gelesenen Bytes an.

Voraussetzungen

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