Pour préserver l'authenticité des sous-routines et éviter une mauvaise traduction, toutes les listes de sous-routines conservent leurs descriptions en anglais. Il est recommandé d'étudier attentivement les types de sous-routines correspondants avant de les utiliser. Toutes les sous-routines n'ont pas été vérifiées ici ; en raison de problèmes de version ou de transcription, il peut y avoir des omissions. Les corrections et commentaires sont les bienvenus.

Les sous-routines TF sont souvent utilisées pour le transfert bidirectionnel de données entre Verilog et les sous-routines C utilisateur. Lorsqu'une sous-routine préfixée par tf_ a une sous-routine correspondante préfixée par tf_i, le pointeur d'instance sur lequel les opérations se produisent dans la sous-routine correspondante préfixée par tf_i doit être passé comme variable supplémentaire à la fin de la liste de variables.

Les sous-programmes TF n'ont pas de marqueurs de classification explicites dans leurs conventions de nommage. Voici un simple résumé.

Obtenir des informations sur les tâches et les fonctions

Type de retourFormat d'appel et description
char *◆tf_getinstance()
 Obtenir un pointeur vers l'instance actuelle d'une tâche ou fonction système définie par l'utilisateur.
char *◆tf_mipname()
◆tf_imipname(char *instance_p)
 Obtenir le nom de chemin hiérarchique de l'instance de module sous forme de chaîne.
char *◆tf_spname()
◆tf_ispname(char *instance_p)
 Obtenir le nom de chemin hiérarchique de la portée sous forme de chaîne.

Obtenir des informations sur la liste des variables

Type de retourFormat d'appel et description
int◆tf_nump()
◆tf_inump(char *instance_p)
 Obtenir le nombre d’arguments d’une tâche ou d’une fonction.
int◆tf_typep(int narg)
◆tf_itypep(int narg, char *instance_p)
 Obtenir le type d’argument d’une tâche/fonction système.
int◆tf_sizep(narg)
◆tf_isizep(int narg, char *instance_p)
 Obtenir la longueur en bits d’un argument de tâche/fonction système.
t_tfexprinfo *◆tf_exprinfo(int narg, t_tfexprinfo *exprinfo_p)
◆tf_iexprinfo(int narg, t_tfexprinfo *exprinfo_p, char *instance_p)
 Obtenir les informations d'expression d'argument de tâche/fonction système.
t_tfexprinfo est une structure de données, définie dans veriuser.h.
t_tfnodeinfo *◆tf_nodeinfo(int narg, t_tfnodeinfo *nodeinfo_p)
◆tf_inodeinfo(int narg, t_tfnodeinfo *nodeinfo_p, char *instance_p)
 Obtenir les informations de nœud d'argument de tâche/fonction système.
t_tfnodeinfo est une structure de données, définie dans veriuser.h.

Obtenir la valeur du paramètre

Type de retourFormat d'appel et description
int◆tf_getp(int narg)
◆tf_igetp(int narg, char *instance_p)
 Obtenir la valeur d'un argument de tâche/fonction système sous forme d'entier ou de pointeur de chaîne de caractères
double◆tf_getrealp(int narg)
◆tf_igetrealp(int narg, char *instance_p)
 Obtenir la valeur d’un argument de tâche/fonction système sous forme de valeur à double précision.
int◆tf_getlongp(int *aof_highvalue, int narg)
◆tf_igetlongp(int *aof_highvalue, int narg, char *instance_p)
 Obtenir la valeur d’un argument de tâche/fonction système sous forme d’entier 64 bits.
char *◆tf_strgetp(int narg, int format)
◆tf_istrgetp(int narg, int format, char *instance_p)
 Obtenir les valeurs formatées des arguments de tâche/fonction système.
char *◆tf_getcstringp(int narg)
◆tf_igetcstringp(int narg, char *instance_p)
 Obtenir la valeur d’un argument de tâche/fonction système sous forme de chaîne de caractères.
int◆tf_evaluatep(int narg)
◆tf_ievaluatep(int narg, char *instance_p)
 Évaluer une expression d'argument de tâche/fonction système.

Définir la valeur du paramètre

Type de retourFormat d'appel et description
int◆tf_putp(int narg, int value)
◆tf_iputp(int narg, int value, char *instance_p)
 Placer une valeur entière dans un argument de tâche/fonction système ou dans un retour de fonction.
