Um den ursprünglichen Charakter der Unterprogramme zu bewahren und ein schlechtes Übersetzungsniveau zu vermeiden, behalten alle Unterprogramm-Listen ihre englischen Beschreibungen. Nicht alle Unterprogramme wurden hier verifiziert. Aufgrund von Versions- oder Transkriptionsproblemen kann es Auslassungen geben, und Korrekturen sind willkommen. Es wird empfohlen, beim Verwenden die entsprechende Art von Unterprogramm sorgfältig zu studieren und sich stärker an den Parametertypen und Einstellungen in anderen Beispielen zu orientieren.

ACC-Unterprogramme werden hauptsächlich in 5 Hauptkategorien unterteilt: handle, next, value change link (VCL), fetch, miscellaneous, modify.

Handle-Unterprogramme

RückgabetypAufrufformat und Beschreibung
handle◆acc_handle_by_name(char *name, handle scope)
 Handle für jedes benannte Objekt anhand seines Namens und Gültigkeitsbereichs abrufen
handle◆acc_handle_calling_mod_m()
 Handle für das Modul abrufen, das die Instanz der benutzerdefinierten Systemtask oder -funktion enthält, die die PLI-Anwendung aufgerufen hat.
handle◆acc_handle_condition(handle object)
 Handle für den Bedingungsausdruck eines Modulpfads, Datenpfads oder Timing-Check-Terminals abrufen
handle◆acc_handle_conn(handle terminal)
 Handle für das Netz abrufen, das mit einem Primitive-Terminal, Pfadterminal oder Timing-Check-Terminal verbunden ist.
handle◆acc_handle_datapath(handle modpath)
 Handle für einen Datenpfad für einen flankenempfindlichen Modulpfad abrufen.
handle◆acc_handle_hiconn(handle port)
 Die hierarchisch übergeordnete Netzverbindung zu einem skalaren Modulport oder einer Bitauswahl eines Vektorports abrufen.
handle◆acc_handle_interactive_scope()
 Holt ein Handle für den aktuellen interaktiven Gültigkeitsbereich des Softwarewerkzeugs.
handle◆acc_handle_loconn(handle port)
 Ruft die hierarchisch niedrigere Netzverbindung zu einem skalaren Modulport oder einem Bit-Select eines Vektorports ab.
handle◆acc_handle_modpath(handle module, char *source, char *dest, handle source, handle dest)
 Ruft ein Handle für einen Modulpfad ab, dessen Quelle angegeben ist.
handle◆acc_handle_notifier(handle tchk)
 Ruft das Notifier-Reg ab, das einem bestimmten Timing-Check zugeordnet ist.
handle◆acc_handle_object(char *name)
 Ruft ein Handle für ein beliebiges benanntes Objekt ab.
handle◆acc_handle_parent(handle object)
 Ruft ein Handle für die übergeordnete Primitiv-Instanz oder Modulinstanz eines Objekts ab.
handle◆acc_handle_path(handle output, handle input)
 Rufen Sie ein Handle für einen Intermodulpfad ab, der die Verbindung von einem Ausgangs- oder Inout-Port zu einem Eingangs- oder Inout-Port darstellt.
handle◆acc_handle_pathin(handle path)
 Rufen Sie ein Handle für das erste Netz ab, das mit einer Modulpfadquelle verbunden ist.
handle◆acc_handle_pathout(handle path)
 Rufen Sie ein Handle für das erste Netz ab, das mit einem Modulpfadziel verbunden ist.
handle◆acc_handle_port(handle module, int port_index)
 Rufen Sie ein Handle für einen Modulport basierend auf der Position des Ports ab.
handle◆acc_handle_scope(handle object)
 Rufen Sie ein Handle für den Scope ab, der ein Objekt enthält.
handle◆acc_handle_simulated_net(handle collapsed_net_handle)
 Rufen Sie das simulierte Netz ab, das dem als Argument übergebenen kollabierten Netz zugeordnet ist.
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)
 Ein Handle für die angegebene Timing-Prüfung eines Moduls (oder einer Zelle) abrufen.
