SumUp

Der Unterordner SumUp enthält Low-Level Blöcke, welche das Schreiben oder Lesen von mehreren ADS-Symbolen mit einem API Call ermöglichen. Im Vergleich zu einfachen ADS Read- oder Write-Anweisungen, wird für das Schreiben bzw. Lesen von mehreren Symbolen mit dem SumUp nur ein Handle benötigt. Das Handle kann wiederum mehrere Subkommandos enthalten, die gleichzeitig an die TwinCAT 3 Runtime gesendet werden.

SumUp 1:

Init SumUp

Der Block Init SumUp initialisiert den ADS SumUp. Bei erfolgreichem Aufruf gibt der Block ein Handle auf den ADS-SumUp zurück.

SumUp 2:

Eingang/Ausgang

Bedeutung

[0] [4] Handle

Handle auf den ADS-Client

[1] bAutosend?

Autosend Flag ermöglicht das automatische Senden des SubCommandos

[5] SumUp Mode

SumUp Modi:

  • Schreiben
  • Lesen

[6] SumUp Handle

Handle auf den SumUp

Add SubCommand

Der Block Add SubCommand initialisiert ein neues Sub-Kommando und fügt es dem SumUp Handle hinzu.

SumUp 3:

Eingang/Ausgang

Bedeutung

[0] [4] Handle

Handle auf den ADS-Client

[5] [6] SumUpHandle

Handle auf den SumUp

[7] [8] Symbol

ADS-Symbol bestehend aus AMS-Adresse und Symbol-Bezeichnung:

  • AMS-Adresse: Ist eine Zusammenstellung von AMS NetId und AMS-Port.
  • Symbol-Bezeichnung: Symbol-Name oder Index-Group/Offset

Beispiele für den Symbol-Namen:

  • AMS-Adresse und Symbol-Name: 127.0.0.0.1.1:851::MAIN.Var
  • AMS-Adresse und Index-Group/Offset: 127.0.0.0.1.1:851::0x1234/0x12345

Put Data

Der Block Put Data fügt dem initialisierten Sub-Kommando neue Daten hinzu. Dazu benötigt der Block den Symbol-Namen, um das Sub-Kommando zu identifizieren. Der Block kann nur für schreibende SumUp-Kommandos genutzt werden.

SumUp 4:

Eingang/Ausgang

Bedeutung

[0] [4] Handle

Handle auf den ADS-Client

[7] Symbol

ADS-Symbol bestehend aus AMS-Adresse und Symbol-Bezeichnung:

  • AMS-Adresse: Ist eine Zusammenstellung von AMS NetId und AMS-Port.
  • Symbol-Bezeichnung: Symbol-Name oder Index-Group/Offset

Beispiele für den Symbol-Namen:

  • AMS-Adresse und Symbol-Name: 127.0.0.0.1.1:851::MAIN.Var
  • AMS-Adresse und Index-Group/Offset: 127.0.0.0.1.1:851::0x1234/0x12345

[9] WriteData

Die zu schreibenden Daten

Get Data

Der Block Get Data ruft dem initialisierten Sub-Kommando neue Daten ab. Dazu benötigt der Block den Symbol-Namen, um das Sub-Kommando zu identifizieren. Der Block kann nur für lesende SumUp-Kommandos genutzt werden.

SumUp 5:

Eingang/Ausgang

Bedeutung

[0] [4] Handle

Handle auf den ADS-Client

[5] [6] SumUpHandle

Handle auf den SumUp

[7] Symbol

ADS-Symbol bestehend aus AMS-Adresse und Symbol-Bezeichnung:

  • AMS-Adresse: Ist eine Zusammenstellung von AMS NetId und AMS-Port.
  • Symbol-Bezeichnung: Symbol-Name oder Index-Group/Offset

Beispiele für den Symbol-Namen:

  • AMS-Adresse und Symbol-Name: 127.0.0.0.1.1:851::MAIN.Var
  • AMS-Adresse und Index-Group/Offset: 127.0.0.0.1.1:851::0x1234/0x12345

[9] Wait?

Wait Flag, das definiert, ob auf die zu lesenden Daten gewartet wird.

  • True: Der Block wartet bis zum Timeout, ob die neuen Daten reingekommen sind.
  • False: Der Block wartet nicht auf die neuen Daten.

[15] Read Data

Die zu lesenden Daten

Enable Autosend

Der Block Enable Autosend ermöglicht das automatische Senden des SumUp Kommandos.

SumUp 6:

Hinweis

Sub Kommandos ohne Daten

Das automatische Senden schlägt bei initialisierten Sub-Kommandos fehl, die keine Daten beinhalten.

Eingang/Ausgang

Bedeutung

[0] [4] Handle

Handle auf den ADS-Client

[1] bAutosend

Das Autosend Flag ermöglicht automatisches Schicken des SubCommandos

[5] [6] SumUpHandle

Handle auf den SumUp

Send

Der Block Send sendet die dem SumUp Handle hinzugefügten Sub-Kommandos an die TwinCAT 3 Runtime. Im Gegenteil zu Enable Autosend, muss der Send SumUp explizit zyklisch aufgerufen werden, um die Daten an TwinCAT zu senden.

SumUp 7:

Hinweis

Sub Kommandos ohne Daten

Das Senden schlägt bei initialisierten Sub Kommandos fehl, die keine Daten beinhalten.

Eingang/Ausgang

Bedeutung

[0] [4] Handle

Handle auf den ADS-Client

[5] [6] SumUpHandle

Handle auf den SumUp

Release SumUp

Der Block Release SumUp gibt den SumUp Handle aus dem Speicher frei.

SumUp 8:

Eingang/Ausgang

Bedeutung

[0] [4] Handle

Handle auf den ADS-Client

[5] SumUp Handle

Handle auf den SumUp