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 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 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 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] 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 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:

Eingang/Ausgang

Bedeutung

[0] [4] Handle

Handle auf den Client

[1] bAutosend

Das Autosend Flag ermöglicht automatisches Schicken des SubCommandos

[5] [6] SumUpHandle

Handle auf den SumUp

Hinweis

Sub Kommandos ohne Daten

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

Send SumUp

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

SumUp 7:

Eingang/Ausgang

Bedeutung

[0] [4] Handle

Handle auf den Client

[5] [6] SumUpHandle

Handle auf den SumUp

Hinweis

Sub Kommandos ohne Daten

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

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 Client

[5] SumUpHandle

Handle auf den SumUp