handle◆acc_handle_tchkarg1(handle tchk)
 Ein Handle für den Timing-Check-Anschluss abrufen, der mit dem ersten Argument eines Timing-Checks verbunden ist.
handle◆acc_handle_tchkarg2(handle tchk)
 Ein Handle für den Timing-Check-Anschluss abrufen, der mit dem zweiten Argument eines Timing-Checks verbunden ist.
handle◆acc_handle_terminal(handle primitive, int terminal_index)
 Ein Handle für einen Primitiv-Anschluss basierend auf der Position des Primitiv-Anschlusses abrufen.
handle◆acc_handle_tfarg(int arg_num)
◆acc_handle_itfarg(int arg_num, handle instance)
 Ein Handle für das angegebene Argument einer benutzerdefinierten Systemaufgabe oder -funktion abrufen, die die PLI-Routine aufruft.
handle◆acc_handle_tfinst()
 Ein Handle für den aktuellen Aufruf einer benutzerdefinierten Systemaufgabe oder -funktion abrufen.

Nächste Unterprogramme

RückgabetypAufrufformat und Beschreibung
handle◆acc_next(int object_type_array, handle reference, handle object)
 Ruft Handles für Objekte jedes in einem Array angegebenen Typs innerhalb des Referenzbereichs ab.
handle◆acc_next_bit(handle reference, handle current_bit)
 Ruft Handles für Bits in einem Port oder erweiterten Vektor ab.
handle◆acc_next_cell(handle reference, hand current_cell)
 Ruft Handles für Zellinstanzen innerhalb eines Bereichs ab, der die gesamte Hierarchie unterhalb eines Moduls einschließt.
handle◆acc_next_cell_load(handle reference, hand current_cell_load)
 Ruft Handles für Zelllasten an einem Netz ab.
handle◆acc_next_child(handle reference, handle current_child)
 Ruft Handles für untergeordnete Elemente eines Moduls ab.
handle◆acc_next_driver(handle reference, handle current_driver)
 Ermittelt Handles für primitive Anschlüsse, die ein Netz treiben.
handle◆acc_next_hiconn(handle referenct, handle current_net)
 Ermittelt Handles für hierarchisch höhere Netzverbindungen zu einem Modulport.
handle◆acc_next_input (handle reference, handle current_terminal)
 Ermittelt Handles für Eingangspfadanschlüsse eines Modulpfads, Quellanschlüsse eines Datenpfads oder die Anschlüsse eines Timing-Checks.
handle◆acc_next_load(handle reference, handle current_load)
 Ermittelt Handles für primitive Anschlüsse, die von einem Netz getrieben werden.
handle◆acc_next_loconn(handle reference, handle current_net)
 Ermittelt Handles für hierarchisch niedrigere Netzverbindungen zu einem Port eines Moduls.
handle◆acc_next_modpath(handle reference, handle path)
 Ermittelt Handles für Modulpfade eines Moduls.
handle◆acc_next_net(handle reference, handle curretn_net)
 Handles für Netze in einem Modul abrufen.
handle◆acc_next_output(handle reference, handle current_terminal)
 Handles für Ausgangspfad-Terminals eines Modulpfads oder Datenpfads abrufen.
handle◆acc_next_parameter(handle reference, handle current_parameter)
 Handles für Parameter innerhalb eines Moduls abrufen.
handle◆acc_next_port(handle reference, handle current_port)
 Ruft Handles für die Ports eines Moduls ab, oder für Ports, die mit einem gegebenen Net oder Reg verbunden sind.
handle◆acc_next_portout(handle reference, handle current_port)
 Handles für Ausgangs- oder Inout-Ports eines Moduls abrufen.
handle◆acc_next_primitive(handle reference, handle current_primitive)
 Handles für Gatter, Switches oder benutzerdefinierte Primitive (UDPs) innerhalb eines Moduls abrufen.
