Um die Authentizität der Subroutinen zu bewahren und eine schlechte Übersetzung zu vermeiden, behalten alle Subroutine-Listen ihre englischen Beschreibungen. Es wird empfohlen, die entsprechenden Typen von Subroutinen vor der Verwendung sorgfältig zu studieren. Nicht alle Subroutinen wurden hier verifiziert; aufgrund von Versions- oder Transkriptionsproblemen kann es Auslassungen geben. Korrekturen und Kommentare sind willkommen.

TF-Subroutinen werden häufig für den bidirektionalen Datentransfer zwischen Verilog und benutzerdefinierten C-Subroutinen verwendet. Wenn eine mit tf_ präfixierte Subroutine eine entsprechende mit tf_i präfixierte Subroutine hat, muss der Instanzzeiger, auf dem Operationen in der entsprechenden mit tf_i präfixierten Subroutine ausgeführt werden, als zusätzliche Variable am Ende der Variablenliste übergeben werden.

TF-Unterprogramme haben keine expliziten Klassifizierungsmarker in ihren Namenskonventionen. Das Folgende ist eine einfache Zusammenfassung.

Task- und Funktionsinformationen abrufen

RückgabetypAufrufformat und Beschreibung
char *◆tf_getinstance()
 Ruft einen Zeiger auf die aktuelle Instanz einer benutzerdefinierten System-Task oder -Funktion ab.
char *◆tf_mipname()
◆tf_imipname(char *instance_p)
 Ruft den hierarchischen Pfadnamen der Modulinstanz als Zeichenkette ab.
char *◆tf_spname()
◆tf_ispname(char *instance_p)
 Ruft den hierarchischen Pfadnamen des Gültigkeitsbereichs als Zeichenkette ab.

Informationen zur Variablenliste abrufen

RückgabetypAufrufformat und Beschreibung
int◆tf_nump()
◆tf_inump(char *instance_p)
 Ermittelt die Anzahl der Argumente von Task oder Funktion.
int◆tf_typep(int narg)
◆tf_itypep(int narg, char *instance_p)
 Ermittelt den Argumenttyp einer System-Task/-Funktion.
int◆tf_sizep(narg)
◆tf_isizep(int narg, char *instance_p)
 Ermittelt die Bitlänge eines Arguments einer System-Task/-Funktion.
t_tfexprinfo *◆tf_exprinfo(int narg, t_tfexprinfo *exprinfo_p)
◆tf_iexprinfo(int narg, t_tfexprinfo *exprinfo_p, char *instance_p)
 Informationen zum Argumentausdruck einer System-Task/System-Funktion abrufen.
t_tfexprinfo ist eine Datenstruktur, die in veriuser.h definiert ist.
t_tfnodeinfo *◆tf_nodeinfo(int narg, t_tfnodeinfo *nodeinfo_p)
◆tf_inodeinfo(int narg, t_tfnodeinfo *nodeinfo_p, char *instance_p)
 Informationen zum Argumentknoten einer System-Task/System-Funktion abrufen.
t_tfnodeinfo ist eine Datenstruktur, die in veriuser.h definiert ist.

Parameterwert abrufen

RückgabetypAufrufformat und Beschreibung
int◆tf_getp(int narg)
◆tf_igetp(int narg, char *instance_p)
 Einen Argumentwert einer System-Task/System-Funktion als Integer- oder Zeichenkettenzeiger abrufen.
double◆tf_getrealp(int narg)
◆tf_igetrealp(int narg, char *instance_p)
 Ruft den Wert eines System-Task-/Funktionsarguments als Double-Precision-Wert ab.
int◆tf_getlongp(int *aof_highvalue, int narg)
◆tf_igetlongp(int *aof_highvalue, int narg, char *instance_p)
 Ruft den Wert eines System-Task-/Funktionsarguments als 64-Bit-Ganzzahl ab.
char *◆tf_strgetp(int narg, int format)
◆tf_istrgetp(int narg, int format, char *instance_p)
 Ruft formatierte Werte von System-Task-/Funktionsargumenten ab.
char *◆tf_getcstringp(int narg)
◆tf_igetcstringp(int narg, char *instance_p)
 Ruft den Wert eines System-Task-/Funktionsarguments als Zeichenkette ab.
int◆tf_evaluatep(int narg)
◆tf_ievaluatep(int narg, char *instance_p)
 Wertet einen Argumentausdruck einer System-Task/-Funktion aus.

Parameterwert festlegen

RückgabetypAufrufformat und Beschreibung
int◆tf_putp(int narg, int value)
◆tf_iputp(int narg, int value, char *instance_p)
 Schreibt einen Ganzzahlwert in ein Argument einer System-Task/-Funktion oder einen Funktionsrückgabewert.
int◆tf_putrealp(int narg, double value)
◆tf_iputrealp(int narg, double value, char *instance_p)
 Schreibt einen Realwert in ein Argument einer System-Task/-Funktion oder einen Funktionsrückgabewert.
