Sie sind auf Seite 1von 88

Softwarehandbuch

CEETIS TE
Access DLL
Funktionsbibliothek zur Steue-
rung von CEETIS

Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH


CEETIS TE Access DLL

Dieses Softwarehandbuch enthält Anleitungen zu Installation und Betrieb des


darin beschriebenen WEETECH-Produktes. Alle Daten und Informationen für die-
ses Handbuch wurden mit größter Sorgfalt zusammengestellt. Dennoch kann kei-
ne Garantie für eine völlige Fehlerfreiheit gegeben werden. Das Handbuch kann
jederzeit geändert werden, ohne dass dies bekannt gemacht werden muss.
Ebenso sind Änderungen in der beschriebenen Software vorbehalten. Aus redak-
tionellen Gründen ist es in seltenen Fällen möglich, dass die mitgelieferte Soft-
ware über Funktionen verfügt, die in diesem Handbuch noch nicht beschrieben
sind. Alle Änderungen und Weiterentwicklungen, die bis zur Auslieferung von
CEETIS vorgenommen wurden, sind daher in der Datei "WhatsNew.pdf " im
Ordner "Dokumentation" aufgeführt.
Die in diesem Handbuch verwendeten Screenshots und Abbildungen werden nur
zu Erklärungszwecken verwendet und können sich von der tatsächlichen Bild-
schirmanzeige und dem Aussehen der Produktversion unterscheiden.
Es wird ausdrücklich darauf hingewiesen, dass Garantie- und Haftungsansprüche
erlöschen, wenn die hier gegebenen Anleitungen unsachgemäß verwendet wer-
den oder das Gerät anders betrieben wird, als in diesem Handbuch bzw. autori-
sierter Ergänzungsdokumentation beschrieben.
Die in diesem Handbuch erwähnten Firmen- und Markennamen sind in den meis-
ten Fällen eingetragene Warenzeichen und unterliegen als solche den gesetzli-
chen Bestimmungen.
Dieses Handbuch darf ohne schriftliche Erlaubnis der WEETECH GmbH weder
ganz noch in Auszügen übernommen oder vervielfältigt werden.

CEETIS TE Access DLL


Funktionsbibliothek zur Steuerung von CEETIS
Softwarehandbuch
Dok. Nr.: 600020DE
5. Ausgabe, Revision E, herausgegeben im März 2022
© Copyright 2022 WEETECH GmbH
 Der Inhalt dieses Handbuchs bezieht sich auf die Softwareversion: 4.11-08

WEETECH GmbH
Hafenstraße 1
D-97877 Wertheim
Germany
Tel.: +49 (0) 9342 875-0
Fax: +49 (0) 9342 875-175
www.weetech.de

2 Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH


CEETIS TE Access DLL

Inhaltsverzeichnis
1 Allgemein................................................................................................... 6

2 Funktionsreferenz ..................................................................................... 8
2.1 TE-Steuerung ............................................................................ 8
2.1.1 open_project_finished ................................................. 8
2.1.2 activate_application ................................................... 10
2.1.3 create ........................................................................ 10
2.1.4 free............................................................................ 11
2.1.5 is_running ................................................................. 11
2.1.6 is_running_01 ........................................................... 11
2.1.7 open_project ............................................................. 12
2.1.8 run_test ..................................................................... 12
2.1.9 set_ui_enabled .......................................................... 13
2.1.10 shutdown................................................................... 13
2.1.11 startup ....................................................................... 14
2.1.12 test_finished .............................................................. 15
2.2 Elektrischer Test ..................................................................... 16
2.2.1 electrical_test_finished .............................................. 16
2.2.2 functioncall_capacitortest .......................................... 19
2.2.3 functioncall_connectiontest ....................................... 20
2.2.4 functioncall_dielectricbreakdowngrouptest ................ 21
2.2.5 functioncall_diodetest ................................................ 22
2.2.6 functioncall_isolationgrouptesthv ............................... 24
2.2.7 functioncall_isolationgrouptestlv ................................ 25
2.2.8 functioncall_measurecapacitance.............................. 26
2.2.9 functioncall_measurecurrentstim ............................... 27
2.2.10 functioncall_measureresistance ................................ 28
2.2.11 functioncall_measurevoltagestim .............................. 29
2.2.12 functioncall_noconnalldb ........................................... 30
2.2.13 functioncall_noconnallhv ........................................... 32
2.2.14 functioncall_noconnalllv ............................................ 33
2.2.15 functioncall_noconnectiondb ..................................... 34
2.2.16 functioncall_noconnectionhv ..................................... 36
2.2.17 functioncall_noconnectionlv....................................... 37
2.2.18 functioncall_noconngroupdb...................................... 38
2.2.19 functioncall_noconngrouphv ...................................... 40
2.2.20 functioncall_noconngrouplv ....................................... 42

Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH 3


CEETIS TE Access DLL

2.2.21 functioncall_pinscan ................................................. 44


2.2.22 functioncall_resistortest ............................................ 45
2.2.23 functioncall_rlcserialinductancetest .......................... 46
2.2.24 functioncall_wiretest ................................................. 47
2.3 Matrixaufschaltung ................................................................ 48
2.3.1 matrix_finished ......................................................... 48
2.3.2 functioncall_contactsetoff ......................................... 50
2.3.3 functioncall_contactseton ......................................... 51
2.3.4 functioncall_contactresetall ....................................... 52
2.3.5 functioncall_pinsethighlow ........................................ 53
2.3.6 functioncall_pinsetoffall ............................................ 54
2.3.7 functioncall_powerpinresetall .................................... 55
2.3.8 functioncall_powerupinsethigh .................................. 56
2.3.9 functioncall_powerupinsetlow ................................... 57
2.3.10 functioncall_powerupinsetoff .................................... 58
2.4 Generatorfunktionen ............................................................. 60
2.4.1 generator_finished .................................................... 60
2.4.2 functioncall_connectjackstomatrix ............................ 62
2.4.3 functioncall_gensetjacksenabled .............................. 63
2.4.4 functioncall_genvoltageon ........................................ 64
2.4.5 functioncall_genvoltageoff ........................................ 65
2.5 Parameterfunktionen ............................................................. 66
2.5.1 functioncall_paramcontinuity .................................... 66
2.5.2 functioncall_paramdielectricbreakdown .................... 68
2.5.3 functioncall_paramisolationhv ................................... 70
2.5.4 functioncall_paramisolationlv .................................... 72
2.5.5 functioncall_paramresetcontinuity............................. 73
2.5.6 functioncall_paramresetdielectricbreakdown ............ 73
2.5.7 functioncall_paramresetisolationhv ........................... 75
2.5.8 functioncall_paramresetisolationlv ............................ 75
2.6 Testsonde ............................................................................... 77
2.6.1 get_probe_pins......................................................... 77
2.6.2 start_probe ............................................................... 78
2.6.3 stop_probe ............................................................... 78
2.7 Testsystem ............................................................................. 79
2.7.1 test_system_command_finished............................... 79
2.7.2 close_safety_circuit .................................................. 81
2.7.3 is_safety_circuit_closed ............................................ 82
2.7.4 is_safety_circuit_hv_key_switch_closed ................... 83

4 Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH


CEETIS TE Access DLL

2.7.5 reset_test_system ..................................................... 84


2.7.6 set_warning_light_flashing ........................................ 85
2.8 Benutzerdefinierte Funktionsaufrufe .................................... 86
2.8.1 custom_function_finished .......................................... 86
2.8.2 execute_custom_function .......................................... 88

Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH 5


CEETIS TE Access DLL

1 Allgemein
Die CEETIS TE Access DLL ist eine dynamische Bibliothek (dynamic link library)
mit der man die CEETIS TE Testumgebung (Test Environment) fernsteuern kann.
Die beschriebenen Funktionen sind in die folgenden Kategorien aufgeteilt:
 TE-Steuerung
 Elektrischer Test
 Matrixaufschaltung
 Generator
 Parameter
 Testsonde
 Testsystem
 Benutzerdefinierte Funktionsaufrufe
Die Deklarationen der aufgeführten Funktionen sind jeweils in Delphi, C/C++ und
Visual Basic dargestellt. Zusätzlich ist für jede Funktion deren Zweck, Parameter und
Ergebnis detailliert beschrieben.
Einige der Funktionen in der DLL können bzw. müssen so lange in einer Schleife
aufgerufen werden, bis CEETIS einen Befehl abgeschlossen hat. In einer solchen
Warteschleife müssen auch Routinen aufgerufen werden, die dafür sorgen, dass
Fensterbotschaften verarbeitet werden. Abhängig von der verwendeten Program-
miersprache können die folgenden oder ähnliche Funktionen/Prozeduren verwendet
werden: DoEvents, Application.DoEvents();,
Application.ProcessMessages;

6 Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH


CEETIS TE Access DLL

Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH 7


CEETIS TE Access DLL

2 Funktionsreferenz

2.1 TE-Steuerung

2.1.1 open_project_finished
Delphi: function open_project_finished(pcResultBuffer:
pchar; iResultBufferSize: integer): integer;
stdcall;
C/C++: int open_project_finished(char *pcResultBuffer,
int iResultBufferSize);
Visual Basic: Private Declare Function open_project_finished&
Lib "CEETIS_TE_Access.dll" (ByVal pcResultBuffer$,
ByVal iResultBufferSize&)

Aufgabe
Diese Funktion gibt zurück, ob die Ausführung der Funktion „open_project“ beendet
ist oder nicht. Sie kann in einer Schleife nach dem Aufruf der Funktion
„open_project“ ausgeführt werden. Dabei wird so lange gewartet, bis der Testlauf
beendet ist. In dieser Schleife müssen auch Routinen aufgerufen werden, die dafür
sorgen, dass Fensterbotschaften verarbeitet werden.

Parameter
pcResultBuffer: Zeiger auf einen Pufferspeicher für den Ergebnisstring.
Die Mindestgröße des Puffers sollte 1024 Byte betragen.
iResultBufferSize: Größe des zugewiesenen Ergebnispuffers.