handle◆acc_next_scope(handle reference, handle current_scope)
 Handles für Hierarchie-Geltungsbereiche innerhalb eines Geltungsbereichs abrufen.
handle◆acc_next_specparam(handle reference, handle current_specparam)
 Handles für specify-Block-Parameter innerhalb eines Moduls abrufen.
handle◆acc_next_tchk(handle reference, handle timing_check)
 Handles für Timing-Checks innerhalb eines Moduls abrufen.
handle◆acc_next_terminal(handle reference, handle terminal)
 Handles für Terminals eines Gatters, Schalters oder benutzerdefinierten Primitivs abrufen.
handle◆acc_next_topmod(handle top_module)
 Handles für Top-Level-Module abrufen.

Value-Change-Link-Unterprogramme

RückgabetypAufrufformat und Beschreibung
void◆acc_vcl_add(handle object, C_function unquoted name, char *user_data, int vcl_flag)
 Setzt einen Callback auf eine Consumer-Routine mit Wertänderungsinformationen, wann immer ein Objekt seinen Wert ändert.
consumer_routine() ist der nicht in Anführungszeichen gesetzte Name einer C-Funktion, die aufgerufen werden soll.
void◆acc_vcl_delete(handle object, C_function consumer_routine() , char *user_data, int vcl_flag)
 Entfernt einen VCL-Callback-Monitor.
consumer_routine() ist der nicht in Anführungszeichen gesetzte Name einer C-Funktion, die aufgerufen werden soll.

Abruf-Subroutinen

RückgabetypAufrufformat und Beschreibung
int◆acc_fetch_argc()
 Ruft die Anzahl der Kommandozeilenargumente ab, die bei einem Aufruf eines Verilog-Softwaretools übergeben werden.
char *◆acc_fetch_argv()
 Ruft ein Array von Zeichenzeigern ab, die die Kommandozeilenargumente für einen Aufruf eines Verilog-Softwareprodukts bilden.
double◆acc_fetch_attribute(handle object, char *attribute, double default)
 Ruft den Wert eines Parameters oder specparam ab, der als Attribut in der Verilog-Quellbeschreibung benannt ist.
int◆acc_fetch_attribute_int(handle object, char *attribute, int default)
 Ruft den Integer-Wert eines Parameters oder specparam ab, der als Attribut in der Verilog-Quellbeschreibung benannt ist.
char *◆acc_fetch_attribute_str(handle object, char *attribute, char *default)
 Ruft den Wert eines Parameters oder specparam ab, der als Attribut in der Verilog-Quellbeschreibung benannt ist.
char *◆acc_fetch_defname(handle object)
 Ermittelt den Definitionsnamen einer Modulinstanz oder Primitivinstanz.
int◆acc_fetch_delay_mode(handle module)
 Ermittelt den Verzögerungsmodus einer Modulinstanz.
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)
 Ermittelt vorhandene Verzögerungen für Primitive, Modulpfade, Timing-Checks, Moduleingangsports und Intermodulpfade.
int◆acc_fetch_direction(handle object)
 Ermittelt die Richtung eines Ports oder Terminals.
int◆acc_fetch_edge(handle pathio)
 Ermittelt den Flankenspezifizierer eines Modulpfads oder Timing-Check-Terminals.
char *◆acc_fetch_fullname(handle object)
 Liefert den vollständigen hierarchischen Namen eines beliebigen benannten Objekts oder Modulpfads.
int◆acc_fetch_fulltype(handle object)
 Liefert den Fulltype eines Objekts.
int◆acc_fetch_index(handle object)
 Liefert die Indexnummer für einen Port oder ein Terminal.
int◆acc_fetch_location(p_location loc_p, handle object)
 Liefert die Position eines Objekts in einer Verilog-HDL-Quelldatei.
p_location ist eine Datenstruktur, definiert in acc_user.h.
char *◆acc_fetch_name(handle object)
 Liefert den Instanznamen eines beliebigen benannten Objekts oder Modulpfads.
