IF_EntitiesHandler - AddTargetGenerator (Methode)

Überblick

Typ:

Methode

Verfügbar ab:

V1.6.0.0

Dieses Kapitel enthält folgende Informationen:

Aufgabe

Hinzufügen eines neuen Zielgenerators.

Beschreibung

Die Methode AddTargetGenerator fügt eine neue Zielgeneratoreinheit hinzu.

Schnittstelle

Eingang

Datentyp

Beschreibung

i_stData

ST_TrackingSystemData

Struktur, die die Daten zum hinzuzufügenden Zielgenerator enthält.

Ausgang

Datentyp

Beschreibung

q_etDiag

GD.ET_Diag

Allgemeingültige, bibliotheksunabhängige Aussage zur Diagnose. Ein Wert ungleich ET_Diag.Ok entspricht einer Diagnosemeldung.

q_etDiagExt

ET_DiagExt

POU-spezifischer Ausgang zur Diagnose:

  • q_etDiag = ET_Diag.Ok -> Statusmeldung

  • q_etDiag <> ET_Diag.Ok -> Diagnosemeldung

q_sMsg

STRING(80)

Ereignisabhängige Meldung, die zusätzliche Informationen über den Diagnosezustand gibt.

Diagnosemeldungen

q_etDiag

q_etDiagExt

Enumerationswert von q_etDiagExt

Beschreibung

Ok

OK

0

OK

ExecutionAborted

MaxNumberOfTargetGeneratorExceeded

170

Die maximale Anzahl konfigurierbarer Zielgeneratoren wurde erreicht.

InputParameterInvalid

TargeGeneratorIDInvalid

171

Eine angegebene Zielgenerator-ID ist ungültig.

InputParameterInvalid

TargetGeneratorIDDuplicated

172

Eine Zielgeneratoreinheit mit derselben ID ist bereits vorhanden.

InputParameterInvalid

OrientationConventionInvalid

38

Ungültige Orientierungskonvention.

InputParameterInvalid

TargetGeneratorNameInvalid

173

Der einer Zielgeneratoreinheit zugewiesene Name ist ungültig.

OK

Enumerationsname:

Ok

Enumerationswert:

0

Beschreibung:

Erfolg

MaxNumberOfTargetGeneratorExceeded

Enumerationsname:

MaxNumberOfTargetGeneratorExceeded

Enumerationswert:

170

Beschreibung:

Die maximale Anzahl konfigurierbarer Zielgeneratoren wurde erreicht.

Problem

Ursache

Lösung

Ein Zielgenerator wurde nicht zur Liste hinzugefügt.

Es ist nicht möglich, einen neuen Zielgenerator hinzuzufügen, da die maximale Anzahl an Zielgeneratoren erreicht wurde.

Stellen Sie sicher, dass dem Funktionsbaustein nicht mehr als SERT.Gc_udiMaxNumberOfTargetGenerators Zielgeneratoren hinzugefügt werden.

TargetGeneratorIdInvalid

Enumerationsname:

TargetGeneratorIdInvalid

Enumerationswert:

171

Beschreibung:

Eine angegebene Zielgenerator-ID ist ungültig.

Problem

Ursache

Lösung

Ein Zielgenerator wurde nicht zur Liste hinzugefügt.

i_stData.etSystemId enthält einen ungültigen Wert.

Stellen Sie sicher, dass die ID des Trackingsystems im Bereich von ET_SystemEntity.TargetGenerator1 bis ET_SystemEntity.TargetGenerator30 liegt.

TargetGeneratorIdDuplicated

Enumerationsname:

TargetGeneratorIdDuplicated

Enumerationswert:

172

Beschreibung:

Eine Zielgeneratoreinheit mit derselben ID ist bereits vorhanden.

Problem

Ursache

Lösung

Ein Zielgenerator wurde nicht zur Liste hinzugefügt.

Der Funktionsbaustein enthält bereits einen Zielgenerator mit der gleichen ID.

Stellen Sie sicher, dass jede den Zielgeneratoren zugewiesene ID eindeutig ist.

OrientationConventionInvalid

Enumerationsname:

OrientationConventionInvalid

Enumerationswert:

38

Beschreibung:

Ungültige Ausrichtungskonvention

Problem

Ursache

Lösung

Ein Zielgenerator wurde nicht zur Liste hinzugefügt.

i_stData.stBasePose.etOrientationConvention enthält einen ungültigen Orientierungskonventionswert.

Stellen Sie sicher, dass die Orientierungskonvention einen der folgenden Werte aufweist:

  • ROB.ET_OrientationConvention.XYZ

  • ROB.ET_OrientationConvention.ZYX

TargetGeneratorNameInvalid

Enumerationsname:

TargetGeneratorNameInvalid

Enumerationswert:

173

Beschreibung:

Der einer Zielgeneratoreinheit zugewiesene Name ist ungültig.

Problem

Ursache

Lösung

Ein Zielgenerator wurde nicht zur Liste hinzugefügt.

i_stData.sName enthält eine leere Zeichenfolge oder ein Zielgenerator mit derselben Zeichenfolge wurde bereits zugewiesen.

  • Stellen Sie sicher, dass der Name des Zielgenerators keine leere Zeichenfolge ist.

  • Stellen Sie sicher, dass der Name des Zielgenerators eindeutig ist.