int◆tf_putrealp(int narg, double value)
◆tf_iputrealp(int narg, double value, char *instance_p)
 Écrire une valeur réelle dans un argument de tâche/fonction système ou dans un retour de fonction.
int◆tf_putlongp(int narg, int lowvalue, int highvalue)
◆tf_iputlongp(int narg, int lowvalue, int highvalue, char *instance_p)
 Écrire une valeur entière de 64 bits dans un argument de tâche/fonction système ou dans un retour de fonction.
int◆tf_propagatep(int narg)
◆tf_ipropagatep(int narg, char *instance_p)
 Propager la valeur d’un argument de tâche/fonction système.
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)
 Écrire une valeur dans un argument de tâche/fonction système à partir d’une spécification de valeur sous forme de chaîne, en utilisant un délai entier 32 bits.
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)
 Écrire une valeur dans un argument de tâche/fonction système à partir d’une spécification de valeur sous forme de chaîne, en utilisant un délai réel.
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)
 Écrire une valeur dans un argument de tâche/fonction système à partir d’une spécification de valeur sous forme de chaîne, en utilisant un délai entier 64 bits.

Surveiller les modifications de valeur des paramètres

Type de retourFormat d'appel et description
int◆tf_asynchon()
◆tf_iasynchon(char *instance_p)
 Activer l'appel asynchrone de l'application misctf pour les modifications de valeur des arguments de tâche/fonction système.
int
(toujours 0)
◆tf_asynchoff()
◆tf_iasynchoff(char *instance_p)
 Désactiver l'appel asynchrone de l'application misctf.
int◆tf_synchronize()
◆tf_isynchronize(char *instance_p)
 Synchroniser jusqu'à la fin du pas de temps de simulation.
int◆tf_rosynchronize()
◆tf_irosynchronize(char *instance_p)
 Synchroniser jusqu'à la fin du pas de temps de simulation.
int◆tf_getpchange(int narg)
◆tf_igetpchange(int narg, char *instance_p)
 Obtenir le numéro d'index du prochain argument de tâche/fonction système dont la valeur a changé.
int◆tf_copypvc_flag(int narg)
◆tf_icopypvc_flag(int narg, char *instance_p)
 Copier les indicateurs de changement de valeur des arguments de tâche/fonction système.
int◆tf_movepvc_flag(int narg)
◆tf_imovepvc_flag(int narg, char *instance_p)
 Déplacer les indicateurs de changement de valeur des arguments de tâche/fonction système.
int◆tf_testpvc_flag(int narg)
◆tf_itestpvc_flag(int narg, char *instance_p)
 Indicateurs de changement de valeur d'argument de tâche/fonction du système de test.

Synchronisation des tâches

Type de retourFormat d'appel et description
int◆tf_gettime()
◆tf_igettime(char *instance_p)
 Obtenir le temps de simulation actuel sous forme d'un entier 32 bits.
double◆tf_getrealtime()
◆tf_igetrealtime(char *instance_p)
 Obtenir le temps de simulation actuel au format double précision.
int◆tf_getlongtime(int *aof_hightime)
◆tf_igetlongtime(int *aof_hightime, char *instance_p)
 Obtenir le temps de simulation actuel sous forme d'un entier 64 bits.
Retourner les 32 bits les moins significatifs (les plus à droite) du temps de simulation
char *◆tf_strgettime()
 Obtenir le temps de simulation actuel sous forme de chaîne.
int◆tf_getnextlongtime(int *aof_lowtime, int *aof_hightime)
 Obtenir le prochain instant auquel un événement de simulation est planifié
int◆tf_gettimeprecision()
◆tf_igettimeprecision(char *instance_p)
 Obtenir la précision de l'échelle de temps d'un module ou d'une simulation.
int◆tf_gettimeunit()
◆tf_igettimeunit(char *instance_p)
 Obtenir l'unité d'échelle de temps d'un module ou d'une simulation.
int◆tf_setdelay(int delay)
◆tf_isetdelay(int delay, char *instance_p)
 Activer l'application misctf à un instant de simulation donné.
int◆tf_setlongdelay(int lowdelay, int highdelay)
◆tf_isetlongdelay(int lowdelay, int highdelay, char *instance_p)
 Activer l'application misctf à un instant de simulation donné.
int◆tf_setrealdelay(double realdelay)
◆tf_isetrealdelay(double realdelay, char *instance_p)
 Activer l'application misctf à un instant de simulation donné.