int◆tf_putlongp(int narg, int lowvalue, int highvalue)
◆tf_iputlongp(int narg, int lowvalue, int highvalue, char *instance_p)
 Schreibt einen 64-Bit-Ganzzahlwert in ein Argument einer System-Task/-Funktion oder einen Funktionsrückgabewert.
int◆tf_propagatep(int narg)
◆tf_ipropagatep(int narg, char *instance_p)
 Propagiert einen Argumentwert einer Systemtask/-funktion.
int◆tf_strdelputp(int narg, int bitlength, char format, char *value_p, int delay, int delaytype)
◆tf_istrdelputp(int narg, int bitlength, char format, char *value_p, int delay, int delaytype, char *instance_p)
 Schreibt einen Wert in ein Argument einer Systemtask/-funktion aus einer String-Wertangabe unter Verwendung einer 32-Bit-Ganzzahlverzögerung.
int◆tf_strrealdelputp(int narg, int bitlength, char format, char *value_p, double realdelay, int delaytype)
◆tf_istrrealdelputp(int narg, int bitlength, char format, char *value_p, double realdelay, int delaytype, char *instance_p)
 Schreibt einen Wert in ein Argument einer Systemtask/-funktion aus einer String-Wertangabe unter Verwendung einer reellen Zahl als Verzögerung.
int◆tf_strlongdelputp(int narg, int bitlength, char format, char *value_p, int lowdelay, int highdelay, int delaytype)
◆tf_istrlongdelputp(int narg, int bitlength, char format, char *value_p, int lowdelay, int highdelay, int delaytype, char *instance_p)
 Schreibt einen Wert in ein Argument einer Systemtask/-funktion aus einer String-Wertangabe unter Verwendung einer 64-Bit-Ganzzahlverzögerung.

Parameterwertänderungen überwachen

RückgabetypAufrufformat und Beschreibung
int◆tf_asynchon()
◆tf_iasynchon(char *instance_p)
 Asynchronen Aufruf der misctf-Anwendung bei Änderungen der Argumentwerte von Systemtask/-funktion aktivieren.
int
(immer 0)
◆tf_asynchoff()
◆tf_iasynchoff(char *instance_p)
 Asynchronen Aufruf der misctf-Anwendung deaktivieren.
int◆tf_synchronize()
◆tf_isynchronize(char *instance_p)
 Bis zum Ende des Simulationszeitschritts synchronisieren.
int◆tf_rosynchronize()
◆tf_irosynchronize(char *instance_p)
 Bis zum Ende des Simulationszeitschritts synchronisieren.
int◆tf_getpchange(int narg)
◆tf_igetpchange(int narg, char *instance_p)
 Ermittelt die Indexnummer des nächsten System-Task-/Funktionsarguments, dessen Wert sich geändert hat.
int◆tf_copypvc_flag(int narg)
◆tf_icopypvc_flag(int narg, char *instance_p)
 Kopiert die Flags für Wertänderungen der Argumente von System-Tasks/-Funktionen.
int◆tf_movepvc_flag(int narg)
◆tf_imovepvc_flag(int narg, char *instance_p)
 Verschiebt die Flags für Wertänderungen der Argumente von System-Tasks/-Funktionen.
int◆tf_testpvc_flag(int narg)
◆tf_itestpvc_flag(int narg, char *instance_p)
 Argumentwert-Änderungsflags von Testsystem-Task/-Funktion.

Task-Synchronisation

RückgabetypAufrufformat und Beschreibung
int◆tf_gettime()
◆tf_igettime(char *instance_p)
 Liefert die aktuelle Simulationszeit als 32-Bit-Ganzzahl.
double◆tf_getrealtime()
◆tf_igetrealtime(char *instance_p)
 Liefert die aktuelle Simulationszeit im Format doppelter Genauigkeit.
int◆tf_getlongtime(int *aof_hightime)
◆tf_igetlongtime(int *aof_hightime, char *instance_p)
 Liefert die aktuelle Simulationszeit als 64-Bit-Ganzzahl.
Gibt die niederwertigsten (rechtesten) 32 Bits der Simulationszeit zurück
char *◆tf_strgettime()
 Ruft die aktuelle Simulationszeit als Zeichenfolge ab.
int◆tf_getnextlongtime(int *aof_lowtime, int *aof_hightime)
 Ruft den nächsten Zeitpunkt ab, zu dem ein Simulationsereignis geplant ist
int◆tf_gettimeprecision()
◆tf_igettimeprecision(char *instance_p)
 Ruft die Zeitskalenpräzision eines Moduls oder einer Simulation ab.
int◆tf_gettimeunit()
◆tf_igettimeunit(char *instance_p)
 Ruft die Zeitskaleneinheit eines Moduls oder einer Simulation ab.
int◆tf_setdelay(int delay)
◆tf_isetdelay(int delay, char *instance_p)
 Aktiviert die misctf-Anwendung zu einem bestimmten Simulationszeitpunkt.
int◆tf_setlongdelay(int lowdelay, int highdelay)
◆tf_isetlongdelay(int lowdelay, int highdelay, char *instance_p)
 Aktiviert die misctf-Anwendung zu einem bestimmten Simulationszeitpunkt.
