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 retour | Format 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 retour | Format 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 retour | Format 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 retour | Format 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 retour | Format 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 retour | Format 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 retour | Format 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 retour | Format 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 retour | Format 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 retour | Format 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. |