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ückgabetyp | Aufrufformat 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ückgabetyp | Aufrufformat 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ückgabetyp | Aufrufformat 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ückgabetyp | Aufrufformat 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ückgabetyp | Aufrufformat 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ückgabetyp | Aufrufformat 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ückgabetyp | Aufrufformat 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ückgabetyp | Aufrufformat 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ückgabetyp | Aufrufformat 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ückgabetyp | Aufrufformat 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. |