int◆tf_setrealdelay(double realdelay)
◆tf_isetrealdelay(double realdelay, char *instance_p)
 Aktiviert die misctf-Anwendung zu einem bestimmten Simulationszeitpunkt.
void◆tf_scale_longdelay(char *instance_p, int delay_lo, int delay_hi, int *aof_delay_lo, int *aof_delay_hi)
 Konvertiert eine 64-Bit-Ganzzahlverzögerung in die Zeitskala der Modulinstanz.
void◆tf_scale_realdelay(char *instance_p, double realdelay, double *aof_realdelay)
 Konvertiert eine Gleitkommaverzögerung doppelter Genauigkeit in die Zeitskala der Modulinstanz.
void◆tf_unscale_longdelay(char *instance_p, int delay_lo, int delay_hi, int *aof_delay_lo, int *aof_delay_hi)
 Konvertiert eine Verzögerung von internen Simulationszeiteinheiten in die Zeitskala eines bestimmten Moduls.
void◆tf_unscale_realdelay(char *instance_p, double realdelay, double *aof_realdelay)
 Wandelt eine in internen Simulationszeiteinheiten ausgedrückte Verzögerung in die Zeitskala eines bestimmten Moduls um.
int◆tf_clearalldelays()
◆tf_iclearalldelays(char *instance_p)
 Löscht alle durch tf_setdelay() oder tf_isetdelay() geplanten Reaktivierungen.

Arithmetische Operationen

RückgabetypAufrufformat und Beschreibung
int
(immer 0)
◆tf_add_long(int *aof_low1, int *aof_high1, int low2, int high2)
 Addiert zwei 64-Bit-Ganzzahlen.
int
(immer 0)
◆tf_subtract_long(int *aof_low1, int *aof_high1, int low2, int high2)
 Subtrahiert zwei 64-Bit-Ganzzahlen.
void◆tf_multiply_long(int *aof_low1, int *aof_high1, int low2, int high2)
 Multipliziert zwei 64-Bit-Ganzzahlen.
void◆tf_divide_long(int *aof_low1, int *aof_high1, int low2, int high2)
 Dividiert zwei 64-Bit-Ganzzahlen.
int◆tf_compare_long(int low1, int high1, int low2, int high2)
 Vergleicht zwei 64-Bit-Ganzzahlwerte.
char *◆tf_longtime_tostr(int lowtime, int hightime)
 Konvertiert einen 64-Bit-Ganzzahl-Zeitwert in eine Zeichenkette.
void◆tf_real_to_long(double realvalue, int *aof_low, int *aof_high)
 Konvertiert eine reelle Zahl in eine 64-Bit-Ganzzahl.
void◆tf_long_to_real(int low, int high, double *aof_real)
 Konvertiert eine 64-Bit-Ganzzahl in eine reelle Zahl.

Informationen anzeigen

RückgabetypAufrufformat und Beschreibung
void◆io_printf(char *format, arg1, ..., arg12)
 Gibt eine formatierte Meldung an den Ausgabekanal des Softwareprodukts aus, das die PLI-Anwendung aufgerufen hat, und an die Protokolldatei des Produkts.
void◆io_mcdprintf(int mcd, char *format, arg1, ..., arg12)
 Schreibt eine formatierte Meldung in eine oder mehrere Dateien.
int
(immer 0)
◆tf_error(char *format, arg1,..., arg5)
 Eine Fehlermeldung melden.
int
(immer 0)
◆tf_warning(char *format, arg1, ..., arg5)
 Eine Warnmeldung melden.
int
(immer 0)
◆tf_message(int level, char *facility, char *code, char *message, arg1,..., arg5)
 Eine Fehler- oder Warnmeldung mit Steuerung der Unterbrechung des Softwareprodukts melden.
int
(immer 0)
◆tf_text(char *message, arg1,..., arg5)
 Fehlermeldungsinformationen speichern.

Interne Task-Wartung

RückgabetypAufrufformat und Beschreibung
int
(immer 0)
◆tf_setworkarea(char *workarea)
◆tf_isetworkarea(char *workarea, char *instance_p)
 Benutzerdatenzeiger im Arbeitsbereich speichern.
char *◆tf_getworkarea()
◆tf_igetworkarea(char *instance_p)
 Arbeitsbereichszeiger abrufen.

Andere Unterprogramme

RückgabetypAufrufformat und Beschreibung
int
(immer 0)
◆tf_dostop()
 Bewirkt, dass das Softwareprodukt in den interaktiven Modus wechselt.
int
(immer 0)
◆tf_dofinish()
 Ausführung des Softwareprodukts beenden.
char *◆mc_scan_plusargs(char *startarg)
 Die Aufruf-Befehlszeile des Softwareprodukts nach Plus-Optionen (+) durchsuchen.
int◆tf_write_save(char *blockptr, int blocklen)
 Einen Datenblock an eine Speicherdatei anhängen.
int◆tf_read_restart(char *blockptr, int blocklen)
 Holt einen Datenblock aus einer zuvor geschriebenen Sicherungsdatei.