int◆acc_fetch_paramtype(handle parameter)
 Ermittelt den Datentyp eines Parameters oder specparam.
double◆acc_fetch_paramval(handle parameter)
 Ermittelt den Wert eines Parameters oder specparam.
int◆acc_fetch_polarity(handle path)
 Ermittelt die Polarität eines Pfads.
int◆acc_fetch_precision()
 Ermittelt das kleinste Zeitpräzisionsargument, das in allen `timescale-Compiler-Direktiven eines gegebenen Designs angegeben ist.
int◆acc_fetch_pulsere(handle object, double *r1, double *e1, double *r2, double *e2, ......, double *r12, double *e12)
 Ermittelt die aktuellen Werte für reject_limit und e_limit der Pulsbehandlung eines Modulpfads, Intermodulpfads oder Moduleingangsports.
int◆acc_fetch_range(handle vector, int *msb, int *lsb)
 Ermittelt die Bereichswerte des höchstwertigen Bits und des niederwertigsten Bits für einen Vektor.
int◆acc_fetch_size(handle object)
 Ermittelt die Bitgröße von net, reg, integer, time, real oder port.
double◆acc_fetch_tfarg(int arg_number)
◆acc_fetch_itfarg(int arg_number, handle tfinst)
 Ermittelt den Wert des angegebenen Arguments der Systemtask oder -funktion, die mit der PLI-Anwendung verknüpft ist; der Wert wird als Zahl mit doppelter Genauigkeit zurückgegeben.
int◆acc_fetch_tfarg_int(int arg_number)
◆acc_fetch_itfarg_int(int arg_number, handle tfinst)
 Ermittelt den Wert des angegebenen Arguments der Systemtask oder -funktion, die mit der PLI-Anwendung verknüpft ist; der Wert wird als Ganzzahl zurückgegeben.
char *◆acc_fetch_tfarg_str(int arg_number)
◆acc_fetch_itfarg_str(int arg_number, handle tfinst)
 Ermittelt den Wert des angegebenen Arguments der Systemtask oder -funktion, die mit der PLI-Anwendung verknüpft ist; der Wert wird als Zeiger auf eine Zeichenkette zurückgegeben.
void◆acc_fetch_timescale_info(handle object, p_timescale_info timescale_p)
 Ermittelt Zeitskaleninformationen für ein Objekt oder für einen aktiven Aufruf der Systemtask $timeformat.
p_timescale_info ist eine Datenstruktur, definiert in acc_user.h.
int◆acc_fetch_type(handle object)
 Ermittelt den Typ eines Objekts.
char *◆acc_fetch_type_str(int type)
 Ruft eine Zeichenkette ab, die den Typ ihres Arguments angibt.
char *◆acc_fetch_value(handle object, char *format, s_acc_value *value)
 Ruft den Logik- oder Stärkewert eines Netzes, Regs oder einer Variablen ab.
s_acc_value ist eine Datenstruktur, definiert in acc_user.h.

Verschiedene Unterprogramme

RückgabetypAufrufformat und Beschreibung
void◆acc_close()
 Gibt internen Speicher frei, der von ACC-Routinen verwendet wird; setzt alle Konfigurationsparameter auf Standardwerte zurück.
handle *◆acc_collect(handle *next_routine, handle object, int num_of_objects)
 Ein Array von Handles für alle Objekte abrufen, die mit einem bestimmten Referenzobjekt verknüpft sind; die Anzahl der gesammelten Objekte abrufen.
int◆acc_compare_handles(handle object1, handle object2)
 Ermitteln, ob zwei Handles auf dasselbe Objekt verweisen.
int◆acc_configure(int config_param, char *config_value)
 Parameter festlegen, die den Betrieb verschiedener ACC-Routinen steuern.
int◆acc_count(handle *next_routine, handle object)
 Die Anzahl der Objekte zählen, die mit einem bestimmten Referenzobjekt verknüpft sind.
int◆acc_initialize()
 Initialisiert die Umgebung für ACC-Routinen.
int◆acc_object_in_typelist(handle object, int object_type_array[])
 Ermitteln, ob ein Objekt zu einem Typ oder Fulltype oder einer speziellen Eigenschaft passt, wie in einem Eingabe-Array angegeben.
int◆acc_object_of_type(handle object, int object_type)
 Ermittelt, ob ein Objekt einem angegebenen Typ oder fulltype oder einer speziellen Eigenschaft entspricht.
int◆acc_product_type()
 Ruft den Softwareprodukttyp ab, der die PLI-Anwendung aufruft.
char *◆acc_product_version()
 Ruft die Version des Softwareprodukts ab, das mit den ACC-Routinen verknüpft ist.
int◆acc_release_object(handle object)
 Gibt Speicher frei, der durch Aufrufe von acc_next_input() und acc_next_output() zugewiesen wurde.
void◆acc_reset_buffer()
 Setzt den String-Puffer an den Anfang zurück.
handle◆acc_set_interactive_scope(handle scope, int callback_flag)
 Legt den interaktiven Bereich eines Software-Tools fest.
char*◆acc_set_scope(handle module, char *module_name)
 Legt einen Scope für acc_handle_object() fest, der bei der Suche in der Designhierarchie verwendet wird.
char *◆acc_version()
 Liefert einen Zeiger auf eine Zeichenkette, die die Versionsnummer der ACC-Routine-Software angibt.

Subroutinen ändern

RückgabetypAufrufformat und Beschreibung
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)
 Fügt Verzögerungen zu vorhandenen Verzögerungen an Primitiven, Modulpfaden, Intermodulpfaden, Timing-Prüfungen und Moduleingangsports hinzu.
int◆acc_append_pulsere(handle object, double *r1, double *e1, double *r2, double *e2, ......, double *r12, double *e12)
 Fügt Verzögerungen zu vorhandenen reject_limit und e_limit der Pulsbehandlung für einen Modulpfad, Intermodulpfad oder Moduleingangsport hinzu.
int◆acc_release_object(handle object)
 Gibt Speicher frei, der durch Aufrufe von acc_next_input() und acc_next_output() zugewiesen wurde.
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)
 Ersetzen Sie vorhandene Verzögerungen für Primitive, Modulpfade, Timing-Prüfungen, Moduleingangsports und Zwischenmodulpfade.
int◆acc_replace_pulsere(handle object, double *r1, double *e1, double *r2, double *e2, ......, double *r12, double *e12)
 Ersetzen Sie vorhandene Pulsbehandlungswerte reject_limit und e_limit für einen Modulpfad, Intermodulpfad oder Moduleingangsport.
int◆acc_set_pulsere(handle path, double reject_percentage, double e_percentage)
 Legen Sie die Pulsbehandlungswerte für einen Modulpfad, Intermodulpfad oder Moduleingangsport als Prozentsatz der Verzögerung fest.
int◆acc_set_value(handle object, p_setval_value value_p, p_setval_delay delay_p)
 Setzen und propagieren Sie einen Wert auf einem Reg, einer Variable, einer benutzerdefinierten Systemfunktion oder einem sequenziellen UDP; weisen Sie prozedural ein Reg oder eine Variable zu; erzwingen Sie ein Reg, eine Variable oder ein Netz.
p_setval_value und p_setval_delay sind Datenstrukturen, definiert in acc_user.h.

Strukturen

Das Folgende beschreibt einige der Strukturen, die für ACC-Unterprogramme entworfen wurden.

Beteiligte FunktionenStrukturen
acc_fetch_locationtypedef struct t_location
{
PLI_INT32 line_no;
PLI_BYTE8 *filename;
} s_location, *p_location;
p_timescale_infotypedef 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;
Vereinigung
{
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_valuetypedef struct t_setval_delay
{
s_acc_time time;
PLI_INT32 model;
} s_setval_delay, *p_setval_delay;