Rückgabewert
Der Rückgabewert ist 0, wenn „open_project“ nicht beendet ist.
Ist „open_project“ beendet, wird die Anzahl der Zeichen (inklusive aller Trennzei-
chen) zurückgegeben, die in den Ergebnispuffer geschrieben wurden. Der Puffer
enthält das Ergebnis als String.
Die Daten im String sind in Felder gegliedert. Jedes Feld wird durch „Wagenrücklauf
und Zeilenvorschub (CRLF = #13#10)” abgeschlossen.
Das erste Feld enthält allgemeine Informationen. Abhängig von seinen Werten ent-
hält das zweite Feld weitere Informationen. Zusätzliche Ergebnisdaten werden in
den folgenden Feldern ausgegeben.

8 Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH


CEETIS TE Access DLL

Wert in Feld 1 Beschreibung


executed Die Funktion wurde ausgeführt. Aktuell ist kein anderer Inhalt
für dieses Feld möglich.
 2. Feld: Enthält das Ergebnis (success oder failed)
 3. Feld: Weitere Informationen falls das Projekt nicht geöff-
net (failed) werden konnte. Die möglichen Werte sind in der
nachfolgenden Tabelle aufgelistet.

Die verschiedenen Ursachen, die das Öffnen eines Projektes verhindern können,
werden von der Funktion „open_project_finished“ im 3. Feld des Ergebnisstrings
ausgegeben.

Fehlertext Beschreibung
file not found Die Projektdatei konnte nicht gefunden werden
open project data Eine oder mehrere erforderlichen Dateien konnten nicht gefun-
den bzw. nicht geöffnet werden. Es handelt sich dabei um fol-
gende Dateien: Projektdatei, Testsystemkonfiguration, Parame-
terdatei.
open pin table Die Pintabelle konnte nicht gefunden bzw. nicht geöffnet wer-
den.
open optical pin Die optische Pintabelle konnte nicht gefunden bzw. nicht geöff-
table net werden.
create hardware Die Programmstrukturen für den Zugriff auf das Testsystem
access konnten nicht erstellt werden.
activate hardware Das Testsystem konnte nicht aktiviert werden.
init project Die Projektdaten konnten nicht initialisiert werden. Das beinhal-
tet das Laden folgender Daten:
 Ausgleichswerte und Programme für den Teststart, Testlauf,
Testinitialisierung, Testende, Bildschirmausgabe und Re-
porterzeugung.
activate safety Der Sicherheitskreis des Testsystems konnte nicht freigegeben
werden.
init pins for net- Die Initialisierung der Pins für die Netzwerkstruktur ist fehlge-
work schlagen.
unknown Ein unbekannter Fehler ist aufgetreten.

Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH 9


CEETIS TE Access DLL

2.1.2 activate_application
Delphi: function activate_application: boolean; stdcall;
C/C++: bool activate_application(void);
Visual Basic: Private Declare Function activate_application Lib
"CEETIS_TE_Access.dll" () as boolean

Aufgabe
Diese Funktion aktiviert die CEETIS TE und bringt sie in den Vordergrund.

Rückgabewert
Diese Funktion gibt TRUE zurück, wenn die CEETIS TE erfolgreich aktiviert wurde,
andernfalls FALSE.

2.1.3 create
Delphi: procedure create(pcTEExe: pchar); stdcall;
C/C++: void create(char *pcTEExe)
Visual Basic: Private Declare Sub create Lib
"CEETIS_TE_Access.dll" (ByVal pcTEExe$)

Aufgabe
Diese Routine erzeugt und initialisiert Routinen in der DLL. Sie muss einmal aufgeru-
fen werden, wenn die Hostanwendung startet.

Parameter
pcTEExe: Pfad und Dateiname der CEETIS_TE.exe

10 Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH


CEETIS TE Access DLL

2.1.4 free
Delphi: procedure free; stdcall;
C/C++: void free(void);
Visual Basic: Private Declare Sub free Lib
"CEETIS_TE_Access.dll" ()

Aufgabe
Diese Routine beendet die Routinen der DLL und gibt reservierten Speicher frei. Sie
muss einmal aufgerufen werden, wenn die Hostanwendung beendet wird.

2.1.5 is_running
Delphi: function is_running: boolean; stdcall;
C/C++: bool is_running(void);
Visual Basic: Private Declare Function is_running Lib
"CEETIS_TE_Access.dll" () as boolean

Aufgabe
Prüft, ob die CEETIS TE gestartet ist oder nicht.

Rückgabewert
Diese Funktion gibt TRUE zurück, wenn die CEETIS TE gestartet ist, andernfalls
FALSE.

2.1.6 is_running_01
Delphi: function is_running: integer; stdcall;
C/C++: int is_running(void);
Visual Basic: Private Declare Function is_running Lib
"CEETIS_TE_Access.dll" ()

Aufgabe
Prüft, ob die CEETIS TE gestartet ist oder nicht.

Rückgabewert
Diese Funktion gibt 1 zurück, wenn die CEETIS TE gestartet ist, andernfalls 0.

Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH 11


CEETIS TE Access DLL

2.1.7 open_project
Delphi: function open_project(pcProject: pchar): boolean;
stdcall;
C/C++: bool open_project(pchar pcProject);
Visual Basic: Private Declare Function open_project Lib
"CEETIS_TE_Access.dll" (ByVal pcProject$) as
boolean

Aufgabe
Diese Funktion öffnet ein Projekt, das in „pcProject“ übergeben wurde. Im Anschluss
an den Aufruf von „open_project“ müssen Sie „open_project_finished“ in einer
Schleife ausführen, um auf den Abschluss der Operation zu warten.

Rückgabewert
Der Rückgabewert ist TRUE, wenn das Projekt in der CEETIS TE erfolgreich geöff-
net wurde, andernfalls FALSE. Das Ergebnis der Projektöffnung wird zurückgege-
ben, wenn Sie „open_project_finished“ aufrufen.

Parameter
pcProject: Pfad und Dateiname des zu öffnenden Projekts.

2.1.8 run_test
Delphi: function run_test: boolean; stdcall;
C/C++: bool run_test(void);
Visual Basic: Private Declare Function run_test Lib
"CEETIS_TE_Access.dll" () as boolean

Aufgabe
Diese Funktion startet einen Test.

Rückgabewert
Der Rückgabewert ist TRUE, wenn der Test erfolgreich gestartet wurde, andernfalls
ist er FALSE.

12 Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH


CEETIS TE Access DLL

2.1.9 set_ui_enabled
Delphi: function set_ui_enabled(boEnabled: boolean):
boolean; stdcall;
C/C++: bool set_ui_enabled(bool boEnabled);
Visual Basic: Private Declare Function set_ui_enabled Lib
"CEETIS_TE_Access.dll" (boEnabled as boolean) as
boolean

Aufgabe
Diese Funktion aktiviert/deaktiviert die Bedienoberfläche der CEETIS TE. Damit
können Benutzereingaben verhindert werden, die den automatischen Testlauf stören
könnten. Wenn die Bedienoberfläche deaktiviert ist, sind alle Bedienelemente der
CEETIS TE ausgegraut und somit inaktiv.

Parameter
boEnabled: Wenn Sie für „boEnabled” TRUE übergeben, wird die Bedienober-
fläche aktiviert. Wenn Sie FALSE übergeben, wird die Bedienober-
fläche deaktiviert.

Rückgabewert
Der Rückgabewert ist TRUE, wenn die Routine erfolgreich in der CEETIS TE aufge-
rufen wurde, andernfalls ist der Rückgabewert FALSE.

2.1.10 shutdown
Delphi: function shutdown: boolean; stdcall;
C/C++: bool shutdown(void);
Visual Basic: Private Declare Function shutdown Lib
"CEETIS_TE_Access.dll" () as boolean

Aufgabe
Diese Funktion schließt die CEETIS TE.

Rückgabewert
Der Rückgabewert ist TRUE, wenn die CEETIS TE erfolgreich geschlossen wurde,
sonst FALSE.

Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH 13


CEETIS TE Access DLL

2.1.11 startup
Delphi: function startup(pcUsername, pcPassword: pchar;
boAutoOpenProject, boMinimized: boolean): boolean;
stdcall;
C/C++: bool startup(char *pcUsername, char *pcPassword;
bool boAutoOpenProject, boMinimized);
Visual Basic: Private Declare Function startup Lib
"CEETIS_TE_Access.dll" (ByVal pcUsername$, ByVal
pcPassword$, boAutoOpenProject, boMinimized as
boolean) as boolean

Aufgabe
Diese Funktion startet die CEETIS TE, falls diese noch nicht gestartet wurde.

Parameter
pcUsername: Benutzername, der benutzt werden soll. Wenn die Benut-
zerverwaltung ausgeschaltet ist, benutzt man „Admin“.
pcPassword: Passwort, das zum Benutzernamen gehört.
boAutoOpenProject: Wenn TRUE übermittelt wird, dann öffnet die CEETIS TE
automatisch das letzte benutzte Projekt. Wenn FALSE
übermittelt wird, wird kein Projekt geöffnet.
boMinimized: Wenn TRUE übermittelt wird, startet die CEETIS TE in
einem minimierten Fenster. Wenn FALSE übermittelt
wird, dann startet die CEETIS TE mit der letzten benutz-
ten Fenstergröße im Vordergrund.

Rückgabewert
Der Rückgabewert ist TRUE, wenn die CEETIS TE erfolgreich gestartet wurde, sonst
ist der Rückgabewert FALSE.

14 Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH


CEETIS TE Access DLL

2.1.12 test_finished
Delphi: function test_finished: integer; stdcall;
C/C++: int test_finished(void);
Visual Basic: Private Declare Function test_finished& Lib
"CEETIS_TE_Access.dll" ()

Aufgabe
Diese Funktion gibt zurück, ob ein Testlauf beendet ist oder nicht. Die Funktion kann
in dieser Schleife nach „run_test“ aufgerufen werden, um zu warten, bis der Testlauf
beendet ist. In einer Schleife müssen auch Routinen aufgerufen werden, die dafür
sorgen, dass Fensterbotschaften verarbeitet werden.

Rückgabewerte
 0 wenn der Test beendet und bestanden ist.
 >0 wenn der Test beendet und fehlgeschlagen ist. Der Rückgabewert besteht
aus der Anzahl der erkannten Fehler.
 -1 wenn der Test von einem Benutzer abgebrochen wurde.
 -2 wenn der Test noch nicht gestartet wurde.
 -3 wenn der Test noch läuft.
 -4 wenn der Test ungewöhnlich beendet wurde.

Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH 15


CEETIS TE Access DLL

2.2 Elektrischer Test


Nach dem Aufruf einer Funktion aus der Gruppe „Elektrischer Test“ müssen Sie war-
ten, bis diese beendet ist. Dies kann über einen Schleifenaufruf der Funktion
„electrical_test_finished“ geschehen. In einer solchen Warteschleife müssen auch
Routinen aufgerufen werden, die dafür sorgen, dass Fensterbotschaften verarbeitet
werden. Das Ergebnis des elektrischen Tests wird durch die Funktion
„electrical_test_finished“ zurückgegeben.

2.2.1 electrical_test_finished
Delphi: function electrical_test_finished(pcResultBuffer:
pchar; iResultBufferSize: integer): integer;
stdcall;
C/C++: int electrical_test_finished(char *pcResultBuffer,
int iResultBufferSize);
Visual Basic: Private Declare Function electrical_test_finished&
Lib "CEETIS_TE_Access.dll" (ByVal pcResultBuffer$,
ByVal iResultBufferSize&)

Aufgabe
Diese Funktion gibt zurück, ob der Aufruf einer Funktion aus der Gruppe Elektrischer
Test ausgeführt wurde oder nicht. Die Funktion kann nach dem Aufruf einer elektri-
schen Testfunktion über eine Schleife ausgeführt werden, die so lange durchlaufen
wird, bis der Test beendet ist. In dieser Schleife müssen auch Routinen aufgerufen
werden, die dafür sorgen, dass Fensterbotschaften verarbeitet werden.

Parameter
pcResultBuffer: Zeiger auf einen Pufferspeicher für den Ergebnisstring.
Der Puffer sollte eine Mindestgröße von 1024 Byte besit-
zen.
iResultBufferSize: Größe des zugewiesenen Ergebnispuffers.

Rückgabewert
Der Rückgabewert ist 0, wenn kein Testergebnis aus dem elektrischen Test vorliegt.
Sobald ein Ergebnis vorliegt, wird die Anzahl der Zeichen (inklusive aller Trennzei-
chen) zurückgegeben, die in den Ergebnispuffer geschrieben wurden. Der Puffer
enthält das Ergebnis als String.
Die Daten im String sind in Felder gegliedert. Jedes Feld wird durch „Wagenrücklauf
und Zeilenvorschub (CRLF = #13#10)” abgeschlossen.
Das erste Feld enthält allgemeine Informationen. Abhängig von seinem Wert, liefert
das zweite Feld Zusatzinformationen. Zusätzliche Ergebnisdaten werden in den

16 Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH


CEETIS TE Access DLL

nachfolgenden Feldern ausgegeben. Die Ergebnisdaten sind vom Typ der ausge-
führten Funktion abhängig.

Wert von Feld 1 Beschreibung


executed Die Funktion wurde ausgeführt.
 2. Feld: Enthält das Ergebnis (passed oder failed)
 nachfolgende Felder: Ergebnisdaten (siehe untenstehende
Beschreibungen der Funktionen)
function call error Während der Vorbereitung oder beim Aufruf einer Funktion ist
ein Fehler aufgetreten.
Eine mögliche Ursache dafür könnte sein, dass die zu testende
Komponente nicht in der Netzliste gefunden werden kann.

 2. Feld: Enthält unknown (derzeit keine anderen möglichen


Werte)
 nachfolgende Felder: nicht genutzt
not executed Der Funktionsaufruf ist gültig, aber die Funktion selbst wurde
aus irgendeinem Grund nicht ausgeführt.
 2. Feld: Enthält splice not referenced
(aktuell das einzig gültige Argument).
 nachfolgende Felder: nicht genutzt
invalid Das Ergebnis der Funktion ist ungültig.
 2. Feld: Enthält den Grund warum das Ergebnis ungültig ist.
- user break: Ausführung der Funktion wurde durch den
Benutzer unterbrochen
- external voltage: Es wurde während der Funktionsausfüh-
rung eine externe Spannung festgestellt.
- unknown: Unbekannte Ursache
 nachfolgende Felder: nicht genutzt
function execution Während der Ausführung einer Funktion ist ein Fehler aufgetre-
error ten.
 2. Feld: Enthält den Fehlertyp:
- safety circuit: Eine Unterbrechung des Sicherheitskrei-
ses wurde festgestellt.
- Hexadecimal value:
Fehlercode, der meistens das Ergebnis
eines ungültigen Parameters oder eines
Hardwareproblems ist.
- unknown: Unbekannter Fehler
 nachfolgende Felder: nicht genutzt

Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH 17


CEETIS TE Access DLL

In vielen Fällen geben die Funktionen des elektrischen Tests auch Messwerte zu-
rück. Diese Werte bestehen aus einem Vorzeichen und einem Fließkommawert. Das
Vorzeichen ist ein String mit dem folgenden Inhalt:

Inhalt Bedeutung
Kein Inhalt (leerer Der Fließkommawert ist exakt.
String)
< Der reale Wert ist kleiner als der Fließkommawert.
> Der reale Wert ist größer als der Fließkommawert.
% Der Gleitkommawert ist unzulässig, weil keine Messung mög-
lich war.

18 Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH


CEETIS TE Access DLL

2.2.2 functioncall_capacitortest
Delphi: function functioncall_capacitortest(pcName, pcPin1,
pcPin2: pchar): boolean; stdcall;
C/C++: bool functioncall_capacitortest(char *pcName, char
*pcPin1, char *pcPin2);
Visual Basic: Private Declare Function functioncall_capacitortest
Lib "CEETIS_TE_Access.dll" (ByVal pcName$, ByVal
pcPin1$, ByVal pcPin2$) as boolean

Aufgabe
Diese Funktion ruft „CapacitorTest“ in der CEETIS TE auf.
Um diese Funktion ausführen zu können, muss ein Projekt geöffnet sein.
„CapacitorTest“ bezieht sich immer auf einen Kondensator in der Netzliste.

Rückgabewert
Der Rückgabewert ist TRUE, wenn „CapacitorTest“ erfolgreich aufgerufen wurde,
andernfalls FALSE.

Parameter
pcName: Name des Kondensators
pcPin1: Name des ersten Pins
pcPin2: Name des zweiten Pins

Ergebnisdaten
Um einen Ergebnisstring zu erhalten, müssen Sie nach dem Ausführen von
„functioncall_capacitortest“ die Funktion „electrical_test_finished“ so lange in einer
Schleife ausführen, bis „functioncall_capacitortest“ beendet ist. Nach Beenden der
Funktion enthält der Ergebnisstring im 2. Feld passed oder failed. Das 3. und 4. Feld
enthält die Messdaten.

Feldnummer Beschreibung
3 Wertevorzeichen (siehe electrical_test_finished)
4 Gemessener Wert in Farad

Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH 19


CEETIS TE Access DLL

2.2.3 functioncall_connectiontest
Delphi: function functioncall_connectiontest(pcName, pcPin1,
pcPin2: pchar): boolean; stdcall;
C/C++: bool functioncall_connectiontest(char *pcName, char
*pcPin1, char *pcPin2);
Visual Basic: Private Declare Function functioncall_connectiontest
Lib "CEETIS_TE_Access.dll" (ByVal pcName$, ByVal
pcPin1$, ByVal pcPin2$) as boolean

Aufgabe
Diese Funktion ruft „ConnectionTest“ in der CEETIS TE auf. Um diese Funktion aus-
führen zu können, muss ein Projekt geöffnet sein.

Rückgabewert
Der Rückgabewert ist TRUE, wenn „ConnectionTest“ erfolgreich in der CEETIS TE
aufgerufen wurde, andernfalls FALSE.

Parameter
pcName: Name des Tests
pcPin1: Name des ersten Pins
pcPin2: Name des zweiten Pins

Ergebnisdaten
Um einen Ergebnisstring zu erhalten, müssen Sie nach dem Ausführen von
„functioncall_connectiontest“ die Funktion „electrical_test_finished“ so lange in einer
Schleife ausführen, bis „functioncall_connectiontest“ beendet ist. Nach Beenden der
Funktion enthält der Ergebnisstring im 2. Feld passed oder failed. Das 3. und 4. Feld
enthält die Messdaten.

Feldnummer Beschreibung
3 Wertevorzeichen (siehe electrical_test_finished)
4 Gemessener Wert in Ohm

20 Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH


CEETIS TE Access DLL

2.2.4 functioncall_dielectricbreakdowngrouptest
Delphi: function
functioncall_dielectricbreakdowngrouptest():
boolean; stdcall;
C/C++: bool functioncall_dielectricbreakdowngrouptest();
Visual Basic: Private Declare Function
functioncall_dielectricbreakdowngrouptest Lib
"CEETIS_TE_Access.dll" () as boolean

Aufgabe
Die Funktion ruft „DielectricBreakdownGroupTest” in der CEETIS TE auf. Um diese
Funktion ausführen zu können, muss ein Projekt geöffnet sein.

Rückgabewert
Der Rückgabewert ist TRUE, wenn „DielectricBreakdownGroupTest” erfolgreich in
der CEETIS TE aufgerufen wurde, andernfalls FALSE.

Ergebnisdaten
Nach „functioncall_dielectricbreakdowngrouptest” müssen Sie „electrical_test_finished”
in einer Schleife aufrufen, um auf das Ende der Ausführung zu warten und den Ergeb-
nisstring zu erhalten. Wenn die Funktion ausgeführt wurde, enthält der Ergebnisstring
im 2. Feld passed oder failed und im 3. Feld die Anzahl der gefundenen Fehler.

Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH 21


CEETIS TE Access DLL

2.2.5 functioncall_diodetest
Delphi: function functioncall_diodetest(pcName, pcPin1,
pcPin2: pchar): boolean; stdcall;
C/C++: bool functioncall_diodetest(char *pcName, char
*pcPin1, char *pcPin2);
VisualBasic: Private Declare Function functioncall_diodetest Lib
"CEETIS_TE_Access.dll" (ByVal pcName$, ByVal
pcPin1$, ByVal pcPin2$) as boolean

Aufgabe
Diese Funktion ruft „DiodeTest“ in der CEETIS TE auf.
Um diese Funktion ausführen zu können, muss ein Projekt geöffnet sein.
„DiodeTest“ bezieht sich immer auf eine Diode in der Netzliste.

Rückgabewert
Der Rückgabewert ist TRUE, wenn „DiodeTest“ erfolgreich aufgerufen wurde, an-
dernfalls FALSE.

Parameter
pcName: Name der Diode
pcPin1: Name des ersten Pins
pcPin2: Name des zweiten Pins

Ergebnisdaten
Um einen Ergebnisstring zu erhalten, müssen Sie nach dem Ausführen von
„functioncall_diodetest“ die Funktion „electrical_test_finished“ so lange in einer
Schleife ausführen, bis „functioncall_diodetest“ beendet ist. Nach Beenden der Funk-
tion enthält der Ergebnisstring im 2. Feld passed oder failed. Das 3. / 4. / 5. und
6. Feld enthält die Messdaten.

22 Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH


CEETIS TE Access DLL

Feldnummer Beschreibung
3 Vorzeichen für den gemessenen Wert in Durchlassrichtung
(siehe electrical_test_finished)
4 Gemessener Wert in Durchlassrichtung (in Volt)
5 Vorzeichen für den gemessenen Wert in Sperrrichtung
(siehe electrical_test_finished)
6 Gemessener Wert in Sperrrichtung (in Volt)

Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH 23


CEETIS TE Access DLL

2.2.6 functioncall_isolationgrouptesthv
Delphi: function functioncall_isolationgrouptesthv():
boolean; stdcall;
C/C++: bool functioncall_isolationgrouptesthv();
Visual Basic: Private Declare Function
functioncall_isolationgrouptesthv Lib
"CEETIS_TE_Access.dll" () as boolean

Aufgabe
Die Funktion ruft „IsolationGroupTestHV” in der CEETIS TE auf. Um diese Funktion
ausführen zu können, muss ein Projekt geöffnet sein.

Rückgabewert
Der Rückgabewert ist TRUE, wenn „IsolationGroupTestHV” erfolgreich in der
CEETIS TE aufgerufen wurde, andernfalls FALSE.

Ergebnisdaten
Nach „functioncall_isolationgrouptesthv” müssen Sie „electrical_test_finished” in
einer Schleife aufrufen, um auf das Ende der Ausführung zu warten und den Ergeb-
nisstring zu erhalten. Wenn die Funktion ausgeführt wurde, enthält der Ergeb-
nisstring im 2. Feld passed oder failed und im 3. Feld die Anzahl der gefundenen
Fehler.

24 Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH


CEETIS TE Access DLL

2.2.7 functioncall_isolationgrouptestlv
Delphi: function functioncall_isolationgrouptestlv():
boolean; stdcall;
C/C++: bool functioncall_isolationgrouptestlv();
Visual Basic: Private Declare Function
functioncall_isolationgrouptestlv Lib
"CEETIS_TE_Access.dll" () as boolean

Aufgabe
Die Funktion ruft „IsolationGroupTestLV” in der CEETIS TE auf. Um diese Funktion
ausführen zu können, muss ein Projekt geöffnet sein.

Rückgabewert
Der Rückgabewert ist TRUE, wenn „IsolationGroupTestLV” erfolgreich in der
CEETIS TE aufgerufen wurde, andernfalls FALSE.

Ergebnisdaten
Nach „functioncall_isolationgrouptestlv” müssen Sie „electrical_test_finished” in einer
Schleife aufrufen, um auf das Ende der Ausführung zu warten und den Ergeb-
nisstring zu erhalten. Wenn die Funktion ausgeführt wurde, enthält der Ergeb-
nisstring im 2. Feld passed oder failed und im 3. Feld die Anzahl der gefundenen
Fehler.

Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH 25


CEETIS TE Access DLL

2.2.8 functioncall_measurecapacitance
Delphi: function functioncall_measurecapacitance(pcPin1,
pcPin2, pcMaxVoltage_V, pcExpected_F: pchar):
boolean; stdcall;
C/C++: bool functioncall_measurecapacitance(char *pcPin1,
char *pcPin2, char *pcMaxVoltage_V, char
*pcExpected_F);
VisualBasic: Private Declare Function
functioncall_measurecapacitance Lib
"CEETIS_TE_Access.dll" (ByVal pcPin1$, ByVal
pcPin2$, ByVal pcMaxVoltage_V$, ByVal
pcExpected_F$) as boolean

Aufgabe
Diese Funktion ruft „MeasureCapacitance“ in der CEETIS TE auf. Um diese Funktion
ausführen zu können, muss ein Projekt geöffnet sein.

Rückgabewert
Der Rückgabewert ist TRUE, wenn „MeasureCapacitance“ erfolgreich aufgerufen
wurde, andernfalls FALSE.

Parameter
pcPin1: Name des ersten Pins
pcPin2: Name des zweiten Pins
pcMaxVoltage_V: Maximale Spannung in Volt. Wenn ein Leerstring übergeben
wird, wird der Vorgabewert (4V) benutzt.
pcExpected_F: Erwarteter Wert in Farad. Wenn ein Leerstring übergeben
wird, wird der Vorgabewert (1µF) benutzt.

Ergebnisdaten
Nach „functioncall_measurecapacitance“ müssen Sie „electrical_test_finished“ in
einer Schleife aufrufen, um auf das Ende der Ausführung zu warten und den Ergeb-
nisstring zu erhalten. Wenn die Funktion ausgeführt wurde, enthält der Ergeb-
nisstring passed im 2. Feld und Messdaten im 3. und 4. Feld.

Feldnummer Beschreibung
3 Vorzeichen für den gemessenen Wert
(siehe electrical_test_finished)
4 Gemessener Wert in Farad

26 Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH


CEETIS TE Access DLL

2.2.9 functioncall_measurecurrentstim
Delphi: function functioncall_measurecurrentstim(pcPin1,
pcPin2, pcVoltage_V, pcMaxCurrent_A, pcTrise_s,
pcTwait_s, pcTmeas_s: pchar): boolean; stdcall;
C/C++: bool functioncall_ measurecurrentstim(char *pcPin1,
char *pcPin2, char *pcVoltage_V, char
*pcMaxCurrent_A, char *pcTrise_s, char *pcTwait_s,
char *pcTmeas_s);
VisualBasic: Private Declare Function
functioncall_measurecurrentstim Lib
"CEETIS_TE_Access.dll" (ByVal pcPin1$, ByVal
pcPin2$, ByVal pcVoltage_V$, ByVal pcMaxCurrent_A$,
ByVal pcTrise_s$, ByVal pcTwait_s$, ByVal
pcTmeas_s$) as boolean

Aufgabe
Diese Funktion ruft „MeasureCurrentStim“ in der CEETIS TE auf. Um diese Funktion
ausführen zu können, muss ein Projekt geöffnet sein.

Rückgabewert
Der Rückgabewert ist TRUE, wenn „MeasureCurrentStim“ erfolgreich aufgerufen
wurde, andernfalls FALSE.

Parameter
pcPin1: Name des ersten Pins
pcPin2: Name des zweiten Pins
pcVoltage_V: Spannung für die Stimulation in Volt
pcMaxCurrent_A: Maximalstrom in Ampere
pcTrise_s: Maximale Anstiegszeit in Sekunden
pcTwait_s: Maximale Wartezeit in Sekunden
pcTmeas_s: Maximale Messzeit in Sekunden

Ergebnisdaten
Nach „functioncall_measurecurrentstim“ müssen Sie „electrical_test_finished“ in
einer Schleife aufrufen, um auf das Ende der Ausführung zu warten und den Ergeb-
nisstring zu erhalten. Wenn die Funktion ausgeführt wurde, enthält der Ergeb-
nisstring passed im 2. Feld und Messdaten im 3. und 4. Feld.

Feldnummer Beschreibung
3 Vorzeichen für den gemessenen Wert (siehe „electrical_test_finished“)
4 Gemessener Wert in Ampere

Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH 27


CEETIS TE Access DLL

2.2.10 functioncall_measureresistance
Delphi: function functioncall_measureresistance(pcPin1,
pcPin2, pcMaxPower_W: pchar): boolean; stdcall;
C/C++: bool functioncall_measureresistance(char *pcPin1,
char *pcPin2, char *pcMaxPower_W);
VisualBasic: Private Declare Function
functioncall_measureresistance Lib
"CEETIS_TE_Access.dll" (ByVal pcPin1$, ByVal
pcPin2$, ByVal pcMaxPower_W$) as boolean

Aufgabe
Diese Funktion ruft „MeasureResistance“ in der CEETIS TE auf. Um diese Funktion
ausführen zu können, muss ein Projekt geöffnet sein.

Rückgabewert
Der Rückgabewert ist TRUE, wenn „MeasureResistance“ erfolgreich aufgerufen
wurde, andernfalls FALSE.

Parameter
pcPin1: Name des ersten Pins
pcPin2: Name des zweiten Pins
pcMaxPower_W: Maximale Leistung in Watt. Wenn ein Leerstring übergeben wird,
wird der Vorgabewert (0.5W) benutzt.

Ergebnisdaten
Nach „functioncall_measureresistance“ müssen Sie „electrical_test_finished“ in einer
Schleife aufrufen, um auf das Ende der Ausführung zu warten und den Ergeb-
nisstring zu erhalten. Wenn die Funktion ausgeführt wurde, enthält der Ergeb-
nisstring passed im 2. Feld und Messdaten im 3. und 4. Feld.

Feldnummer Beschreibung
3 Vorzeichen für den gemessenen Wert
(siehe electrical_test_finished)
4 Gemessener Wert in Ohm

28 Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH


CEETIS TE Access DLL

2.2.11 functioncall_measurevoltagestim
Delphi: function functioncall_measurevoltagestim(pcPin1,
pcPin2, pcCurrent_A, pcMaxVoltage_V, pcTrise_s,
pcTwait_s, pcTmeas_s: pchar): boolean; stdcall;
C/C++: bool functioncall_ measurevoltagestim(char *pcPin1,
char *pcPin2, char *pcCurrent_A, char
*pcMaxVoltage_V, char *pcTrise_s, char *pcTwait_s,
char *pcTmeas_s);
VisualBasic: Private Declare Function
functioncall_measurevoltagestim Lib
"CEETIS_TE_Access.dll" (ByVal pcPin1$, ByVal
pcPin2$, ByVal pcCurrent_A$, ByVal pcMaxVoltage_V$,
ByVal pcTrise_s$, ByVal pcTwait_s$,
ByVal pcTmeas_s$) as boolean

Aufgabe
Diese Funktion ruft „MeasureVoltageStim“ in der CEETIS TE auf. Um diese Funktion
ausführen zu können, muss ein Projekt geöffnet sein.

Rückgabewert
Der Rückgabewert ist TRUE, wenn „MeasureVoltageStim“ erfolgreich aufgerufen
wurde, andernfalls FALSE.

Parameter
pcPin1: Name des ersten Pins
pcPin2: Name des zweiten Pins
pcCurrent_A: Strom für die Stimulation in Ampere
pcMaxVoltage_V: Maximalspannung in Volt
pcTrise_s: Maximale Anstiegszeit in Sekunden
pcTwait_s: Maximale Wartezeit in Sekunden
pcTmeas_s: Maximale Messzeit in Sekunden

Ergebnisdaten
Nach „functioncall_measurevoltagestim“ müssen Sie „electrical_test_finished“ in
einer Schleife aufrufen, um auf das Ende der Ausführung zu warten und den Ergeb-
nisstring zu erhalten. Wenn die Funktion ausgeführt wurde, enthält der Ergeb-
nisstring passed im 2. Feld und Messdaten im 3. und 4. Feld.

Feldnummer Beschreibung
3 Vorzeichen für den gemessenen Wert (siehe „electrical_test_finished“)
4 Gemessener Wert in Volt

Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH 29


CEETIS TE Access DLL

2.2.12 functioncall_noconnalldb
Delphi: function functioncall_noconnalldb(pcName, pcPin:
pchar): boolean; stdcall;
C/C++: bool functioncall_noconnalldb(char *pcName, char
*pcPin);
Visual Basic: Private Declare Function functioncall_noconnalldb
Lib "CEETIS_TE_Access.dll" (ByVal pcName$, ByVal
pcPin$) as boolean

Aufgabe
Diese Funktion ruft „NoConnAllDB“ in der CEETIS TE auf. Um diese Funktion aus-
führen zu können, muss ein Projekt geöffnet sein.

Rückgabewert
Der Rückgabewert ist TRUE, wenn „NoConnAllDB“ erfolgreich aufgerufen wurde,
andernfalls FALSE.

Parameter
pcName: Name des Tests
pcPin: Name des Pins

Ergebnisdaten
Um einen Ergebnisstring zu erhalten, müssen Sie nach dem Ausführen von
„functioncall_noconnectiondb“ die Funktion „electrical_test_finished“ so lange als
Schleife ausführen, bis „functioncall_noconnectiondb“ beendet ist. Nach Beenden
der Funktion enthält der Ergebnisstring im 2. Feld passed oder failed. Im 3. bis 7.
Feld sind Messdaten enthalten. Die Messdaten sind nur dann gültig, wenn der Test
erfolgreich (gut) war. Andernfalls enthalten die Felder 8 und 9 die Pins, zu denen ein
Schluss gefunden wurde. Das 8. Feld enthält die Anzahl dieser Pins und Feld 9 die
Namen.

30 Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH


CEETIS TE Access DLL

Feldnummer Beschreibung
3 Flag, ob der gemessene Wert gültig ist. Der Wert ist gültig, wenn
Ihr Testsystem in der Lage ist, den Strom zu messen. Das Feld
enthält „valid“, wenn das Testsystem in der Lage ist, den Strom zu
messen, andernfalls ist es leer.
4 Vorzeichen für den realen Anteil des gemessenen Stroms
(siehe „electrical_test_finished“)
5 Realer Anteil des gemessenen Stroms in Ampere.
6 Vorzeichen für den imaginären Anteil des Stroms
(siehe „electrical_test_finished“)
7 Imaginärer Anteil des gemessenen Stroms in Ampere.
8 Anzahl der Pins, zu denen ein Schluss detektiert wurde.
9 Namen der Pins, zu denen ein Schluss detektiert wurde. Jeder
Pinname wird mit einem Tabulator (TAB = #9) abgeschlossen.

Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH 31


CEETIS TE Access DLL

2.2.13 functioncall_noconnallhv
Delphi: function functioncall_noconnallhv(pcName, pcPin:
pchar): boolean; stdcall;
C/C++: bool functioncall_noconnallhv(char *pcName, char
*pcPin);
Visual Basic: Private Declare Function functioncall_noconnallhv
Lib "CEETIS_TE_Access.dll" (ByVal pcName$, ByVal
pcPin$) as boolean

Aufgabe
Diese Funktion ruft „NoConnAllHV“ in der CEETIS TE auf. Um diese Funktion aus-
führen zu können, muss ein Projekt geöffnet sein.

Rückgabewert
Der Rückgabewert ist TRUE, wenn „NoConnAllHV“ erfolgreich aufgerufen wurde,
andernfalls FALSE.

Parameter
pcName: Name des Tests
pcPin: Name des Pins

Ergebnisdaten
Um einen Ergebnisstring zu erhalten, müssen Sie nach dem Ausführen von
„functioncall_noconnallhv“ die Funktion „electrical_test_finished“ so lange in einer
Schleife ausführen, bis „functioncall_noconnallhv“ beendet ist. Nach Beenden der
Funktion enthält der Ergebnisstring im 2. Feld passed oder failed. Im 3. und 4. Feld
sind Messdaten enthalten. Die Messdaten sind nur dann gültig, wenn der Test er-
folgreich (gut) war. Andernfalls enthalten die Felder 5 und 6 die Pins, zu denen ein
Schluss detektiert wurde. Das 5. Feld enthält die Anzahl dieser Pins und Feld 6 die
Namen.

Feldnummer Beschreibung
3 Wertevorzeichen (siehe „electrical_test_finished“)
4 Gemessener Wert in Ohm.
5 Anzahl der Pins, zu denen ein Schluss detektiert wurde.
6 Name der Pins, zu denen ein Schluss detektiert wurde. Jeder Pin-
name wird mit einem Tabulator (TAB = #9) abgeschlossen

32 Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH


CEETIS TE Access DLL

2.2.14 functioncall_noconnalllv
Delphi: function functioncall_noconnalllv(pcName, pcPin:
pchar): boolean; stdcall;
C/C++: bool functioncall_noconnalllv(char *pcName, char
*pcPin);
Visual Basic: Private Declare Function functioncall_noconnalllv
Lib "CEETIS_TE_Access.dll" (ByVal pcName$, ByVal
pcPin$) as boolean

Aufgabe
Diese Funktion ruft „NoConnAllLV“ in der CEETIS TE auf. Um diese Funktion aus-
führen zu können, muss ein Projekt geöffnet sein.

Rückgabewert
Der Rückgabewert ist TRUE, wenn „NoConnAllLV“ erfolgreich aufgerufen wurde,
andernfalls FALSE.

Parameter
pcName: Name des Tests
pcPin: Name des Pins

Ergebnisdaten
Um einen Ergebnisstring zu erhalten, müssen Sie nach dem Ausführen von
„functioncall_noconnalllv“ die Funktion „electrical_test_finished“ so lange in einer
Schleife ausführen, bis „functioncall_noconnalllv“ beendet ist. Nach Beenden der
Funktion enthält der Ergebnisstring im 2. Feld passed oder failed. Im 3. und 4. Feld
sind Messdaten enthalten. Die Messdaten sind nur dann gültig, wenn der Test er-
folgreich (gut) war. Andernfalls enthalten die Felder 5 und 6 die Pins, zu denen ein
Schluss detektiert wurde. Das 5. Feld enthält die Anzahl dieser Pins und Feld 6 die
Namen.

Feldnummer Beschreibung
3 Wertevorzeichen (siehe „electrical_test_finished“)
4 Gemessener Wert in Ohm.
5 Anzahl der Pins, zu denen ein Schluss detektiert wurde.
6 Name der Pins, zu denen ein Schluss detektiert wurde. Jeder Pin-
name ist mit einem Tabulator (TAB = #9) abgeschlossen.

Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH 33


CEETIS TE Access DLL

2.2.15 functioncall_noconnectiondb
Delphi: function functioncall_noconnectiondb(pcName, pcPin1,
pcPin2: pchar): boolean; stdcall;
C/C++: bool functioncall_noconnectiondb(char *pcName, char
*pcPin1, char *pcPin2);
Visual Basic: Private Declare Function functioncall_noconnectiondb
Lib "CEETIS_TE_Access.dll" (ByVal pcName$, ByVal
pcPin1$, ByVal pcPin2$) as boolean

Aufgabe
Diese Funktion ruft „NoConnectionDB“ in der CEETIS TE auf. Um diese Funktion
ausführen zu können, muss ein Projekt geöffnet sein.

Rückgabewert
Der Rückgabewert ist TRUE, wenn „NoConnectionDB“ erfolgreich aufgerufen wurde,
andernfalls FALSE.

Parameter
pcName: Name des Tests
pcPin1: Name des ersten Pins
pcPin2: Name des zweiten Pins

Ergebnisdaten
Um einen Ergebnisstring zu erhalten müssen Sie nach dem Ausführen von
„functioncall_NoConnectionDB“ die Funktion „electrical_test_finished“ so lange in
einer Schleife ausführen, bis „functioncall_NoConnectionDB“ beendet ist. Nach
Durchführung der Funktion enthält der Ergebnisstring im 2. Feld passed oder failed.
Im 3. Feld sind Informationen zum ARC und im 4. bis 8. Feld die Messdaten enthal-
ten.

34 Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH


CEETIS TE Access DLL

Feldnummer Beschreibung
3 Flag, ob ein ARC detektiert wurde. Das Feld enthält „arc“ wenn ein
ARC detektiert wurde, andernfalls ist es leer.
4 Flag, ob der gemessene Wert gültig ist. Der Wert ist gültig, wenn
Ihr Testsystem in der Lage ist, den Strom zu messen. Das Feld
enthält „valid“, wenn das Testsystem in der Lage ist, den Strom zu
messen, andernfalls ist es leer.
5 Vorzeichen für den realen Anteil des gemessenen Stroms
(siehe „electrical_test_finished“)
6 Realer Anteil des gemessenen Stroms in Ampere.
7 Vorzeichen für den imaginären Anteil des Stroms
(siehe „electrical_test_finished“)
8 Imaginärer Anteil des gemessenen Stroms in Ampere.

Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH 35


CEETIS TE Access DLL

2.2.16 functioncall_noconnectionhv
Delphi: function functioncall_noconnectionhv(pcName,
pcPin1, pcPin2: pchar): boolean; stdcall;
C/C++: bool functioncall_noconnectionhv(char *pcName,
char *pcPin1, char *pcPin2);
Visual basic: Private Declare Function
functioncall_noconnectionhv Lib
"CEETIS_TE_Access.dll" (ByVal pcName$, ByVal
pcPin1$, ByVal pcPin2$) as boolean

Aufgabe
Diese Funktion ruft „NoConnectionHV“ in der CEETIS TE auf. Um diese Funktion
ausführen zu können, muss ein Projekt geöffnet sein.

Rückgabewert
Der Rückgabewert ist TRUE, wenn „NoConnectionHV“ erfolgreich aufgerufen wurde,
andernfalls FALSE. Um diese Funktion ausführen zu können, muss ein Projekt ge-
öffnet sein.

Parameter
pcName: Name des Tests
pcPin1: Name des ersten Pins
pcPin2: Name des zweiten Pins

Ergebnisdaten
Um einen Ergebnisstring zu erhalten, müssen Sie nach dem Ausführen von
„functioncall_noconnectionhv“ die Funktion „electrical_test_finished“ so lange in
einer Schleife ausführen, bis „functioncall_noconnectionhv“ beendet ist. Nach Been-
den der Funktion enthält der Ergebnisstring im 2. Feld passed oder failed. Im 3. Feld
sind Informationen zum ARC und im 4. und 5. Feld die Messdaten enthalten.

Feldnummer Beschreibung
3 Flag, ob ein ARC festgestellt wurde. Das Feld enthält „arc“ wenn
ein ARC detektiert wurde, andernfalls ist es leer.
4 Wertevorzeichen (siehe „electrical_test_finished“)
5 Gemessener Wert in Ohm

36 Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH


CEETIS TE Access DLL

2.2.17 functioncall_noconnectionlv
Delphi: function functioncall_noconnectionlv(pcName,
pcPin1, pcPin2: pchar): boolean; stdcall;
C/C++: bool functioncall_noconnectionlv(char *pcName,
char *pcPin1, char *pcPin2);
Visual Basic: Private Declare Function
functioncall_noconnectionlv Lib
"CEETIS_TE_Access.dll" (ByVal pcName$, ByVal
pcPin1$, ByVal pcPin2$) as boolean

Aufgabe
Diese Funktion ruft „NoConnectionLV“ in der CEETIS TE auf. Um diese Funktion
ausführen zu können, muss ein Projekt geöffnet sein.

Rückgabewert
Der Rückgabewert ist TRUE, wenn „NoConnectionLV“ erfolgreich aufgerufen wurde,
andernfalls FALSE.

Parameter
pcName: Name des Tests
pcPin1: Name des ersten Pins
pcPin2: Name des zweiten Pins

Ergebnisdaten
Um einen Ergebnisstring zu erhalten, müssen Sie nach dem Ausführen von
„functioncall_noconnectionlv“ die Funktion „electrical_test_finished“ so lange in einer
Schleife ausführen, bis „functioncall_noconnectionlv“ beendet ist. Nach Beenden der
Funktion enthält der Ergebnisstring im 2. Feld passed oder failed. Im 3. Feld sind
Informationen zum ARC und im 4. und 5. Feld die Messdaten enthalten.

Feldnummer Beschreibung
3 Flag, ob ein ARC festgestellt wurde. Das Feld enthält „arc“ wenn
ein ARC detektiert wurde, andernfalls ist es leer.
4 Wertevorzeichen (siehe „electrical_test_finished“)
5 Gemessener Wert in Ohm

Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH 37


CEETIS TE Access DLL

2.2.18 functioncall_noconngroupdb
Delphi: function functioncall_noconngroupdb(pcName,
pcHighGroupName, pcHighGroupPins, pcLowGroupName,
pcLowGroupPins: pchar): boolean; stdcall;
C/C++: bool functioncall_noconngroupdb(char *pcName, char
*pcHighGroupName, char *pcHighGroupPins, char
*pcLowGroupName, char *pcLowGroupPins);
Visual Basic: Private Declare Function
functioncall_noconngroupdb Lib
"CEETIS_TE_Access.dll" (ByVal pcName$, ByVal
pcHighGroupName$, ByVal pcHighGroupPins$, ByVal
pcLowGroupName$, ByVal pcLowGroupPins$) as boolean

Aufgabe
Diese Funktion ruft „NoConnGroupDB“ in der CEETIS TE auf. Um diese Funktion
ausführen zu können, muss ein Projekt geöffnet sein.

Rückgabewert
Der Rückgabewert ist TRUE, wenn „NoConnGroupDB“ erfolgreich aufgerufen wurde,
andernfalls FALSE.

Parameter
pcName: Name des Testschritts
pcHighGroupName: Name der High-Gruppe
pcHighGroupPins: Pins der High-Gruppe. Jeder Pin (auch der letzte) muss
mit einem Tabulator (#9) abgeschlossen werden.
pcLowGroupName: Name der Low-Gruppe
pcLowGroupPins: Pins der Low-Gruppe. Jeder Pin (auch der letzte) muss
mit einem Tabulator (#9) abgeschlossen werden.

Ergebnisdaten
Nach „functioncall_noconngroupdb“ müssen Sie „electrical_test_finished“ in einer
Schleife aufrufen, um auf das Ende der Ausführung zu warten und den Ergeb-
nisstring zu erhalten. Wenn die Funktion ausgeführt wurde, enthält der Ergeb-
nisstring im 2. Feld passed oder failed. Im 3. bis 7. Feld werden Messdaten ange-
zeigt.
Die Messdaten können nur gültig sein, wenn der Test bestanden (gut) ist. Andern-
falls müssen die Felder 8 und 9 nach Schlüssen überprüft werden.
Das 8. Feld enthält die Anzahl der Pins in Feld 9. Feld 9 enthält die Namen der Pins
zu denen ein Schluss detektiert wurde. Die zwei jeweils aufeinanderfolgenden Pins

38 Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH


CEETIS TE Access DLL

gehören zusammen und zeigen an, dass ein Schluss zwischen diesen Pins detek-
tiert wurde. Jeder Name endet mit einem Tabulator (#9).

Feldnummer Beschreibung
3 Flag, ob der gemessene Wert gültig ist. Der Wert ist gültig,
wenn Ihr Testsystem in der Lage ist, den Strom zu messen.
Das Feld enthält „valid“, wenn das Testsystem in der Lage ist,
den Strom zu messen, andernfalls ist es leer.
4 Vorzeichen für den realen Anteil des gemessenen Stroms (sie-
he „electrical_test_finished“).
5 Realer Anteil des gemessenen Stroms in Ampere.
6 Vorzeichen für den imaginären Anteil des Stroms (siehe
„electrical_test_finished“).
7 Imaginärer Anteil des gemessenen Stroms in Ampere.
8 Anzahl an Pins in Feld 9
9 Name der Pins, zu denen ein Schluss detektiert wurde.

Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH 39


CEETIS TE Access DLL

2.2.19 functioncall_noconngrouphv
Delphi: function functioncall_noconngrouphv(pcName,
pcHighGroupName, pcHighGroupPins, pcLowGroupName,
pcLowGroupPins: pchar): boolean; stdcall;
C/C++: bool functioncall_noconngrouphv(char *pcName, char
*pcHighGroupName, char *pcHighGroupPins, char
*pcLowGroupName, char *pcLowGroupPins);
Visual Basic: Private Declare Function
functioncall_noconngrouphv Lib
"CEETIS_TE_Access.dll" (ByVal pcName$, ByVal
pcHighGroupName$, ByVal pcHighGroupPins$, ByVal
pcLowGroupName$, ByVal pcLowGroupPins$) as boolean

Aufgabe
Diese Funktion ruft „NoConnGroupHV“ in der CEETIS TE auf. Um diese Funktion
ausführen zu können, muss ein Projekt geöffnet sein.

Rückgabewert
Der Rückgabewert ist TRUE, wenn „NoConnGroupHV“ erfolgreich aufgerufen wurde,
andernfalls FALSE.

Parameter
pcName: Name des Testschritts
pcHighGroupName: Name der High-Gruppe
pcHighGroupPins: Pins der High-Gruppe. Jeder Pin (auch der letzte) muss
mit einem Tabulator (#9) abgeschlossen werden.
pcLowGroupName: Name der Low-Gruppe
pcLowGroupPins: Pins der Low-Gruppe. Jeder Pin (auch der letzte) muss
mit einem Tabulator (#9) abgeschlossen werden.

Ergebnisdaten
Nach „functioncall_noconngrouphv“ müssen Sie „electrical_test_finished“ in einer
Schleife aufrufen, um auf das Ende der Ausführung zu warten und den Ergeb-
nisstring zu erhalten. Wenn die Funktion ausgeführt wurde, enthält der Ergeb-
nisstring im 2. Feld passed oder failed. Im 3. und 4. Feld werden Messdaten ange-
zeigt.
Die Messdaten können nur gültig sein, wenn der Test bestanden (gut) ist. Andern-
falls müssen die Felder 5 und 6 nach Schlüssen überprüft werden.
Das 5. Feld enthält die Anzahl der Pins in Feld 6. Feld 6 enthält die Namen der Pins,
zu denen ein Schluss detektiert wurde. Die zwei jeweils aufeinanderfolgenden Pins

40 Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH


CEETIS TE Access DLL

gehören zusammen und zeigen an, dass ein Schluss zwischen diesen Pins detek-
tiert wurde. Jeder Name endet mit einem Tabulator (#9).

Feldnummer Beschreibung
3 Wertevorzeichen (siehe „electrical_test_finished“)
4 Gemessener Wert in Ohm
5 Anzahl der Pins in Feld 6
6 Name der Pins, zu denen ein Schluss detektiert wurde

Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH 41


CEETIS TE Access DLL

2.2.20 functioncall_noconngrouplv
Delphi: function functioncall_noconngrouplv(pcName,
pcHighGroupName, pcHighGroupPins, pcLowGroupName,
pcLowGroupPins: pchar): boolean; stdcall;
C/C++: bool functioncall_noconngrouplv(char *pcName, char
*pcHighGroupName, char *pcHighGroupPins, char
*pcLowGroupName, char *pcLowGroupPins);
Visual Basic: Private Declare Function
functioncall_noconngrouplv Lib
"CEETIS_TE_Access.dll" (ByVal pcName$, ByVal
pcHighGroupName$, ByVal pcHighGroupPins$, ByVal
pcLowGroupName$, ByVal pcLowGroupPins$) as boolean

Aufgabe
Diese Funktion ruft „NoConnGroupLV“ in der CEETIS TE auf. Um diese Funktion
ausführen zu können, muss ein Projekt geöffnet sein.

Rückgabewert
Der Rückgabewert ist TRUE, wenn „NoConnGroupLV“ erfolgreich aufgerufen wurde,
andernfalls FALSE.

Parameter
pcName: Name des Testschritts
pcHighGroupName: Name der High-Gruppe
pcHighGroupPins: Pins der High-Gruppe. Jeder Pin (auch der letzte) muss
mit einem Tabulator (#9) abgeschlossen werden.
pcLowGroupName: Name der Low-Gruppe
pcLowGroupPins: Pins der Low-Gruppe. Jeder Pin (auch der letzte) muss
mit einem Tabulator (#9) abgeschlossen werden.

Ergebnisdaten
Nach „functioncall_noconngrouplv“ müssen Sie „electrical_test_finished“ in einer
Schleife aufrufen, um auf das Ende der Ausführung zu warten und den Ergeb-
nisstring zu erhalten. Wenn die Funktion ausgeführt wurde, enthält der Ergeb-
nisstring im 2. Feld passed oder failed. Im 3. und 4. Feld werden Messdaten ange-
zeigt.
Die Messdaten können nur gültig sein, wenn der Test bestanden (gut) ist. Andern-
falls müssen die Felder 5 und 6 nach Schlüssen überprüft werden.
Das 5. Feld enthält die Anzahl der Pins in Feld 6. Feld 6 enthält die Namen der Pins,
zu denen ein Schluss detektiert wurde. Die zwei jeweils aufeinanderfolgenden Pins

42 Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH


CEETIS TE Access DLL

gehören zusammen und zeigen an, dass ein Schluss zwischen diesen Pins detek-
tiert wurde. Jeder Name endet mit einem Tabulator (#9).

Feldnummer Beschreibung
3 Wertevorzeichen (siehe „electrical_test_finished“)
4 Gemessener Wert in Ohm
5 Anzahl der Pins in Feld 6
6 Name der Pins, zu denen ein Schluss detektiert wurde.

Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH 43


CEETIS TE Access DLL

2.2.21 functioncall_pinscan
Delphi: function functioncall_pinscan(pcPin: pchar):
boolean; stdcall;
C/C++: bool functioncall_pinscan(char *pcPin);
Visual Basic: Private Declare Function functioncall_pinscan Lib
"CEETIS_TE_Access.dll" (ByVal pcPin$) as boolean

Aufgabe
Diese Funktion ruft „PinScan“ in der CEETIS TE auf. Um diese Funktion auszufüh-
ren, muss ein Projekt geöffnet sein.

Rückgabewert
Der Rückgabewert ist TRUE, wenn „PinScan“ erfolgreich in der CEETIS TE aufgeru-
fen wurde, andernfalls ist der Rückgabewert FALSE.

Parameter
pcPin: Name des Pins

Ergebnisdaten
Nach „functioncall_pinscan“ müssen Sie „electrical_test_finished“ in einer Schleife
aufrufen, um auf das Ende der Ausführung zu warten und den Ergebnisstring zu er-
halten. Wenn die Funktion ausgeführt wurde, enthält der Ergebnisstring im 2. Feld
passed oder failed. Im 3. und 4. Feld werden Messdaten angezeigt.
Die Messdaten können nur gültig sein, wenn der Test bestanden (gut) ist. Andern-
falls müssen die Felder 5 und 6 nach den Pins überprüft werden, zu denen eine Ver-
bindung detektiert wurde.
Das 5. Feld enthält die Anzahl dieser Pins und Feld 6 enthält die Namen. Jeder Na-
me endet mit einem Tabulator (#9).

Feldnummer Beschreibung
3 Wertevorzeichen (siehe „electrical_test_finished“)
4 Gemessener Wert in Ohm
5 Anzahl der Pins, zu denen ein Schluss detektiert wurde
6 Name der Pins, zu denen eine Verbindung detektiert wurde.
Jeder Name wird mit einem Tabulator (#9) abgeschlossen.

44 Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH


CEETIS TE Access DLL

2.2.22 functioncall_resistortest
Delphi: function functioncall_resistortest(pcName, pcPin1,
pcPin2: pchar): boolean; stdcall;
C/C++: bool functioncall_resistortest(char *pcName,
char *pcPin1, char *pcPin2);
Visual Basic: Private Declare Function functioncall_resistortest
Lib "CEETIS_TE_Access.dll" (ByVal pcName$, ByVal
pcPin1$, ByVal pcPin2$) as boolean

Aufgabe
Diese Funktion ruft „ResistorTest“ in der CEETIS TE auf.
Um diese Funktion ausführen zu können, muss ein Projekt geöffnet sein.
„ResistorTest“ bezieht sich immer auf einen Widerstand in der Netzliste.

Rückgabewert
Der Rückgabewert ist TRUE, wenn „ResistorTest“ erfolgreich aufgerufen wurde, an-
dernfalls FALSE.

Parameter
pcName: Name des Widerstands
pcPin1: Name des ersten Pins
pcPin2: Name des zweiten Pins

Ergebnisdaten
Um einen Ergebnisstring zu erhalten, müssen Sie nach dem Ausführen von
„functioncall_resistortest“ die Funktion „electrical_test_finished“ so lange in einer
Schleife ausführen, bis „functioncall_resistortest“ beendet ist. Nach Beenden der
Funktion enthält der Ergebnisstring im 2. Feld passed oder failed. Das 3. und 4. Feld
enthält die Messdaten.

Feldnummer Beschreibung
3 Wertevorzeichen (siehe electrical_test_finished)
4 Gemessener Wert in Ohm

Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH 45


CEETIS TE Access DLL

2.2.23 functioncall_rlcserialinductancetest
Delphi: function
functioncall_rlcserialinductancetest(pcName, pcPin1,
pcPin2: pchar; dMinimum_H, dMaximum_H: double):
boolean; stdcall;
C/C++: bool functioncall_rlcserialinductancetest(char
*pcName, char *pcPin1, char *pcPin2,
double dMinimum_H, double dMaximum_H);
VisualBasic: Private Declare Function
functioncall_rlcserialinductancetest Lib
"CEETIS_TE_Access.dll" (ByVal pcName$, ByVal
pcPin1$, ByVal pcPin2$, dMinimum_H as Double,
dMaximum_H as Double) as boolean

Aufgabe
Diese Funktion ruft „RLCSerialInductanceTest“ in der CEETIS TE auf. Um diese
Funktion ausführen zu können, muss ein Projekt geöffnet sein. RLCSerialIn-
ductanceTest bezieht sich immer auf eine RLC-Kombination in der Netzliste.

Rückgabewert
Der Rückgabewert ist TRUE, wenn „RLCSerialInductanceTest“ erfolgreich aufgeru-
fen wurde, andernfalls FALSE.

Parameter
pcName: Name der RLC-Kombination
pcPin1/pcPin2: Name des ersten/zweiten Pins
dMinimum_H: Minimale Induktivität in Henry
dMaximum_H: Maximale Induktivität in Henry

Ergebnisdaten
Nach „functioncall_rlcserialinductancetest“ müssen Sie „electrical_test_finished“ in
einer Schleife aufrufen, um auf das Ende der Ausführung zu warten und den Ergeb-
nisstring zu erhalten. Wenn die Funktion ausgeführt wurde, enthält der Ergeb-
nisstring passed oder failed im 2. Feld und Messdaten im 3. und 4. Feld.

Feldnummer Beschreibung
3 Vorzeichen für den gemessenen Wert
(siehe electrical_test_finished)
4 Gemessener Wert in Henry

46 Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH


CEETIS TE Access DLL

2.2.24 functioncall_wiretest
Delphi: function functioncall_wiretest(pcName, pcPin1,
pcPin2: pchar): boolean; stdcall;
C/C++: bool functioncall_wiretest(char *pcName,
char *pcPin1, char *pcPin2);
Visual Basic: Private Declare Function functioncall_wiretest Lib
"CEETIS_TE_Access.dll" (ByVal pcName$, ByVal
pcPin1$, ByVal pcPin2$) as boolean

Aufgabe
Diese Funktion ruft „WireTest“ in der CEETIS TE auf.
Um diese Funktion ausführen zu können, muss ein Projekt geöffnet sein.
„WireTest“ bezieht sich immer auf eine Leitung in der Netzliste.

Rückgabewert
Der Rückgabewert ist TRUE, wenn „WireTest“ erfolgreich aufgerufen wurde, andern-
falls FALSE.

Parameter
pcName: Name der Leitung
pcPin1: Name des ersten Pins
pcPin2: Name des zweiten Pins

Ergebnisdaten
Um einen Ergebnisstring zu erhalten, müssen Sie nach dem Ausführen von
„functioncall_wiretest“ die Funktion „electrical_test_finished“ so lange in einer Schlei-
fe ausführen, bis „functioncall_wiretest“ beendet ist. Nach Beenden der Funktion
enthält der Ergebnisstring im 2. Feld passed oder failed. Das 3. und 4. Feld enthält
die Messdaten.

Feldnummer Beschreibung
3 Wertevorzeichen (siehe electrical_test_finished)
4 Gemessener Wert in Ohm

Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH 47


CEETIS TE Access DLL

2.3 Matrixaufschaltung
Mit den Funktionen zur Matrixaufschaltung können Sie den Zustand der Kontakte
bzw. Pins der Matrix ändern. Wird eine Funktion aus dieser Gruppe aufgerufen,
muss so lange gewartet werden, bis diese Funktion beendet ist. Dies kann durch
Ausführen der Funktion „matrix_finished“ in einer Schleife erreicht werden. In einer
solchen Warteschleife müssen auch Routinen aufgerufen werden, die dafür sorgen,
dass Fensterbotschaften verarbeitet werden. Das Ergebnis dieser Funktionen wird
über die Funktion „matrix_finished“ zurückgegeben.

2.3.1 matrix_finished
Delphi: function matrix_finished(pcResultBuffer: pchar;
iResultBufferSize: integer): integer; stdcall;
C/C++: int matrix_finished(char *pcResultBuffer; int
iResultBufferSize);
Visual Basic: Private Declare Function matrix_finished& Lib
"CEETIS_TE_Access.dll" (ByVal pcResultBuffer$,
ByVal iResultBufferSize&)

Aufgabe
Diese Funktion gibt zurück, ob der Aufruf einer Funktion aus der Gruppe „Matrixauf-
schaltung“ ausgeführt wurde oder nicht. Die Funktion kann nach dem Aufruf einer
Matrix-Funktion in einer Schleife ausgeführt werden bis die Matrixfunktion beendet
ist. In dieser Schleife müssen auch Routinen aufgerufen werden, die dafür sorgen,
dass Fensterbotschaften verarbeitet werden.

Parameter
pcResultBuffer: Zeiger auf einen Pufferspeicher für den Ergebnisstring.
Der Puffer sollte eine Mindestgröße von 1024 Byte besit-
zen.
iResultBufferSize: Größe des zugeordneten Ergebnispuffers.

Rückgabewert
Der Rückgabewert ist 0, wenn kein Ergebnis der Matrixaufschaltung vorliegt. Sobald
ein Ergebnis vorliegt, wird die Anzahl der Zeichen (inklusive aller Trennzeichen) zu-
rückgegeben, die in den Ergebnispuffer geschrieben wurden. Der Puffer enthält das
Ergebnis als String.
Die Daten im String sind in Felder gegliedert. Jedes Feld wird mit „Wagenrücklauf
und Zeilenvorschub (CRLF = #13#10)” abgeschlossen.
Das erste Feld enthält allgemeine Informationen zur Ausführung der Funktion. Ab-
hängig von seinem Wert enthält das zweite Feld zusätzliche Informationen.

48 Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH


CEETIS TE Access DLL

Wert von Feld 1 Beschreibung


executed Die Funktion wurde ausgeführt.
 2. Feld: Enthält das Ergebnis (success)
 nachfolgende Felder: nicht genutzt
function call error Ein Fehler ist während der Vorbereitung oder des Aufrufs einer
Funktion aufgetreten.
Eine mögliche Ursache dafür könnte sein, dass der Kontakt/Pin
fehlerhaft benannt ist.

 2. Feld: Enthält „unknown“ (derzeit keine anderen mögli-


chen Werte)
function execution Ein Fehler ist während der Ausführung einer Funktion aufgetre-
error ten.
 2. Feld: Enthält den Fehlertyp:
- „safety circuit“: Eine Unterbrechung des Sicherheitskrei-
ses wurde festgestellt.
- „Hexadecimal value“:
Fehlercode, der meistens das Ergebnis
eines ungültigen Parameters oder eines
Hardwareproblems ist.
- „unknown“: Unbekannter Fehler

 nachfolgende Felder: nicht genutzt

Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH 49


CEETIS TE Access DLL

2.3.2 functioncall_contactsetoff
Delphi: function functioncall_contactsetoff(pcContact:
pchar): boolean; stdcall;
C/C++: bool functioncall_contactsetoff(char *pcContact);
Visual Basic: Private Declare Function functioncall_contactsetoff
Lib "CEETIS_TE_Access.dll" (ByVal pcContact$) as
boolean

Aufgabe
Diese Funktion ruft „ContactSetOff“ in der CEETIS TE auf. Um diese Funktion aus-
führen zu können, muss ein Projekt geöffnet sein.

Rückgabewert
Der Rückgabewert ist TRUE, wenn „ContactSetOff“ erfolgreich aufgerufen wurde,
andernfalls FALSE.

Parameter
pcContact: Name des Kontakts

Ergebnisdaten
Keine weiteren Ergebnisdaten.

50 Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH


CEETIS TE Access DLL

2.3.3 functioncall_contactseton
Delphi: function functioncall_contactseton(pcContact:
pchar): boolean; stdcall;
C/C++: bool functioncall_contactseton(char *pcContact);
Visual Basic: Private Declare Function functioncall_contactseton
Lib "CEETIS_TE_Access.dll" (ByVal pcContact$) as
boolean

Aufgabe
Diese Funktion ruft „ContactSetOn“ in der CEETIS TE auf. Um diese Funktion aus-
führen zu können, muss ein Projekt geöffnet sein.

Rückgabewert
Der Rückgabewert ist TRUE, wenn „ContactSetOn“ erfolgreich aufgerufen wurde,
andernfalls FALSE.

Parameter
pcContact: Name des Kontakts

Ergebnisdaten
Keine weiteren Ergebnisdaten.

Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH 51


CEETIS TE Access DLL

2.3.4 functioncall_contactresetall
Delphi: function functioncall_contactresetall: boolean;
stdcall;
C/C++: bool functioncall_contactresetall(void);
Visual Basic: Private Declare Function functioncall_contactresetall
Lib "CEETIS_TE_Access.dll" () as boolean

Aufgabe
Diese Funktion ruft „ContactResetAll“ in der CEETIS TE auf. Dieser Befehl schaltet
alle Kontakte aus. Um diese Funktion ausführen zu können, muss ein Projekt geöff-
net sein.

Rückgabewert
Der Rückgabewert ist TRUE, wenn „ContactResetAll“ erfolgreich in der CEETIS TE
aufgerufen wurde, andernfalls FALSE.

Ergebnisdaten
Keine weiteren Ergebnisdaten.

52 Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH


CEETIS TE Access DLL

2.3.5 functioncall_pinsethighlow
Delphi: function functioncall_pinsethighlow(pcHighPin,
pcLowPin, pcAcDc, pcVoltage_V: pchar): boolean;
stdcall;
C/C++: bool functioncall_pinsethighlow(char *pcHighPin,
char *pcLowPin, char *pcAcDc, char *pcVoltage_V);
Visual Basic: Private Declare Function functioncall_pinsethighlow
Lib "CEETIS_TE_Access.dll" (ByVal pcHighPin$, ByVal
pcLowPin$, ByVal pcAcDc$, ByVal pcVoltage_V$) as
boolean

Aufgabe
Diese Funktion ruft „PinSetHighLow“ in der CEETIS TE auf. Um diese Funktion aus-
führen zu können, muss ein Projekt geöffnet sein.

Rückgabewert
Der Rückgabewert ist TRUE, wenn „PinSetHighLow“ erfolgreich in der CEETIS TE
aufgerufen wurde, andernfalls ist der Rückgabewert FALSE.

Parameter
pcHighPin: Name des High-Pins.
pcLowPin: Name des Low-Pins.
pcAcDc: Es muss „AC“ oder „DC“ übergeben werden, abhängig davon,
welche Art der Spannung an den Pins angelegt wird.
pcVoltage_V: Spannung (Fließkomma in Volt), die an den Pins angelegt wird.

Ergebnisdaten
Keine weiteren Ergebnisdaten.

Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH 53


CEETIS TE Access DLL

2.3.6 functioncall_pinsetoffall
Delphi: function functioncall_pinsetoffall: boolean;
stdcall;
C/C++: bool functioncall_pinsetoffall(void);
Visual Basic: Private Declare Function functioncall_pinsetoffall
Lib "CEETIS_TE_Access.dll" () as boolean

Aufgabe
Diese Funktion ruft die Funktion „PinSetOffAll“ in der CEETIS TE auf.
Dieser Befehl schaltet alle Testpins auf AUS. Um diese Funktion auszuführen, muss
ein Projekt geöffnet sein.

Rückgabewert
Der Rückgabewert ist TRUE, wenn „PinSetOffAll“ erfolgreich in der CEETIS TE auf-
gerufen wurde, andernfalls ist der Rückgabewert FALSE.

Ergebnisdaten
Keine weiteren Ergebnisdaten.

54 Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH


CEETIS TE Access DLL

2.3.7 functioncall_powerpinresetall
Delphi: function functioncall_powerpinresetall: boolean;
stdcall;
C/C++: bool functioncall_ powerpinresetall(void);
Visual Basic: Private Declare Function
functioncall_ powerpinresetall Lib
"CEETIS_TE_Access.dll" () as boolean

Aufgabe
Diese Funktion ruft die Funktion „PowerPinResetAll“ in der CEETIS TE auf.
Dieser Befehl schaltet alle Powerpins AUS. Um diese Funktion ausführen zu kön-
nen, muss ein Projekt geöffnet sein.

Rückgabewert
Der Rückgabewert ist TRUE, wenn „PowerPinResetAll“ erfolgreich in der CEETIS TE
aufgerufen wurde, andernfalls ist der Rückgabewert FALSE.

Ergebnisdaten
Keine weiteren Ergebnisdaten.

Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH 55


CEETIS TE Access DLL

2.3.8 functioncall_powerupinsethigh
Delphi: function functioncall_powerupinsethigh(iExtIO: integer;
pcPowerUPin: pchar): boolean; stdcall;
C/C++: bool functioncall_powerupinsethigh(int iExtIO, char
*pcPowerUPin);
VisualBasic: Private Declare Function
functioncall_powerupinsethigh Lib "CEETIS_TE_Access.dll"
(ByVal iExtIO&, ByVal pcPowerUPin$) as boolean

Aufgabe
Diese Funktion ruft „PowerUPinSetHigh“ in der CEETIS TE. Um diese Funktion aus-
führen zu können, muss ein Projekt geöffnet sein.

Return value
Der Rückgabewert ist TRUE, wenn „PowerUPinSetHigh“ erfolgreich aufgerufen wur-
de, andernfalls FALSE.

Parameter
iExtIO: Nummer der externen IO, die benutzt werden soll. 1 bis 4 ist er-
laubt, aber die Nummer hängt von der Anwendung und vom Test-
system ab.
pcPowerUPin: Name des Power-U-Pins

Ergebnisdaten
Keine weiteren Ergebnisdaten

56 Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH


CEETIS TE Access DLL

2.3.9 functioncall_powerupinsetlow
Delphi: function functioncall_powerupinsetlow(iExtIO: integer,
pcPowerUPin: pchar): boolean; stdcall;
C/C++: bool functioncall_powerupinsetlow(int iExtIO; char
*pcPowerUPin);
VisualBasic: Private Declare Function
functioncall_powerupinsetlow Lib "CEETIS_TE_Access.dll"
(ByVal iExtIO&, ByVal pcPowerUPin$) as boolean

Aufgabe
Diese Funktion ruft „Powerupinsetlow“ in der CEETIS TE auf. Um diese Funktion
ausführen zu können, muss ein Projekt geöffnet sein.

Rückgabewert
Der Rückgabewert ist TRUE, wenn „Powerupinsetlow“ erfolgreich aufgerufen wurde,
andernfalls FALSE.

Parameter
iExtIO: Nummer der externen IO, die benutzt werden soll. 1 bis 4 ist er-
laubt, aber die Nummer hängt von der Anwendung und vom Test-
system ab.
pcPowerUPin: Name des Power-U-Pins

Ergebnisdaten
Keine weiteren Ergebnisdaten

Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH 57


CEETIS TE Access DLL

2.3.10 functioncall_powerupinsetoff
Delphi: function functioncall_powerupinsetoff(pcPowerUPin:
pchar): boolean; stdcall;
C/C++: bool functioncall_powerupinsetoff(char *pcPowerUPin);
VisualBasic: Private Declare Function
functioncall_powerupinsetoff Lib "CEETIS_TE_Access.dll"
(ByVal pcPowerUPin$) as boolean

Aufgabe
Diese Funktion ruft „Powerupinsetoff“ in der CEETIS TE auf. Um diese Funktion aus-
führen zu können, muss ein Projekt geöffnet sein.

Rückgabewert
Der Rückgabewert ist TRUE, wenn „Powerupinsetoff“ erfolgreich aufgerufen wurde,
andernfalls FALSE.

Parameter
pcPowerUPin: Name des Power-U-Pins

Ergebnisdaten
Keine weiteren Ergebnisdaten

58 Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH


CEETIS TE Access DLL

Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH 59


CEETIS TE Access DLL

2.4 Generatorfunktionen
Die Generatorfunktionen ermöglichen den Zugriff auf die Generatoren. Wird eine
Funktion aus dieser Gruppe aufgerufen, muss so lange gewartet werden, bis diese
Funktion beendet ist. Dies kann durch Ausführen der Funktion „generator_finished“
in einer Schleife erreicht werden. In einer solchen Warteschleife müssen auch Rou-
tinen aufgerufen werden, die dafür sorgen, dass Fensterbotschaften verarbeitet wer-
den. Das Ergebnis dieser Funktionen wird über die Funktion „generator_finished“
zurückgegeben.

2.4.1 generator_finished
Delphi: function generator_finished(pcResultBuffer: pchar;
iResultBufferSize: integer): integer; stdcall;
C/C++: int generator_finished(char *pcResultBuffer, int
iResultBufferSize);
Visual Basic: Private Declare Function generator_finished& Lib
"CEETIS_TE_Access.dll" (ByVal pcResultBuffer$,
ByVal iResultBufferSize&)

Aufgabe
Diese Funktion gibt zurück, ob der Aufruf einer Funktion aus der Gruppe Generator-
funktionen ausgeführt wurde oder nicht. Die Funktion kann nach dem Aufruf einer
Generatorfunktion über eine Schleife ausgeführt werden, die so lange durchlaufen
wird, bis der Test beendet ist. In dieser Schleife müssen auch Routinen aufgerufen
werden, die dafür sorgen, dass Fensterbotschaften verarbeitet werden.

Parameter
pcResultBuffer: Zeiger auf einen Pufferspeicher für den Ergebnisstring.
Der Puffer sollte eine Mindestgröße von 1024 Byte besit-
zen.
iResultBufferSize: Größe des zugewiesenen Ergebnispuffers.

Rückgabewert
Der Rückgabewert ist 0, wenn kein Testergebnis aus der Generatorfunktion vorliegt.
Sobald ein Ergebnis vorliegt, wird die Anzahl der Zeichen (inklusive aller Trennzei-
chen) zurückgegeben, die in den Ergebnispuffer geschrieben wurden. Der Puffer
enthält das Ergebnis als String.
Die Daten im String sind in Felder gegliedert. Jedes Feld wird durch „Wagenrücklauf
und Zeilenvorschub (CRLF = #13#10)” abgeschlossen.
Das erste Feld enthält allgemeine Informationen über die Ausführung der Funktion.
Abhängig davon liefert das zweite Feld zusätzliche Informationen. Bei erfolgreicher
Ausführung der Generatorfunktion, werden die Ergebnisdaten an die nachfolgenden

60 Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH


CEETIS TE Access DLL

Feldern zurückgegeben. Die Ergebnisdaten hängen vom Typ der ausgeführten


Funktion ab.

Wert von Feld 1 Beschreibung


executed Die Funktion wurde ausgeführt.
 2. Feld: Enthält das Ergebnis (passed oder failed)
 nachfolgende Felder: Ergebnisdaten (siehe untenstehende
Beschreibungen der Funktionen)
function call error Während der Vorbereitung oder beim Aufruf einer Funktion ist
ein Fehler aufgetreten.
Eine mögliche Ursache dafür könnte sein, dass der Kontakt/Pin
fehlerhaft benannt ist.

 2. Feld: Enthält unknown (derzeit keine anderen möglichen


Werte)
 nachfolgende Felder: nicht genutzt
function execution Während der Ausführung einer Funktion ist ein Fehler aufgetre-
error ten.
 2. Feld: Enthält den Fehlertyp:
- safety circuit: Eine Unterbrechung des Sicherheitskrei-
ses wurde festgestellt.
- Hexadecimal value:
Fehlercode, der meistens das Ergebnis
eines ungültigen Parameters oder eines
Hardwareproblems ist.
- unknown: Unbekannter Fehler
 nachfolgende Felder: nicht genutzt

Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH 61


CEETIS TE Access DLL

2.4.2 functioncall_connectjackstomatrix
Delphi: function functioncall_connectjackstomatrix(boFront,
boBack: boolean): boolean; stdcall;
C/C++: bool functioncall_connectjackstomatrix(bool boFront,
bool boBack);
Visual Basic: Private Declare Function
functioncall_connectjackstomatrix Lib
"CEETIS_TE_Access.dll" (boFront as boolean, boBack as
boolean) as boolean

Aufgabe
Diese Funktion ruft „ConnectJacksToMatrix“ in der CEETIS TE auf. Um diese Funk-
tion ausführen zu können, muss ein Projekt geöffnet sein.

Rückgabewert
Der Rückgabewert ist TRUE, wenn „ConnectJacksToMatrix“ erfolgreich in der
CEETIS TE aufgerufen wurde, andernfalls ist der Rückgabewert FALSE.

Parameter
boFront: Wird TRUE übergeben, werden die vorderen Buchsen des Testsys-
tems mit der Matrix verbunden.
Wird FALSE übergeben, werden die vorderen Buchsen von der
Matrix getrennt.
boBack: Dieser Parameter ist immer auf FALSE zu setzen.

Ergebnisdaten
Keine weiteren Ergebnisdaten.

62 Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH


CEETIS TE Access DLL

2.4.3 functioncall_gensetjacksenabled
Delphi: function functioncall_gensetjacksenabled(boSwitchOn:
boolean): boolean; stdcall;
C/C++: bool functioncall_gensetjacksenabled(bool boSwitchOn);
Visual Basic: Private Declare Function
functioncall_gensetjacksenabled Lib
"CEETIS_TE_Access.dll" (boSwitchOn as boolean) as
boolean

Aufgabe
Diese Funktion ruft „GenSetJacksEnabled“ in der CEETIS TE auf. Um diese Funkti-
on ausführen zu können, muss ein Projekt geöffnet sein.

Rückgabewert
Der Rückgabewert ist TRUE, wenn „GenSetJacksEnabled“ erfolgreich in der
CEETIS TE aufgerufen wurde, andernfalls ist der Rückgabewert FALSE.

Parameter
boSwitchOn: Wenn TRUE übergegeben wird, werden die Buchsen parallel zu
den internen Generatoren geschaltet, bis diese Funktion mit FALSE
aufgerufen wird.

Ergebnisdaten
Keine weiteren Ergebnisdaten.

Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH 63


CEETIS TE Access DLL

2.4.4 functioncall_genvoltageon
Delphi: function functioncall_genvoltageon(pcStimBus,
pcVoltage_V, pcMaxCurrent_A: pchar): boolean;
stdcall;
C/C++: bool functioncall_genvoltageon(char *pcStimBus, char
*pcVoltage_V, char *pcMaxCurrent_A);
Visual Basic: Private Declare Function functioncall_genvoltageon
Lib "CEETIS_TE_Access.dll" (ByVal pcStimBus$, ByVal
pcVoltage_V$, ByVal pcMaxCurrent_A$) as boolean

Aufgabe
Diese Funktion ruft „GenVoltageOn“ in der CEETIS TE auf. Um diese Funktion aus-
führen zu können, muss ein Projekt geöffnet sein.

Rückgabewert
Der Rückgabewert ist TRUE, wenn „GenVoltageOn“ erfolgreich aufgerufen wurde,
andernfalls FALSE.

Parameter
pcStimBus: Der Bus des Testsystems, an den die Spannung angelegt
werden soll. Mögliche Werte sind U2, U3, force, sense.
pcVoltage_V: Die Spannung (Fließkomma in Volt) die angelegt werden soll.
pcMaxCurrent_A: Die maximal erlaubte Stromstärke (Fließkomma in Ampere).

Ergebnisdaten
Wenn das 2. Feld passed enthält, werden die folgenden Felder nicht benutzt.
Wenn das 2. Feld failed enthält, werden im 3. Feld einige Fehlerinformationen ange-
zeigt („externalvoltage“ = Externe Spannung festgestellt; „arc“ = Beim Anlegen der
Spannung trat ein ARC auf; „value not reached“ = Der gewünschte Spannungswert
konnte nicht erreicht werden).

64 Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH


CEETIS TE Access DLL

2.4.5 functioncall_genvoltageoff
Delphi: function functioncall_genvoltageoff(pcStimBus:
pchar): boolean; stdcall;
C/C++: bool functioncall_genvoltageoff(char *pcStimBus);
Visual Basic: Private Declare Function functioncall_genvoltageoff
Lib "CEETIS_TE_Access.dll" (ByVal pcStimBus$) as
boolean

Aufgabe
Diese Funktion ruft „GenVoltageOff“ in der CEETIS TE auf. Um diese Funktion aus-
führen zu können, muss ein Projekt geöffnet sein.

Rückgabewert
Der Rückgabewert ist TRUE, wenn „GenVoltageOn“ erfolgreich aufgerufen wurde,
andernfalls FALSE.

Parameter
pcStimBus: Der Bus des Testsystems, an den die Spannung angelegt werden
soll. Mögliche Werte sind U2, U3, force und sense.

Ergebnisdaten
Keine weiteren Ergebnisdaten.

Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH 65


CEETIS TE Access DLL

2.5 Parameterfunktionen

2.5.1 functioncall_paramcontinuity
Delphi: function functioncall_paramcontinuity(pcCurrent_A,
pcThreshold_ohm, pcTrise_s, pcTwait_s, pcTmeas_s,
pcAutoRange, pcVoltageLimit_V: pchar): boolean;
stdcall;
C/C++: bool functioncall_paramcontinuity(char
*pcCurrent_A, char *pcThreshold_ohm, char
*pcTrise_s, char *pcTwait_s, char *pcTmeas_s, char
*pcAutoRange, char *pcVoltageLimit_V);
Visual Basic: Private Declare Function
functioncall_paramcontinuity Lib
"CEETIS_TE_Access.dll" (ByVal pcCurrent_A$, ByVal
pcThreshold_ohm$, ByVal pcTrise_s$, ByVal
pcTwait_s$, ByVal pcTmeas_s$, ByVal pcAutoRange$,
ByVal pcVoltageLimit_V$) as boolean

Aufgabe
Diese Funktion stellt die Messparameter für den Durchgangstest ein. Die erlaubten
Werte finden Sie in Ihren Handbüchern oder im Projektparameter-Fenster.

Rückgabewert

 0 Die Funktion wurde nicht von CEETIS bearbeitet.


 1 Es wurden keine Probleme festgestellt.
 2 Es wurde ein Problem mit dem "Strom"-Wert erkannt.
2 Die Funktion wurde nicht ausgeführt.
 3 Es wurde ein Problem mit dem Wert "Schwellwert" erkannt.
2 Die Funktion wurde nicht ausgeführt.
 4 Ein Problem mit einem der Zeitwerte (Trise, Twait, Tmeas) wurde erkannt.
2 Die Funktion wurde nicht ausgeführt.
 5 Es wurde ein Problem mit dem Wert "Spannungsgrenze" erkannt.
2 Die Funktion wurde nicht ausgeführt.

Hinweis
Im Fenster des CEETIS TE können Sie zu Auswertungszwecken überprüfen, wel-
cher Parameter auf welchen Wert gesetzt wurde nachdem die Funktion ausgeführt
wurde. Es werden alle geänderten Werte angezeigt.

66 Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH


CEETIS TE Access DLL

Parameter
Alle Messparameterwerte, ob Fließkomma- oder boolesche Werte, müssen als
String übergeben werden. Falls Sie einen Wert nicht ändern möchten, können Sie
einfach einen leeren oder ungültigen String für den Parameter übergeben. Um einen
booleschen Wert einzustellen, übergeben Sie 0 für FALSE, einen beliebigen Wert
größer 0 für TRUE und alles andere, um den Wert nicht zu ändern. Übergeben Sie
für einen Fließkommawert eine einfache Fließkommazahl ohne Tausendertrennzei-
chen und ohne Einheit. Werte, die eine Einheit haben, wie Ströme, Spannungen und
Widerstände, müssen in ihrer SI-Basiseinheit übergeben werden.

pcCurrent_A: Stromstärke in Ampere (Fließkomma)


pcThreshold_ohm: Schwellwert in Ohm (Fließkomma)
pcTrise_s: Maximum Anlaufzeit in Sekunden (Fließkomma)
pcTwait_s: Wartezeit in Sekunden (Fließkomma)
pcTmeas_s: Messzeit in Sekunden (Fließkomma)
pcAutoRange: Automatische Bereichswahl (boolesch)
pcVoltageLimit_V: Spannungsgrenze in Volt (Fließkomma)

Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH 67


CEETIS TE Access DLL

2.5.2 functioncall_paramdielectricbreakdown
Delphi: function functioncall_ paramdielectricbreakdown
(pcVoltage_V, pcTrise_s, pcTwait_s, pcTmeas_s,
pcTmeasFactor, pcVoltageRamp_Vp, pcFrequency_Hz,
pcThresholdIr_A, pcThresholdIi_A, pcAutoRange:
pchar): boolean; stdcall;
C/C++: bool
functioncall_paramdielectricbreakdown(char
*pcVoltage_V, char *pcTrise_s, char *pcTwait_s,
char *pcTmeas_s, char *pcTmeasFactor, char
*pcVoltageRamp_Vps, char *pcThresholdIr_A, char
*pcThresholdIi_A, char *pcAutoRange);
Visual Basic: Private Declare Function
functioncall_paramdielectricbreakdown Lib
"CEETIS_TE_Access.dll" (ByVal pcVoltage_V$, ByVal
pcTrise_s$, ByVal pcTwait_s$, ByVal pcTmeas_s$,
ByVal pcTmeasFactor$, ByVal pcVoltageRamp_Vps$,
ByVal pcFrequency_Hz$, ByVal pcThresholdIr_A$,
ByVal pcThresholdIi_A$, ByVal pcAutoRange$) as
boolean

Aufgabe
Diese Funktion stellt die Messparameter für den Überschlagstest ein. Die erlaubten
Werte finden Sie in Ihren Handbüchern oder im Projektparameter-Fenster.

Rückgabewert
Der Rückgabewert ist TRUE, wenn das Kommando erfolgreich ausgeführt wurde,
andernfalls FALSE.

Parameter
Alle Messparameterwerte, ob Fließkomma- oder boolesche Werte, müssen als
String übergeben werden. Falls Sie einen Wert nicht ändern möchten, können Sie
einfach einen leeren oder ungültigen String für den Parameter übergeben. Um einen
booleschen Wert einzustellen, übergeben Sie 0 für FALSE, einen beliebigen Wert
größer 0 für TRUE und alles andere, um den Wert nicht zu ändern. Um einen Fließ-
kommawert einzustellen, übergeben Sie eine einfache Fließkommazahl ohne Tau-
sendertrennzeichen und ohne Einheit. Werte, die eine Einheit haben, wie Ströme,
Spannungen und Widerstände, müssen in ihrer SI-Basiseinheit übergeben werden.

68 Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH


CEETIS TE Access DLL

pcVoltage_V: Spannung in Volt (Fließkomma)


pcTrise_s: Maximum Anlaufzeit in Sekunden (Fließkomma)
pcTwait_s: Wartezeit in Sekunden (Fließkomma)
pcTmeas_s: Messzeit in Sekunden (Fließkomma)
pcTmeasFactor: Messzeitfaktor während der Fehlersuche (Fließkomma)
pcVoltageRamp_Vps: Spannungsrampe in Volt pro Sekunde (Fließkomma)
pcFrequency_Hz: Frequenz in Hertz (Fließkomma)
pcThresholdIr_A: Schwellwert für realen Strom in Ampere (Fließkomma)
pcThresholdIi_A: Schwellwert für imaginären Strom in Ampere (Fließkomma)
pcAutoRange: Automatische Bereichswahl (boolesch)

Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH 69


CEETIS TE Access DLL

2.5.3 functioncall_paramisolationhv
Delphi: function functioncall_paramisolationhv(pcVoltage_V,
pcThreshold_ohm, pcTrise_s, pcTwait_s, pcTmeas_s,
pcAutoRange, pcTmeasReduction, pcCurrentLimit_A,
pcTmeasFactor, pcVoltageRamp_Vps: pchar): boolean;
stdcall;
C/C++: bool functioncall_paramisolationhv(char
*pcVoltage_V, char *pcThreshold_ohm, char
*pcTrise_s, char *pcTwait_s, char *pcTmeas_s, char
*pcAutoRange, char *pcTmeasReduction, char
*pcCurrentLimit_A, char *pcTmeasFactor, char
*pcVoltageRamp_Vps);
Visual Basic: Private Declare Function
functioncall_paramisolationhv Lib
"CEETIS_TE_Access.dll" (ByVal pcVoltage_V$, ByVal
pcThreshold_ohm$, ByVal pcTrise_s$, ByVal
pcTwait_s$, ByVal pcTmeas_s$, ByVal pcAutoRange$,
ByVal pcTmeasReduction$, ByVal pcCurrentLimit_A$,
ByVal pcTmeasFactor$, ByVal pcVoltageRamp_Vps$) as
boolean

Aufgabe
Diese Funktion stellt die Messparameter für den HV-Schlusstest ein. Die erlaubten
Werte finden Sie in Ihren Handbüchern oder im Projektparameter-Fenster.

Rückgabewert

 0 Die Funktion wurde nicht von CEETIS bearbeitet.


 1 Es wurden keine Probleme festgestellt.
 2 Es wurde ein Problem mit dem "Strom"-Wert erkannt.
2 Die Funktion wurde nicht ausgeführt.
 3 Es wurde ein Problem mit dem Wert "Schwellwert" erkannt.
2 Die Funktion wurde nicht ausgeführt.
 4 Ein Problem mit einem der Zeitwerte (Trise, Twait, Tmeas) wurde erkannt.
2 Die Funktion wurde nicht ausgeführt.
 5 Es wurde ein Problem mit dem Wert "Spannungsgrenze" erkannt.
2 Die Funktion wurde nicht ausgeführt.
 6 Es wurde ein Problem mit dem Wert "Spannungsrampe" erkannt.
2 Die Funktion wurde nicht ausgeführt.
 7 Es wurde ein Problem mit dem Wert "Tmess-Faktor" erkannt.
2 Die Funktion wurde nicht ausgeführt.

70 Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH


CEETIS TE Access DLL

 8 Es wurde ein Problem mit dem Wert "dIdT Aktiv" erkannt.


2 Die Funktion wurde nicht ausgeführt.
 9 Es wurde ein Problem mit dem Wert "dIdT Stromschwelle" erkannt.
2 Die Funktion wurde nicht ausgeführt.
 10 Es wurde ein Problem mit dem Wert "dIdT Zeitschwelle" erkannt.
2 Die Funktion wurde nicht ausgeführt.

Hinweis
Im Fenster des CEETIS TE können Sie zu Auswertungszwecken überprüfen, wel-
cher Parameter auf welchen Wert gesetzt wurde nachdem die Funktion ausgeführt
wurde. Es werden alle geänderten Werte angezeigt.

Parameter
Alle Messparameterwerte, ob Fließkomma- oder boolesche Werte, müssen als
String übergeben werden. Falls Sie einen Wert nicht ändern möchten, können Sie
einfach einen leeren oder ungültigen String für den Parameter übergeben. Um einen
booleschen Wert einzustellen, übergeben Sie 0 für FALSE, einen beliebigen Wert
größer 0 für TRUE und alles andere, um den Wert nicht zu ändern. Um einen Fließ-
kommawert einzustellen, übergeben Sie eine einfache Fließkommazahl ohne Tau-
sendertrennzeichen und ohne Einheit. Werte, die eine Einheit haben, wie Ströme,
Spannungen und Widerstände, müssen in ihrer SI-Basiseinheit übergeben werden.

pcVoltage_V: Spannung in Volt (Fließkomma)


pcThreshold_ohm: Schwellwert in Ohm (Fließkomma)
pcTrise_s: Maximum Anlaufzeit in Sekunden (Fließkomma)
pcTwait_s: Wartezeit in Sekunden (Fließkomma)
pcTmeas_s: Messzeit in Sekunden (Fließkomma)
pcAutoRange: Automatische Bereichswahl (boolesch)
pcTmeasReduction: Reduktion der Messzeit (boolesch)
pcCurrentLimit_A: Stromgrenze in Ampere (Fließkomma)
pcTmeasFactor: Messzeitfaktor während der Fehlersuche (Fließkomma)
pcVoltageRamp_Vps: Spannungsrampe in Volt pro Sekunde (Fließkomma)

Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH 71


CEETIS TE Access DLL

2.5.4 functioncall_paramisolationlv
Delphi: function functioncall_paramisolationlv(pcVoltage_V,
pcThreshold_ohm, pcTrise_s, pcTwait_s, pcTmeas_s,
pcAutoRange, pcTmeasReduction, pcCurrentLimit_A:
pchar): boolean; stdcall;
C/C++: bool functioncall_paramisolationlv(char
*pcVoltage_V, char *pcThreshold_ohm, char
*pcTrise_s, char *pcTwait_s, char *pcTmeas_s, char
*pcAutoRange, char *pcTmeasReduction, char
*pcCurrentLimit_A);
Visual Basic: Private Declare Function
functioncall_paramisolationlv Lib
"CEETIS_TE_Access.dll" (ByVal pcVoltage_V$, ByVal
pcThreshold_ohm$, ByVal pcTrise_s$, ByVal
pcTwait_s$, ByVal pcTmeas_s$, ByVal pcAutoRange$,
ByVal pcTmeasReduction$, ByVal pcCurrentLimit_A$)
as boolean

Aufgabe
Diese Funktion stellt die Messparameter für den LV-Schlusstest ein. Die erlaubten
Werte finden Sie in Ihren Handbüchern oder im Projektparameter-Fenster.

Rückgabewert

 0 Die Funktion wurde nicht von CEETIS bearbeitet.


 1 Es wurden keine Probleme festgestellt.
 2 Es wurde ein Problem mit dem "Strom"-Wert erkannt.
2 Die Funktion wurde nicht ausgeführt.
 3 Es wurde ein Problem mit dem Wert "Schwellwert" erkannt.
2 Die Funktion wurde nicht ausgeführt.
 4 Ein Problem mit einem der Zeitwerte (Trise, Twait, Tmeas) wurde erkannt.
2 Die Funktion wurde nicht ausgeführt.
 5 Es wurde ein Problem mit dem Wert "Spannungsgrenze" erkannt.
2 Die Funktion wurde nicht ausgeführt.

Hinweis
Im Fenster des CEETIS TE können Sie zu Auswertungszwecken überprüfen, wel-
cher Parameter auf welchen Wert gesetzt wurde nachdem die Funktion ausgeführt
wurde. Es werden alle geänderten Werte angezeigt.

Parameter

72 Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH


CEETIS TE Access DLL

Alle Messparameterwerte, ob Fließkomma- oder boolesche Werte, müssen als


String übergeben werden. Falls Sie einen Wert nicht ändern möchten, können Sie
einfach einen leeren oder ungültigen String für den Parameter übergeben. Um einen
booleschen Wert einzustellen, übergeben Sie 0 für FALSE, einen beliebigen Wert
größer 0 für TRUE und alles andere, um den Wert nicht zu ändern. Um einen Fließ-
kommawert einzustellen, übergeben Sie eine einfache Fließkommazahl ohne Tau-
sendertrennzeichen und ohne Einheit. Werte, die eine Einheit haben, wie Ströme,
Spannungen und Widerstände, müssen in ihrer SI-Basiseinheit übergeben werden.
pcVoltage_V: Spannung in Volt (Fließkomma)
pcThreshold_ohm: Schwellwert in Ohm (Fließkomma)
pcTrise_s: Maximum Anlaufzeit in Sekunden (Fließkomma)
pcTwait_s: Wartezeit in Sekunden (Fließkomma)
pcTmeas_s: Messzeit in Sekunden (Fließkomma)
pcAutoRange: Automatische Bereichswahl (boolesch)
pcCurrentLimit_A: Stromgrenze in Ampere (Fließkomma)

2.5.5 functioncall_paramresetcontinuity
Delphi: function functioncall_paramresetcontinuity:
boolean; stdcall;
C/C++: bool functioncall_paramresetcontinuity(void);
Visual Basic: Private Declare Function
functioncall_paramresetcontinuity Lib
"CEETIS_TE_Access.dll" () as boolean

Aufgabe
Diese Funktion setzt die Messparameter für den Durchgangstest auf die Werte in der
Parameter-Datei zurück. Ist keine Parameter-Datei vorhanden, werden die Stan-
dardwerte verwendet.

Rückgabewert
Der Rückgabewert ist TRUE, wenn „ParamResetContinuity“ erfolgreich in der
CEETIS TE aufgerufen wurde, andernfalls FALSE.

2.5.6 functioncall_paramresetdielectricbreakdown
Delphi: function functioncall_paramresetdielectricbreakdown:
boolean; stdcall;
C/C++: bool functioncall_paramresetdielectricbreakdown(void);
Visual Basic: Private Declare Function
functioncall_paramresetdielectricbreakdown Lib
"CEETIS_TE_Access.dll" () as boolean

Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH 73


CEETIS TE Access DLL

Aufgabe
Diese Funktion setzt die Messparameter für den Überschlagstest auf die Werte in
der Parameter-Datei zurück. Ist keine Parameter-Datei vorhanden, werden die Stan-
dardwerte verwendet.

Rückgabewert
Die übergebenen Werte werden geprüft und wenn ein Problem erkannt wird, gibt die
Funktion einen Wert größer als 2 zurück.

 0 Die Funktion wurde nicht von CEETIS bearbeitet.


 1 Es wurden keine Probleme festgestellt.
 2 Es wurde ein Problem mit dem "Strom"-Wert erkannt.
2 Die Funktion wurde nicht ausgeführt.
 3 Es wurde ein Problem mit dem Wert "Schwellwert" erkannt.
2 Die Funktion wurde nicht ausgeführt.
 4 Ein Problem mit einem der Zeitwerte (Trise, Twait, Tmeas) wurde erkannt.
2 Die Funktion wurde nicht ausgeführt.
 5 Es wurde ein Problem mit dem Wert "Spannungsgrenze" erkannt.
2 Die Funktion wurde nicht ausgeführt.
 6 Es wurde ein Problem mit dem Wert "Spannungsrampe" erkannt.
2 Die Funktion wurde nicht ausgeführt.
 7 Es wurde ein Problem mit dem Wert "Tmess-Faktor" erkannt.
2 Die Funktion wurde nicht ausgeführt.
 8 Es wurde ein Problem mit dem Wert "Frequenz" erkannt.
2 Die Funktion wurde nicht ausgeführt.

74 Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH


CEETIS TE Access DLL

2.5.7 functioncall_paramresetisolationhv
Delphi: function functioncall_paramresetisolationhv:
boolean; stdcall;
C/C++: bool functioncall_paramresetisolationhv(void);
Visual Basic: Private Declare Function
functioncall_paramresetisolationhv Lib
"CEETIS_TE_Access.dll" () as boolean

Aufgabe
Diese Funktion setzt die Messparameter für den HV-Schlusstest auf die Werte in der
Parameter-Datei zurück. Ist keine Parameter-Datei vorhanden, werden die Stan-
dardwerte verwendet.

Rückgabewert
Der Rückgabewert ist TRUE, wenn „ParamResetIsolationHV“ erfolgreich in der
CEETIS TE aufgerufen wurde, andernfalls FALSE.

2.5.8 functioncall_paramresetisolationlv
Delphi: function functioncall_paramresetisolationlv:
boolean; stdcall;
C/C++: bool functioncall_paramresetisolationlv(void);
Visual Basic: Private Declare Function
functioncall_paramresetisolationlv Lib
"CEETIS_TE_Access.dll" () as boolean

Aufgabe
Diese Funktion setzt die Messparameter für den LV-Schlusstest auf die Werte in der
Parameter-Datei zurück. Ist keine Parameter-Datei vorhanden, werden die Stan-
dardwerte verwendet.

Rückgabewert
Der Rückgabewert ist TRUE, wenn „ParamResetIsolationLV“ erfolgreich in der
CEETIS TE aufgerufen wurde, andernfalls FALSE.

Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH 75


CEETIS TE Access DLL

76 Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH


CEETIS TE Access DLL

2.6 Testsonde

2.6.1 get_probe_pins
Delphi: function get_probe_pins(pcResultBuffer: pchar;
iResultBufferSize: integer): integer; stdcall;
C/C++: int get_probe_pins(char *pcResultBuffer,
int iResultBufferSize);
Visual Basic: Private Declare Function get_probe_pins& Lib
"CEETIS_TE_Access.dll" (ByVal pcResultBuffer$,
ByVal iResultBufferSize&)

Aufgabe
Diese Funktion gibt die Pins zurück, die mit der Sonde berührt wurden.
Die Funktion kann auch in einer Schleife wiederholt aufgerufen werden, um auf be-
rührte Pins zu warten. Dazu muss vorher die Funktion „start_probe“ aufgerufen wer-
den. In einer Schleife müssen auch Routinen aufgerufen werden, die dafür sorgen,
dass Fensterbotschaften verarbeitet werden.

Rückgabewert
Wenn keine Pins vorhanden sind, ist der Rückgabewert „0“. Andernfalls entspricht
der Rückgabewert der Anzahl der Zeichen, die in den Ergebnispuffer geschrieben
wurden.
Der Ergebnispuffer enthält die Pins. Jeder Pinname wird durch „Wagenrücklauf +
Zeilenvorschub“ (CRLF= #13#10) abgeschlossen.

Parameter
pcResultBuffer: Zeiger auf den Pufferspeicher, in den die Pins geschrie-
ben werden sollen. Je größer das Netzwerk eines Prüf-
lings ist, desto größer sollte auch der Puffer sein. Es wird
empfohlen, mit einer Größe von 1024 Bytes zu starten.
iResultBufferSize: Größe des zugeordneten Ergebnispuffers

Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH 77


CEETIS TE Access DLL

2.6.2 start_probe
Delphi: function start_probe: boolean; stdcall;
C/C++: bool start_probe(void);
VisualBasic: Private Declare Function start_probe Lib
"CEETIS_TE_Access.dll" () as boolean

Aufgabe
Diese Funktion startet die Testsonde.
Voraussetzung:
 Es muss ein Projekt geöffnet sein.
 Das Testsystem muss verfügbar sein, um diese Funktion auszuführen.

Rückgabewert
Der Rückgabewert ist TRUE, wenn die Testsonde gestartet wurde. Sonst ist der
Rückgabewert FALSE.

2.6.3 stop_probe
Delphi: function stop_probe: boolean; stdcall;
C/C++: bool stop_probe(void);
VisualBasic: Private Declare Function stop_probe Lib
"CEETIS_TE_Access.dll" () as boolean

Aufgabe
Diese Funktion stoppt die Testsonde.
Voraussetzung:

 Es muss ein Projekt geöffnet sein.


 Das Testsystem muss verfügbar und die Testsonde muss aktiv sein, um diese
Funktion ausführen zu können.

Rückgabewert
Der Rückgabewert ist TRUE, wenn die Testsonde gestoppt wurde. Sonst ist der
Rückgabewert FALSE.

78 Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH


CEETIS TE Access DLL

2.7 Testsystem
Diese Funktionen erlauben den Zugriff auf einige Bestandteile des Testsystems, wie
den Sicherheitskreis oder die Warnlampe. Wird eine Testsystemfunktion aufgerufen,
muss anschließend so lange gewartet werden, bis diese Funktion beendet ist. Dies
kann durch Ausführen der Funktion „test_system_command_finished“ in einer
Schleife erreicht werden. In einer solchen Warteschleife müssen auch Routinen auf-
gerufen werden, die dafür sorgen, dass Fensterbotschaften verarbeitet werden. Das
Ergebnis dieser Funktionen wird über die Funktion „test_system_command_finished“
zurückgegeben.

2.7.1 test_system_command_finished
Delphi: function
test_system_command_finished(pcResultBuffer:
pchar; iResultBufferSize: integer): integer;
stdcall;
C/C++: int test_system_command_finished(char
*pcResultBuffer, int iResultBufferSize);
Visual Basic: Private Declare Function
test_system_command_finished& Lib
"CEETIS_TE_Access.dll" (ByVal pcResultBuffer$,
ByVal iResultBufferSize&)

Aufgabe
Diese Funktion gibt zurück, ob der Aufruf einer Funktion aus der Gruppe Testsystem
ausgeführt wurde oder nicht. Die Funktion kann nach dem Aufruf einer Testsystem-
Funktion in einer Schleife ausgeführt werden, die so lange durchlaufen wird, bis der
Test beendet ist. In dieser Schleife müssen auch Routinen aufgerufen werden, die
dafür sorgen, dass Fensterbotschaften verarbeitet werden.

Parameter
pcResultBuffer: Zeiger auf einen Pufferspeicher für den Ergebnisstring. Der
Puffer sollte eine Mindestgröße von 1024 Byte besitzen.
iResultBufferSize Größe des zugeordneten Ergebnispuffers

Rückgabewert
Der Rückgabewert ist 0, wenn kein Ergebnis vorliegt. Sobald ein Ergebnis vorliegt,
wird die Anzahl der Zeichen (inklusive aller Trennzeichen) zurückgegeben, die in
den Ergebnispuffer geschrieben wurden. Der Puffer enthält das Ergebnis als String.
Die Daten im String sind in Felder gegliedert. Jedes Feld wird durch
„Wagenrücklauf und Zeilenvorschub (CRLF = #13#10)” abgeschlossen.

Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH 79


CEETIS TE Access DLL

Das erste Feld enthält allgemeine Informationen zur Ausführung der Funktion. Ab-
hängig von seinem Wert enthält das zweite Feld zusätzliche Informationen. Bei feh-
lerfreier Ausführung der Testsystemfunktion, wird das Ergebnis an die nachfolgen-
den Felder zurückgegeben. Die Ergebnisdaten sind vom Typ der ausgeführten Funk-
tion abhängig.

Wert von Feld 1 Beschreibung


executed Die Funktion wurde ausgeführt.
 2. Feld: Enthält das Ergebnis (success oder failed)
 nachfolgende Felder: Ergebnisdaten (siehe anschließende
Beschreibungen der Funktionen)
function execution Ein Fehler ist während der Ausführung einer Funktion aufgetre-
error ten.
 2. Feld: Enthält den Fehlertyp:
- Hexadecimal value:
Fehlercode, der meistens das Ergebnis
eines ungültigen Parameters oder eines
Hardwareproblems ist.
- unknown: Unbekannter Fehler
 nachfolgende Felder: nicht genutzt

80 Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH


CEETIS TE Access DLL

2.7.2 close_safety_circuit
Delphi: function close_safety_circuit(boWithCheck:
boolean): boolean; stdcall;
C/C++: bool close_safety_circuit(bool boWithCheck);
Visual Basic: Private Declare Function close_safety_circuit Lib
"CEETIS_TE_Access.dll" (boWithCheck as boolean) as
boolean

Aufgabe
Diese Funktion schließt den Sicherheitskreis und führt einen optionalen Funktions-
test durch, wenn dies notwendig und möglich ist. Weitere Informationen und Hinwei-
se zum Sicherheitskreis finden Sie im Hardwarehandbuch Ihres Testsystems.

Parameter
boWithCheck: Wenn Sie für den Parameter „boWithCheck“ TRUE übergeben,
wird nach dem Schließen des Sicherheitskreises für die Sicher-
heitseinheiten ein Funktionstest durchgeführt.
Hinweis: Wenn der Sicherheitskreis bereits zuvor geschlossen
wurde, wird kein Funktionstest durchgeführt, auch wenn
„boWithCheck“ auf TRUE gesetzt ist.

Rückgabewert
Der Rückgabewert ist TRUE, wenn die Routine für den Sicherheitskreis erfolgreich in
der CEETIS TE aufgerufen wurde, andernfalls ist der Rückgabewert FALSE.

Ergebnisdaten
Wenn die Funktion ausgeführt wurde (1. Feld = executed) und dabei ein Fehler auf-
getreten ist, enthält das 3. Feld des Ergebnisstrings eine zusätzliche Information
zum aufgetretenen Problem und das 4. Feld einen Fehlercode.

Feldnummer Beschreibung
3 close: Der Sicherheitskreis konnte nicht geschlossen werden.
Häufigster Grund für dieses Problem ist, dass der NOT-
AUS-Schalttaster noch gedrückt ist oder dass der
Sicherheitskreis durch ein anderes Sicherheitselement
unterbrochen ist (z.B. Lichtschranke, etc.)
check: Der Funktionstest der Sicherheitsschalteinrichtungen ist
fehlgeschlagen. In diesem Fall sollten Sie einen Diagno-
selauf durchführen.
4 Hexadecimal value:
Ein Fehlercode, dem meistens ein unzulässiger Parame-
ter oder ein Hardwareproblem zu Grunde liegt.

Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH 81


CEETIS TE Access DLL

2.7.3 is_safety_circuit_closed
Delphi: function is_safety_circuit_closed: boolean;
stdcall;
C/C++: bool is_safety_circuit_closed(void);
Visual Basic: Private Declare Function is_safety_circuit_closed
Lib "CEETIS_TE_Access.dll" () as boolean

Aufgabe
Diese Funktion prüft, ob der Sicherheitskreis geschlossen ist oder nicht.

Rückgabewert
Der Rückgabewert ist TRUE, wenn die Routine für die Sicherheitskreisabfrage er-
folgreich in der CEETIS TE aufgerufen wurde, andernfalls ist der Rückgabewert
FALSE.

Ergebnisdaten
Bei fehlerfreier Ausführung der Funktion, enthält das 3. Feld des Ergebnisstrings den
Status des Sicherheitskreises.

Feldnummer Bezeichnung
3 open oder closed

82 Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH


CEETIS TE Access DLL

2.7.4 is_safety_circuit_hv_key_switch_closed
Delphi: function is_safety_circuit_hv_key_switch_closed:
boolean; stdcall;
C/C++: bool is_safety_circuit_hv_key_switch_closed(void);
Visual Basic: Private Declare Function
is_safety_circuit_hv_key_switch_closed Lib
"CEETIS_TE_Access.dll" () as boolean

Aufgabe
Diese Funktion prüft, ob der HV-Schlüsselschalter an der SHVSU geschlossen ist
oder nicht.

Rückgabewert
Der Rückgabewert ist TRUE, wenn die Routine für die Sicherheitskreisabfrage er-
folgreich in CEETIS TE aufgerufen wurde, anderenfalls ist der Rückgabewert
FALSE.

Ergebnisdaten
Bei fehlerfreier Ausführung der Funktion, enthält das 3. Feld des Ergebnisstrings den
Status des HV-Schlüsselschalters.

Feldnummer Bezeichnung
3 open oder closed

Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH 83


CEETIS TE Access DLL

2.7.5 reset_test_system
Delphi: function reset_test_system: boolean; stdcall;
C/C++: bool reset_test_system(void);
Visual Basic: Private Declare Function reset_test_system Lib
"CEETIS_TE_Access.dll" () as boolean

Aufgabe
Die Funktion setzt die Matrix und die internen Generatoren des Testsystems zurück.
Wenn Sie zum Starten eines automatischen CEETIS-Tests anstelle der „run_test“-
Funktion Ihre eigene Testsequenz verwenden wollen, empfehlen wir Ihnen, am Ende
Ihrer Testsequenz die Funktion reset_test_system aufzurufen.

Rückgabewert
Der Rückgabewert ist TRUE, wenn das Programm erfolgreich in der CEETIS TE
aufgerufen wurde, andernfalls ist der Rückgabewert FALSE.

Ergebnisdaten
Keine weiteren Ergebnisdaten

84 Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH


CEETIS TE Access DLL

2.7.6 set_warning_light_flashing
Delphi: function set_warning_light_flashing(boSwitchOn:
boolean): boolean; stdcall;
C/C++: bool set_warning_light_flashing(bool boSwitchOn);
Visual Basic: Private Declare Function set_warning_light_flashing
Lib "CEETIS_TE_Access.dll" (boSwitchOn as boolean)
as boolean

Aufgabe
Die Funktion aktiviert/deaktiviert das Blinken der Warnlampe des Testsystems. Es ist
nicht möglich, die Warnlampe ein- bzw. auszuschalten oder die Anzeige der Farb-
signale zu manipulieren.

Parameter
boSwitchOn: Wenn Sie für die Funktion „boSwitchOn“ TRUE übergeben, wird
das Blinken der Warnlampe aktiviert. Wenn Sie FALSE überge-
ben, wird das Blinken der Warnlampe deaktiviert.

Rückgabewert
Der Rückgabewert ist TRUE, wenn das Warnlampenprogramm erfolgreich in der
CEETIS TE aufgerufen wurde, andernfalls ist der Rückgabewert FALSE.

Ergebnisdaten
Keine weiteren Ergebnisdaten

Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH 85


CEETIS TE Access DLL

2.8 Benutzerdefinierte Funktionsaufrufe


Benutzerdefinierte Funktionsaufrufe rufen vom Benutzer geschriebene ATS-
Funktionen auf. Der Aufruf wird mit „execute_custom_function“ gestartet. Im An-
schluss müssen Sie warten, bis die Funktion beendet ist. Dies kann durch Aufrufen
der Funktion „custom_function_finished“ in einer Schleife erreicht werden. In einer
solchen Warteschleife müssen auch Routinen aufgerufen werden, die dafür sorgen,
dass Fensterbotschaften verarbeitet werden. „custom_function_finished“ signalisiert,
dass die Funktion beendet ist und gibt deren Ergebnis und Rückgabewert zurück.

2.8.1 custom_function_finished
Delphi: function custom_function_finished(pcResultBuffer:
pchar; iResultBufferSize: integer): integer;
stdcall;
C/C++: int custom_function_finished(char *pcResultBuffer,
int iResultBufferSize);
Visual Basic: Private Declare Function custom_function_finished&
Lib "CEETIS_TE_Access.dll" (ByVal pcResultBuffer$,
ByVal iResultBufferSize&)

Aufgabe
Diese Funktion gibt zurück, ob ein benutzerdefinierter Funktionsaufruf beendet ist
oder nicht. Zudem enthält der Pufferspeicher den Rückgabewert der aufgerufenen
Funktion. Die Funktion kann nach dem Aufruf „execute_custom_function” in einer
Schleife ausgeführt werden, die so lange durchlaufen wird, bis der Test beendet ist.
In dieser Schleife müssen auch Routinen aufgerufen werden, die dafür sorgen, dass
Fensterbotschaften verarbeitet werden.

Parameter
pcResultBuffer: Zeiger auf einen Pufferspeicher für den Ergebnis- und
den Rückgabewert-String. Der Puffer sollte eine Mindest-
größe von 4096 Byte besitzen.
iResultBufferSize: Größe des zugewiesenen Ergebnispuffers.

Rückgabewert
Der Rückgabewert ist 0, wenn kein Testergebnis vorliegt. Sobald ein Ergebnis vor-
liegt, wird die Anzahl der Zeichen (inklusive aller Trennzeichen) zurückgegeben, die
in den Ergebnispuffer geschrieben wurden. Der Puffer enthält das Ergebnis als
String.
Die Daten im String sind in Felder gegliedert. Jedes Feld wird durch „Wagenrücklauf
und Zeilenvorschub (CRLF = #13#10)” abgeschlossen.

86 Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH


CEETIS TE Access DLL

Das erste Feld enthält allgemeine Informationen über die Ausführung der Funktion.
Abhängig davon liefert das zweite Feld zusätzliche Informationen. Bei erfolgreicher
Ausführung der Testsystemfunktion, werden die Ergebnisdaten an die nachfolgen-
den Feldern zurückgegeben. Die Ergebnisdaten hängen vom Typ der ausgeführten
Funktion ab.

Wert von Feld 1 Beschreibung


executed Die Funktion wurde ausgeführt.
 2. Feld: unknown
 3 Feld: Rückgabewert der benutzerdefinierten Funktion
(= Wert, der in der ATS-Funktion „Result” zugewiesen ist)
 nachfolgende Felder: nicht genutzt
function call error Ein Fehler trat beim Funktionsaufruf auf. Gründe dafür könnten
sein, dass die Funktion nicht existiert oder sie nicht für den Be-
reichstest getaggt ist.
 2. Feld:
- function not found: Die Funktion existiert nicht im Pro-
jekt
- not tagged for range test:
Die Funktion ist nicht für den Be-
reichstest markiert
(Direktive „rangetest” fehlt)
- invalid parameters: Einer oder mehrere Parameter
der ATS Funktion sind ungültig
 nachfolgende Felder: nicht genutzt
function execution Ein Fehler trat während der Ausführung der Funktion auf.
error  2. Feld: Enthält den Fehlertyp:
- safety circuit: Eine Unterbrechung des Sicherheitskrei-
ses wurde festgestellt.
- Hexadecimal value:
Fehlercode, der meistens das Ergebnis
eines ungültigen Parameters oder eines
Hardwareproblems ist.
- unknown: Unbekannter Fehler
 nachfolgende Felder: nicht genutzt
invalid Das Ergebnis der Funktion ist ungültig.
 2. Feld: Enthält den Grund, warum das Ergebnis ungültig
ist.
- user break: Ausführung der Funktion wurde durch den
Benutzer unterbrochen (derzeit keine an-
deren möglichen Werte)
 nachfolgende Felder: nicht genutzt

Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH 87


CEETIS TE Access DLL

2.8.2 execute_custom_function
Delphi: function execute_custom_function(pcFunction,
pcParameters: pchar): boolean; stdcall;
C/C++: bool execute_custom_function(pchar pcFunction,
pchar pcParameters);
Visual Basic: Private Declare Function execute_custom_function
Lib "CEETIS_TE_Access.dll" (ByVal pcFunction$,
ByVal pcParameters$) as boolean

Aufgabe
Diese Funktion ruft eine benutzerdefinierte ATS-Funktion auf. Der ATS-Funktion
können Parameter übergeben werden.
Sie muss im ATS für den Bereichstest markiert werden Das bedeutet, die Direktive
„rangetest“ muss bei Definition der ATS-Funktion angegeben werden.
Fragen Sie nach dem Aufruf mit „custom_function_finished“ wiederholt ab, ob sie
beendet wurde.

Parameters
pcFunction: Gibt den Namen der auszuführenden ATS-Funktion an.
pcParameters: Enthält die Parameter der ATS-Funktion. Die einzelnen Parame-
ter innerhalb dieses Strings müssen in einfachen Anführungszei-
chen stehen und durch Kommas getrennt sein.

Rückgabewert
Der Rückgabewert ist TRUE, wenn die auszuführende Funktion erfolgreich in der
CEETIS TE aufgerufen wurde, andernfalls FALSE.

88 Dok. Nr.: 600020DE (5. Ausgabe, Revision E) 17.03.2022, FH

Das könnte Ihnen auch gefallen