Pour préserver le goût original des sous-programmes et éviter un niveau de traduction médiocre, toutes les listes de sous-programmes conservent leurs descriptions en anglais. Tous les sous-programmes n'ont pas été vérifiés ici. En raison de problèmes de version ou de transcription, il peut y avoir des omissions, et les corrections sont les bienvenues. Il est recommandé d'étudier attentivement le type de sous-programme correspondant lors de leur utilisation, et de se référer davantage aux types de paramètres et aux réglages dans d'autres exemples.
Les sous-programmes ACC sont principalement divisés en 5 grandes catégories : handle, next, value change link (VCL), fetch, miscellaneous, modify.
Sous-programmes Handle
| Type de retour | Format d'appel et description |
|---|---|
| handle | ◆acc_handle_by_name(char *name, handle scope) |
| Obtenir le handle de tout objet nommé en fonction de son nom et de sa portée | |
| handle | ◆acc_handle_calling_mod_m() |
| Obtenir un handle du module contenant l'instance de la tâche ou fonction système définie par l'utilisateur qui a appelé l'application PLI. | |
| handle | ◆acc_handle_condition(handle object) |
| Obtenir un handle de l'expression conditionnelle d'un chemin de module, d'un chemin de données ou d'une borne de contrôle de temporisation | |
| handle | ◆acc_handle_conn(handle terminal) |
| Obtenir le handle du net connecté à une borne primitive, une borne de chemin ou une borne de contrôle de temporisation. | |
| handle | ◆acc_handle_datapath(handle modpath) |
| Obtenir un handle d'un chemin de données pour un chemin de module sensible aux fronts. | |
| handle | ◆acc_handle_hiconn(handle port) |
| Obtenir la connexion de net hiérarchiquement supérieure à un port de module scalaire ou à une sélection de bit d'un port vectoriel. | |
| handle | ◆acc_handle_interactive_scope() |
| Obtenir un handle sur la portée interactive actuelle de l'outil logiciel. | |
| handle | ◆acc_handle_loconn(handle port) |
| Obtient la connexion net hiérarchiquement inférieure vers un port de module scalaire ou une sélection de bit d’un port vectoriel. | |
| handle | ◆acc_handle_modpath(handle module, char *src, char *dest, handle source, handle dest) |
| Obtient un handle vers un chemin de module dont la source est spécifiée. | |
| handle | ◆acc_handle_notifier(handle tchk) |
| Obtenir le reg notifier associé à une vérification de timing particulière. | |
| handle | ◆acc_handle_object(char *name) |
| Obtenir un handle pour tout objet nommé. | |
| handle | ◆acc_handle_parent(handle object) |
| Obtenir un handle pour l'instance de primitive parente ou l'instance de module parente d'un objet. | |
| handle | ◆acc_handle_path(handle output, handle input) |
| Obtenir un handle vers un chemin inter-module qui représente la connexion d'un port de sortie ou inout à un port d'entrée ou inout. | |
| handle | ◆acc_handle_pathin(handle path) |
| Obtenir un handle pour le premier net connecté à une source de chemin de module. | |
| handle | ◆acc_handle_pathout(handle path) |
| Obtenir un handle pour le premier net connecté à une destination de chemin de module. | |
| handle | ◆acc_handle_port(handle module, int port_index) |
| Obtenir un handle pour un port de module, en fonction de la position du port. | |
| handle | ◆acc_handle_scope(handle object) |
| Obtenir un handle vers la portée qui contient un objet. | |
| handle | ◆acc_handle_simulated_net(handle collapsed_net_handle) |
| Obtenir le net simulé associé au net réduit passé en argument. | |
| handle | ◆acc_handle_tchk(handle module, int tchk_type, char *conn_name1, int edge_type1, char *conn_name2, int edge_type2, handle conn_name1_handle, handle conn_name2_handle) |
| Obtenir un handle pour la vérification de temporisation spécifiée d’un module (ou d’une cellule). | |
| handle | ◆acc_handle_tchkarg1(handle tchk) |
| Obtenir un handle pour le terminal de vérification de temporisation connecté au premier argument d’une vérification de temporisation. | |
| handle | ◆acc_handle_tchkarg2(handle tchk) |
| Obtenir un handle pour le terminal de vérification de temporisation connecté au deuxième argument d’une vérification de temporisation. | |
| handle | ◆acc_handle_terminal(handle primitive, int terminal_index) |
| Obtenir un handle pour un terminal primitif en fonction de la position du terminal primitif. | |
| handle | ◆acc_handle_tfarg(int arg_num) ◆acc_handle_itfarg(int arg_num, handle instance) |
| Obtenir un handle pour l’argument spécifié d’une tâche ou fonction système définie par l’utilisateur qui invoque la routine PLI. | |
| handle | ◆acc_handle_tfinst() |
| Obtenir un handle sur l’appel en cours à une tâche ou fonction système définie par l’utilisateur. |
Sous-programmes suivants
| Type de retour | Format d'appel et description |
|---|---|
| handle | ◆acc_next(int object_type_array, handle reference, handle object) |
| Obtenir des handles vers des objets de chaque type spécifié dans un tableau dans la portée de référence. | |
| handle | ◆acc_next_bit(handle reference, handle current_bit) |
| Obtenir des handles vers des bits dans un port ou un vecteur étendu. | |
| handle | ◆acc_next_cell(handle reference, hand current_cell) |
| Obtenir des handles vers des instances de cellule dans une région qui inclut toute la hiérarchie sous un module. | |
| handle | ◆acc_next_cell_load(handle reference, hand current_cell_load) |
| Obtenir des handles pour les charges de cellule sur un net. | |
| handle | ◆acc_next_child(handle reference, handle current_child) |
| Obtenir des handles pour les enfants d'un module. | |
| handle | ◆acc_next_driver(handle reference, handle current_driver) |
| Obtenir des handles vers les terminaux primitifs qui pilotent un net. | |
| handle | ◆acc_next_hiconn(handle referenct, handle current_net) |
| Obtenir des handles pour les connexions de net hiérarchiquement supérieures à un port de module. | |
| handle | ◆acc_next_input (handle reference, handle current_terminal) |
| Obtenir des handles vers les terminaux de chemin d'entrée d'un chemin de module, les terminaux source d'un chemin de données, ou les terminaux d'une vérification temporelle. | |
| handle | ◆acc_next_load(handle reference, handle current_load) |
| Obtenir des handles vers les terminaux primitifs pilotés par un net. | |
| handle | ◆acc_next_loconn(handle reference, handle current_net) |
| Obtenir des handles vers les connexions de net hiérarchiquement inférieures à un port d'un module. | |
| handle | ◆acc_next_modpath(handle reference, handle path) |
| Obtenir des handles vers les chemins de module d'un module. | |
| handle | ◆acc_next_net(handle reference, handle curretn_net) |
| Obtenir des handles vers les nets dans un module. | |
| handle | ◆acc_next_output(handle reference, handle current_terminal) |
| Obtenir des handles vers les terminaux de chemin de sortie d’un chemin de module ou d’un chemin de données. | |
| handle | ◆acc_next_parameter(handle reference, handle current_parameter) |
| Obtenir des handles vers les paramètres dans un module. | |
| handle | ◆acc_next_port(handle reference, handle current_port) |
| Obtient des handles vers les ports d’un module, ou vers les ports qui sont connectés à un net ou reg donné. | |
| handle | ◆acc_next_portout(handle reference, handle current_port) |
| Obtenir des handles vers les ports de sortie ou inout d’un module. | |
| handle | ◆acc_next_primitive(handle reference, handle current_primitive) |
| Obtenir des handles vers les portes, les commutateurs ou les primitives définies par l’utilisateur (UDPs) dans un module. | |
| handle | ◆acc_next_scope(handle reference, handle current_scope) |
| Obtenir les handles des scopes hiérarchiques dans un scope. | |
| handle | ◆acc_next_specparam(handle reference, handle current_specparam) |
| Obtenir les handles des paramètres de bloc specify dans un module. | |
| handle | ◆acc_next_tchk(handle reference, handle timing_check) |
| Obtenir les handles des vérifications de temporisation dans un module. | |
| handle | ◆acc_next_terminal(handle reference, handle terminal) |
| Obtenir les handles des terminaux d'une porte, d'un commutateur ou d'une primitive définie par l'utilisateur. | |
| handle | ◆acc_next_topmod(handle top_module) |
| Obtenir les handles des modules de niveau supérieur. |
Sous-programmes de liaison de changement de valeur
| Type de retour | Format d'appel et description |
|---|---|
| void | ◆acc_vcl_add(handle object, C_function unquoted name, char *user_data, int vcl_flag) |
| Définir un callback vers une routine consommatrice avec des informations de changement de valeur chaque fois qu'un objet change de valeur. consumer_routine() est le nom sans guillemets d'une fonction C à appeler. | |
| void | ◆acc_vcl_delete(handle object, C_function consumer_routine() , char *user_data, int vcl_flag) |
| Supprime un moniteur de rappel VCL. consumer_routine() est le nom sans guillemets d'une fonction C à appeler. |
Sous-routines de récupération
| Type de retour | Format d'appel et description |
|---|---|
| int | ◆acc_fetch_argc() |
| Obtenir le nombre d'arguments de ligne de commande fournis lors de l'invocation d'un outil logiciel Verilog. | |
| char * | ◆acc_fetch_argv() |
| Obtenir un tableau de pointeurs de caractères qui constituent les arguments de ligne de commande pour l'invocation d'un produit logiciel Verilog. | |
| double | ◆acc_fetch_attribute(handle object, char *attribute, double default) |
| Obtenir la valeur d'un paramètre ou specparam nommé en tant qu'attribut dans la description source Verilog. | |
| int | ◆acc_fetch_attribute_int(handle object, char *attribute, int default) |
| Obtenir la valeur entière d'un paramètre ou specparam nommé en tant qu'attribut dans la description source Verilog. | |
| char * | ◆acc_fetch_attribute_str(handle object, char *attribute, char *default) |
| Obtenir la valeur d'un paramètre ou specparam nommé en tant qu'attribut dans la description source Verilog. | |
| char * | ◆acc_fetch_defname(handle object) |
| Obtenir le nom de définition d'une instance de module ou d'une instance de primitive. | |
| int | ◆acc_fetch_delay_mode(handle module) |
| Obtenir le mode de délai d'une instance de module. | |
| int | ◆acc_fetch_delays(handle object, double *rise_delay, double *fall_delay, double *trunoff_delay) ◆acc_fetch_delays(handle object, double *rise_delay, double *d1, d2, d3, d4, d5, d6, d7, d8, d9, d10, d11, d12) |
| Obtenir les délais existants pour les primitives, les chemins de module, les contrôles de temporisation, les ports d'entrée de module et les chemins intermodules. | |
| int | ◆acc_fetch_direction(handle object) |
| Obtenir la direction d'un port ou d'un terminal | |
| int | ◆acc_fetch_edge(handle pathio) |
| Obtenir le spécificateur de front d'un chemin de module ou d'un terminal de contrôle de temporisation. | |
| char * | ◆acc_fetch_fullname(handle object) |
| Obtenir le nom hiérarchique complet de tout objet nommé ou chemin de module. | |
| int | ◆acc_fetch_fulltype(handle object) |
| Obtenir le type complet d'un objet. | |
| int | ◆acc_fetch_index(handle object) |
| Obtenir le numéro d'index d'un port ou d'un terminal. | |
| int | ◆acc_fetch_location(p_location loc_p, handle object) |
| Obtenir l'emplacement d'un objet dans un fichier source Verilog-HDL. p_location est une structure de données, définie dans acc_user.h. | |
| char * | ◆acc_fetch_name(handle object) |
| Obtenir le nom d'instance de tout objet nommé ou chemin de module. | |
| int | ◆acc_fetch_paramtype(handle parameter) |
| Obtenir le type de données d'un paramètre ou specparam. | |
| double | ◆acc_fetch_paramval(handle parameter) |
| Obtenir la valeur d'un paramètre ou specparam. | |
| int | ◆acc_fetch_polarity(handle path) |
| Obtenir la polarité d'un chemin. | |
| int | ◆acc_fetch_precision() |
| Obtenir le plus petit argument de précision temporelle spécifié dans toutes les directives du compilateur `timescale d'une conception donnée. | |
| int | ◆acc_fetch_pulsere(handle object, double *r1, double *e1, double *r2, double *e2, ......, double *r12, double *e12) |
| Obtenir les reject_limit et e_limit actuels de gestion des impulsions pour un chemin de module, un chemin inter-module ou un port d'entrée de module. | |
| int | ◆acc_fetch_range(handle vector, int *msb, int *lsb) |
| Obtenir les valeurs de plage du bit le plus significatif et du bit le moins significatif pour un vecteur. | |
| int | ◆acc_fetch_size(handle object) |
| Obtenir la taille en bits d'un net, reg, integer, time, real ou port. | |
| double | ◆acc_fetch_tfarg(int arg_number) ◆acc_fetch_itfarg(int arg_number, handle tfinst) |
| Obtenir la valeur de l'argument spécifié de la tâche ou fonction système associée à l'application PLI ; la valeur est renvoyée sous forme de nombre à double précision. | |
| int | ◆acc_fetch_tfarg_int(int arg_number) ◆acc_fetch_itfarg_int(int arg_number, handle tfinst) |
| Obtenir la valeur de l'argument spécifié de la tâche ou fonction système associée à l'application PLI ; la valeur est renvoyée sous forme de nombre entier. | |
| char * | ◆acc_fetch_tfarg_str(int arg_number) ◆acc_fetch_itfarg_str(int arg_number, handle tfinst) |
| Obtenir la valeur de l'argument spécifié de la tâche ou fonction système associée à l'application PLI ; la valeur est renvoyée sous forme de pointeur vers une chaîne de caractères. | |
| void | ◆acc_fetch_timescale_info(handle object, p_timescale_info timescale_p) |
| Obtenir les informations sur l'échelle de temps pour un objet ou pour une invocation active de la tâche système $timeformat. p_timescale_info est une structure de données, définie dans acc_user.h. | |
| int | ◆acc_fetch_type(handle object) |
| Obtenir le type d’un objet. | |
| char * | ◆acc_fetch_type_str(int type) |
| Obtenir une chaîne qui indique le type de son argument. | |
| char * | ◆acc_fetch_value(handle object, char *format, s_acc_value *value) |
| Obtenir la valeur logique ou de force d’un net, reg ou variable s_acc_value est une structure de données, définie dans acc_user.h. |
Sous-programmes divers
| Type de retour | Format d'appel et description |
|---|---|
| void | ◆acc_close() |
| Libérer la mémoire interne utilisée par les routines ACC ; réinitialiser tous les paramètres de configuration aux valeurs par défaut. | |
| handle * | ◆acc_collect(handle *next_routine, handle object, int num_of_objects) |
| Obtenir un tableau de handles pour tous les objets liés à un objet de référence particulier ; obtenir le nombre d’objets collectés. | |
| int | ◆acc_compare_handles(handle object1, handle object2) |
| Déterminer si deux handles font référence au même objet. | |
| int | ◆acc_configure(int config_param, char *config_value) |
| Définir les paramètres qui contrôlent le fonctionnement de diverses routines ACC. | |
| int | ◆acc_count(handle *next_routine, handle object) |
| Compter le nombre d’objets liés à un objet de référence particulier. | |
| int | ◆acc_initialize() |
| Initialise l’environnement pour les routines ACC. | |
| int | ◆acc_object_in_typelist(handle object, int object_type_array[]) |
| Déterminer si un objet correspond à un type ou fulltype, ou à une propriété spéciale, comme spécifié dans un tableau d’entrée. | |
| int | ◆acc_object_of_type(handle object, int object_type) |
| Détermine si un objet correspond à un type spécifié ou à un fulltype, ou à une propriété spéciale. | |
| int | ◆acc_product_type() |
| Obtient le type de produit logiciel qui appelle l'application PLI. | |
| char * | ◆acc_product_version() |
| Obtient la version du produit logiciel qui est lié aux routines ACC. | |
| int | ◆acc_release_object(handle object) |
| Désalloue la mémoire allouée par les appels à acc_next_input() et acc_next_output(). | |
| void | ◆acc_reset_buffer() |
| Réinitialise le tampon de chaîne au début. | |
| handle | ◆acc_set_interactive_scope(handle scope, int callback_flag) |
| Définit la portée interactive d'un outil logiciel. | |
| char* | ◆acc_set_scope(handle module, char *module_name) |
| Définit une portée que acc_handle_object() doit utiliser lors de la recherche dans la hiérarchie de conception. | |
| char * | ◆acc_version() |
| Obtient un pointeur vers une chaîne de caractères indiquant le numéro de version du logiciel de routine ACC. |
Modifier les sous-programmes
| Type de retour | Format d'appel et description |
|---|---|
| int | ◆acc_append_delays(handle object, double *rise_delay, double *fall_delay, double *trunoff_delay) ◆acc_append_delays(handle object, double *d1, d2, d3, d4, d5, d6, d7, d8, d9, d10, d11, d12) ◆acc_append_delays(handle object, double limit) |
| Ajoute des délais au délai existant sur les primitives, les chemins de module, les chemins intermodules, les contrôles de temporisation et les ports d'entrée de module. | |
| int | ◆acc_append_pulsere(handle object, double *r1, double *e1, double *r2, double *e2, ......, double *r12, double *e12) |
| Ajoute des délais aux reject_limit et e_limit existants de gestion d'impulsions pour un chemin de module, un chemin intermodule ou un port d'entrée de module. | |
| int | ◆acc_release_object(handle object) |
| Désalloue la mémoire allouée par les appels à acc_next_input() et acc_next_output(). | |
| int | ◆acc_replace_delays(handle object, double *rise_delay, double *fall_delay, double *trunoff_delay) ◆acc_replace_delays(handle object, double *d1, d2, d3, d4, d5, d6, d7, d8, d9, d10, d11, d12) ◆acc_replace_delays(handle object, double limit) |
| Remplacer les délais existants pour les primitives, les chemins de module, les contrôles de temporisation, les ports d'entrée de module et les chemins inter-modules. | |
| int | ◆acc_replace_pulsere(handle object, double *r1, double *e1, double *r2, double *e2, ......, double *r12, double *e12) |
| Remplacer les valeurs existantes reject_limit et e_limit de gestion des impulsions pour un chemin de module, un chemin inter-module ou un port d'entrée de module. | |
| int | ◆acc_set_pulsere(handle path, double reject_percentage, double e_percentage) |
| Définir les valeurs de gestion des impulsions pour un chemin de module, un chemin inter-module ou un port d'entrée de module sous forme de pourcentage du délai. | |
| int | ◆acc_set_value(handle object, p_setval_value value_p, p_setval_delay delay_p) |
| Définir et propager une valeur sur un reg, une variable, une fonction système définie par l'utilisateur ou un UDP séquentiel ; affecter de manière procédurale un reg ou une variable ; forcer un reg, une variable ou un net. p_setval_value et p_setval_delay sont des structures de données, définies dans acc_user.h. |
Structures
Ce qui suit décrit certaines des structures conçues pour les sous-programmes ACC.
| Fonctions concernées | Structures |
|---|---|
| acc_fetch_location | typedef struct t_location { PLI_INT32 line_no; PLI_BYTE8 *filename; } s_location, *p_location; |
| p_timescale_info | typedef struct t_timescale_info { PLI_INT16 unit; PLI_INT16 precision; } s_timescale_info, *p_timescale_info; |
| acc_fetch_value acc_set_value | typedef struct t_setval_value { PLI_INT32 format; union { PLI_BYTE8 *str; PLI_INT32 scalar; PLI_INT32 integer; double real; p_acc_vecval vector; } value; } s_setval_value, *p_setval_value, s_acc_value, *p_acc_value; |
| acc_set_value | typedef struct t_setval_delay { s_acc_time time; PLI_INT32 model; } s_setval_delay, *p_setval_delay; |