void◆tf_scale_longdelay(char *instance_p, int delay_lo, int delay_hi, int *aof_delay_lo, int *aof_delay_hi)
 Convertir un délai entier de 64 bits vers l'échelle de temps de l'instance de module.
void◆tf_scale_realdelay(char *instance_p, double realdelay, double *aof_realdelay)
 Convertir un délai à virgule flottante en double précision vers l'échelle de temps de l'instance de module.
void◆tf_unscale_longdelay(char *instance_p, int delay_lo, int delay_hi, int *aof_delay_lo, int *aof_delay_hi)
 Convertir un délai des unités de temps de simulation internes vers l'échelle de temps d'un module particulier.
void◆tf_unscale_realdelay(char *instance_p, double realdelay, double *aof_realdelay)
 Convertit un délai exprimé en unités de temps de simulation internes vers l'échelle de temps d'un module particulier.
int◆tf_clearalldelays()
◆tf_iclearalldelays(char *instance_p)
 Efface toutes les réactivations planifiées par tf_setdelay() ou tf_isetdelay().

Opérations arithmétiques

Type de retourFormat d'appel et description
int
(toujours 0)
◆tf_add_long(int *aof_low1, int *aof_high1, int low2, int high2)
 Additionne deux entiers de 64 bits.
int
(toujours 0)
◆tf_subtract_long(int *aof_low1, int *aof_high1, int low2, int high2)
 Soustrait deux entiers de 64 bits.
void◆tf_multiply_long(int *aof_low1, int *aof_high1, int low2, int high2)
 Multiplie deux entiers de 64 bits.
void◆tf_divide_long(int *aof_low1, int *aof_high1, int low2, int high2)
 Divise deux entiers de 64 bits.
int◆tf_compare_long(int low1, int high1, int low2, int high2)
 Comparer deux valeurs entières de 64 bits.
char *◆tf_longtime_tostr(int lowtime, int hightime)
 Convertir une valeur temporelle entière de 64 bits en chaîne de caractères.
void◆tf_real_to_long(double realvalue, int *aof_low, int *aof_high)
 Convertir un nombre réel en entier de 64 bits.
void◆tf_long_to_real(int low, int high, double *aof_real)
 Convertir un entier de 64 bits en nombre réel.

Afficher les informations

Type de retourFormat d'appel et description
void◆io_printf(char *format, arg1, ..., arg12)
 Imprimer un message formaté vers le canal de sortie du produit logiciel qui a invoqué l'application PLI et vers le fichier journal du produit.
void◆io_mcdprintf(int mcd, char *format, arg1, ..., arg12)
 Écrire un message formaté dans un ou plusieurs fichiers.
int
(toujours 0)
◆tf_error(char *format, arg1,..., arg5)
 Signaler un message d'erreur.
int
(toujours 0)
◆tf_warning(char *format, arg1, ..., arg5)
 Signaler un message d'avertissement.
int
(toujours 0)
◆tf_message(int level, char *facility, char *code, char *message, arg1,..., arg5)
 Signaler un message d'erreur ou d'avertissement avec contrôle d'interruption du produit logiciel.
int
(toujours 0)
◆tf_text(char *message, arg1,..., arg5)
 Stocker les informations de message d'erreur.

Maintenance interne des tâches

Type de retourFormat d'appel et description
int
(toujours 0)
◆tf_setworkarea(char *workarea)
◆tf_isetworkarea(char *workarea, char *instance_p)
 Stocker le pointeur de données utilisateur dans la zone de travail.
char *◆tf_getworkarea()
◆tf_igetworkarea(char *instance_p)
 Obtenir le pointeur de la zone de travail.

Autres sous-programmes

Type de retourFormat d'appel et description
int
(toujours 0)
◆tf_dostop()
 Faire entrer le produit logiciel en mode interactif.
int
(toujours 0)
◆tf_dofinish()
 Quitter l'exécution du produit logiciel.
char *◆mc_scan_plusargs(char *startarg)
 Analyser la ligne de commande d'invocation du produit logiciel à la recherche des options plus (+).
int◆tf_write_save(char *blockptr, int blocklen)
 Ajouter un bloc de données à la fin d'un fichier de sauvegarde.
int◆tf_read_restart(char *blockptr, int blocklen)
 Obtenir un bloc de données à partir d'un fichier de sauvegarde précédemment écrit.