Чтобы сохранить оригинальный колорит подпрограмм и избежать низкого уровня перевода, все списки подпрограмм сохраняют свои английские описания. Не все подпрограммы были здесь проверены. Из-за проблем с версией или переписыванием могут быть пропуски; исправления приветствуются. При их использовании рекомендуется внимательно изучить соответствующий тип подпрограммы и чаще обращаться к типам параметров и настройкам в других примерах.

ACC-подпрограммы в основном делятся на 5 основных категорий: handle, next, value change link (VCL), fetch, miscellaneous, modify.

Подпрограммы Handle

Тип возвращаемого значенияФормат вызова и описание
handle◆acc_handle_by_name(char *name, handle scope)
 Получить дескриптор любого именованного объекта по его имени и области видимости
handle◆acc_handle_calling_mod_m()
 Получить дескриптор модуля, содержащего экземпляр определяемой пользователем системной задачи или функции, которая вызвала приложение PLI.
handle◆acc_handle_condition(handle object)
 Получить дескриптор условного выражения пути модуля, пути данных или терминала проверки временных соотношений
handle◆acc_handle_conn(handle terminal)
 Получить дескриптор цепи, подключённой к терминалу примитива, терминалу пути или терминалу проверки временных соотношений.
handle◆acc_handle_datapath(handle modpath)
 Получить дескриптор пути данных для чувствительного к фронту пути модуля.
handle◆acc_handle_hiconn(handle port)
 Получить иерархически более высокое соединение цепи со скалярным портом модуля или битовой выборкой векторного порта.
handle◆acc_handle_interactive_scope()
 Получить дескриптор текущей интерактивной области видимости программного инструмента.
handle◆acc_handle_loconn(handle port)
 Получает иерархически более низкое соединение цепи к скалярному порту модуля или к битовой выборке векторного порта.
handle◆acc_handle_modpath(handle module, char *source, char *dest, handle source, handle dest)
 Получает дескриптор пути модуля, источник которого указан.
handle◆acc_handle_notifier(handle tchk)
 Получить регистр-уведомитель, связанный с конкретной проверкой временных соотношений.
handle◆acc_handle_object(char *name)
 Получить дескриптор любого именованного объекта.
handle◆acc_handle_parent(handle object)
 Получить дескриптор родительского экземпляра примитива или экземпляра модуля объекта.
handle◆acc_handle_path(handle output, handle input)
 Получить дескриптор межмодульного пути, представляющего соединение от выходного или inout-порта к входному или inout-порту.
handle◆acc_handle_pathin(handle path)
 Получить дескриптор первой сети, подключённой к источнику пути модуля.
handle◆acc_handle_pathout(handle path)
 Получить дескриптор первой сети, подключённой к приёмнику пути модуля.
handle◆acc_handle_port(handle module, int port_index)
 Получить дескриптор порта модуля на основе позиции порта.
handle◆acc_handle_scope(handle object)
 Получить дескриптор области видимости, содержащей объект.
handle◆acc_handle_simulated_net(handle collapsed_net_handle)
 Получить моделируемую сеть, связанную со свёрнутой сетью, переданной в качестве аргумента.
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)
 Получить дескриптор для указанной проверки временных соотношений модуля (или ячейки).
handle◆acc_handle_tchkarg1(handle tchk)
 Получить дескриптор вывода проверки временных соотношений, подключённого к первому аргументу проверки временных соотношений.
handle◆acc_handle_tchkarg2(handle tchk)
 Получить дескриптор вывода проверки временных соотношений, подключённого ко второму аргументу проверки временных соотношений.
handle◆acc_handle_terminal(handle primitive, int terminal_index)
 Получить дескриптор вывода примитива на основе позиции вывода примитива.
handle◆acc_handle_tfarg(int arg_num)
◆acc_handle_itfarg(int arg_num, handle instance)
 Получить дескриптор указанного аргумента определяемой пользователем системной задачи или функции, которая вызвала PLI-процедуру.
handle◆acc_handle_tfinst()
 Получить дескриптор текущего вызова определяемой пользователем системной задачи или функции.

Следующие подпрограммы

Тип возвращаемого значенияФормат вызова и описание
handle◆acc_next(int object_type_array, handle reference, handle object)
 Получить дескрипторы объектов каждого типа, указанного в массиве, в области действия ссылки.
handle◆acc_next_bit(handle reference, handle current_bit)
 Получить дескрипторы битов в порту или развернутом векторе.
handle◆acc_next_cell(handle reference, hand current_cell)
 Получить дескрипторы экземпляров ячеек в области, включающей всю иерархию ниже модуля.
handle◆acc_next_cell_load(handle reference, hand current_cell_load)
 Получить дескрипторы для нагрузок ячеек на цепи.
handle◆acc_next_child(handle reference, handle current_child)
 Получить дескрипторы дочерних элементов модуля.
handle◆acc_next_driver(handle reference, handle current_driver)
 Получить дескрипторы выводов примитивов, которые управляют цепью.
handle◆acc_next_hiconn(handle referenct, handle current_net)
 Получить дескрипторы для подключений цепей более высокого иерархического уровня к порту модуля.
handle◆acc_next_input (handle reference, handle current_terminal)
 Получить дескрипторы входных выводов пути модуля, выводов-источников пути данных или выводов проверки временных соотношений.
handle◆acc_next_load(handle reference, handle current_load)
 Получить дескрипторы выводов примитивов, управляемых цепью.
handle◆acc_next_loconn(handle reference, handle current_net)
 Получить дескрипторы для подключений цепей более низкого иерархического уровня к порту модуля.
handle◆acc_next_modpath(handle reference, handle path)
 Получить дескрипторы путей модуля.
handle◆acc_next_net(handle reference, handle curretn_net)
 Получить дескрипторы для net-ов в модуле.
handle◆acc_next_output(handle reference, handle current_terminal)
 Получить дескрипторы терминалов выходного пути для пути модуля или пути данных.
handle◆acc_next_parameter(handle reference, handle current_parameter)
 Получить дескрипторы для параметров внутри модуля.
handle◆acc_next_port(handle reference, handle current_port)
 Получает дескрипторы для портов модуля или для портов, которые подключены к заданному net или reg.
handle◆acc_next_portout(handle reference, handle current_port)
 Получить дескрипторы для выходных портов или портов inout модуля.
handle◆acc_next_primitive(handle reference, handle current_primitive)
 Получить дескрипторы для вентилей, переключателей или определяемых пользователем примитивов (UDPs) внутри модуля.
handle◆acc_next_scope(handle reference, handle current_scope)
 Получить дескрипторы иерархических областей внутри области.
handle◆acc_next_specparam(handle reference, handle current_specparam)
 Получить дескрипторы параметров блока specify внутри модуля.
handle◆acc_next_tchk(handle reference, handle timing_check)
 Получить дескрипторы проверок временных соотношений внутри модуля.
handle◆acc_next_terminal(handle reference, handle terminal)
 Получить дескрипторы выводов вентиля, ключа или определяемого пользователем примитива.
handle◆acc_next_topmod(handle top_module)
 Получить дескрипторы модулей верхнего уровня.

Подпрограммы связи при изменении значения

Тип возвращаемого значенияФормат вызова и описание
void◆acc_vcl_add(handle object, C_function unquoted name, char *user_data, int vcl_flag)
 Установить обратный вызов для процедуры-потребителя с информацией об изменении значения всякий раз, когда объект изменяет значение.
consumer_routine() — это незаключённое в кавычки имя функции C, которую нужно вызвать.
void◆acc_vcl_delete(handle object, C_function consumer_routine() , char *user_data, int vcl_flag)
 Удаляет монитор обратного вызова VCL.
consumer_routine() — это незаключённое в кавычки имя функции C, которую нужно вызвать.

Подпрограммы выборки

Тип возвращаемого значенияФормат вызова и описание
int◆acc_fetch_argc()
 Получить количество аргументов командной строки, переданных при вызове программного инструмента Verilog.
char *◆acc_fetch_argv()
 Получить массив указателей на символы, которые составляют аргументы командной строки для вызова программного продукта Verilog.
double◆acc_fetch_attribute(handle object, char *attribute, double default)
 Получить значение параметра или specparam, заданного в качестве атрибута в исходном описании на Verilog.
int◆acc_fetch_attribute_int(handle object, char *attribute, int default)
 Получить целочисленное значение параметра или specparam, заданного в качестве атрибута в исходном описании на Verilog.
char *◆acc_fetch_attribute_str(handle object, char *attribute, char *default)
 Получить значение параметра или specparam, заданного в качестве атрибута в исходном описании на Verilog.
char *◆acc_fetch_defname(handle object)
 Получить имя определения экземпляра модуля или экземпляра примитива.
int◆acc_fetch_delay_mode(handle 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)
 Получить существующие задержки для примитивов, путей модулей, проверок синхронизации, входных портов модулей и межмодульных путей.
int◆acc_fetch_direction(handle object)
 Получить направление порта или терминала.
int◆acc_fetch_edge(handle pathio)
 Получить спецификатор фронта пути модуля или терминала проверки синхронизации.
char *◆acc_fetch_fullname(handle object)
 Получить полное иерархическое имя любого именованного объекта или пути модуля.
int◆acc_fetch_fulltype(handle object)
 Получить fulltype объекта.
int◆acc_fetch_index(handle object)
 Получить номер индекса для порта или вывода.
int◆acc_fetch_location(p_location loc_p, handle object)
 Получить местоположение объекта в исходном файле Verilog-HDL.
p_location — это структура данных, определённая в acc_user.h.
char *◆acc_fetch_name(handle object)
 Получить имя экземпляра любого именованного объекта или пути модуля.
int◆acc_fetch_paramtype(handle parameter)
 Получить тип данных параметра или specparam.
double◆acc_fetch_paramval(handle parameter)
 Получить значение параметра или specparam.
int◆acc_fetch_polarity(handle path)
 Получить полярность пути.
int◆acc_fetch_precision()
 Получить наименьший аргумент точности времени, указанный во всех директивах компилятора `timescale в заданном проекте.
int◆acc_fetch_pulsere(handle object, double *r1, double *e1, double *r2, double *e2, ......, double *r12, double *e12)
 Получить текущие reject_limit и e_limit обработки импульсов для пути модуля, межмодульного пути или входного порта модуля.
int◆acc_fetch_range(handle vector, int *msb, int *lsb)
 Получить значения диапазона старшего и младшего бита для вектора.
int◆acc_fetch_size(handle object)
 Получить размер в битах для net, reg, integer, time, real или port.
double◆acc_fetch_tfarg(int arg_number)
◆acc_fetch_itfarg(int arg_number, handle tfinst)
 Получить значение указанного аргумента системной задачи или функции, связанной с приложением PLI; значение возвращается как число с двойной точностью
int◆acc_fetch_tfarg_int(int arg_number)
◆acc_fetch_itfarg_int(int arg_number, handle tfinst)
 Получить значение указанного аргумента системной задачи или функции, связанной с приложением PLI; значение возвращается как целое число.
char *◆acc_fetch_tfarg_str(int arg_number)
◆acc_fetch_itfarg_str(int arg_number, handle tfinst)
 Получить значение указанного аргумента системной задачи или функции, связанной с приложением PLI; значение возвращается как указатель на строку символов.
void◆acc_fetch_timescale_info(handle object, p_timescale_info timescale_p)
 Получить информацию о временной шкале для объекта или для активного вызова системной задачи $timeformat.
p_timescale_info — это структура данных, определённая в acc_user.h.
int◆acc_fetch_type(handle object)
 Получить тип объекта.
char *◆acc_fetch_type_str(int type)
 Получить строку, указывающую тип её аргумента.
char *◆acc_fetch_value(handle object, char *format, s_acc_value *value)
 Получить логическое значение или значение силы для net, reg или переменной.
s_acc_value — это структура данных, определённая в acc_user.h.

Разные подпрограммы

Тип возвращаемого значенияФормат вызова и описание
void◆acc_close()
 Освободить внутреннюю память, используемую процедурами ACC; сбросить все параметры конфигурации к значениям по умолчанию.
handle *◆acc_collect(handle *next_routine, handle object, int num_of_objects)
 Получить массив дескрипторов для всех объектов, связанных с конкретным ссылочным объектом; получить количество собранных объектов.
int◆acc_compare_handles(handle object1, handle object2)
 Определить, ссылаются ли два дескриптора на один и тот же объект.
int◆acc_configure(int config_param, char *config_value)
 Задать параметры, управляющие работой различных процедур ACC.
int◆acc_count(handle *next_routine, handle object)
 Подсчитать количество объектов, связанных с конкретным ссылочным объектом.
int◆acc_initialize()
 Инициализирует среду для процедур ACC.
int◆acc_object_in_typelist(handle object, int object_type_array[])
 Определить, соответствует ли объект типу или fulltype, или специальному свойству, как указано во входном массиве.
int◆acc_object_of_type(handle object, int object_type)
 Определяет, соответствует ли объект заданному типу или fulltype, либо специальному свойству.
int◆acc_product_type()
 Получить тип программного продукта, вызывающего PLI-приложение.
char *◆acc_product_version()
 Получить версию программного продукта, связанного с процедурами ACC.
int◆acc_release_object(handle object)
 Освободить память, выделенную вызовами acc_next_input() и acc_next_output().
void◆acc_reset_buffer()
 Сбросить строковый буфер в начало.
handle◆acc_set_interactive_scope(handle scope, int callback_flag)
 Установить интерактивную область программного инструмента.
char*◆acc_set_scope(handle module, char *module_name)
 Задает область видимости для acc_handle_object(), используемую при поиске в иерархии проекта.
char *◆acc_version()
 Возвращает указатель на строку символов, которая указывает номер версии программного обеспечения подпрограмм ACC.

Подпрограммы модификации

Тип возвращаемого значенияФормат вызова и описание
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)
 Добавляет задержки к существующей задержке на примитивах, путях модулей, межмодульных путях, проверках синхронизации и входных портах модулей.
int◆acc_append_pulsere(handle object, double *r1, double *e1, double *r2, double *e2, ......, double *r12, double *e12)
 Добавляет задержки к существующим параметрам reject_limit и e_limit обработки импульсов для пути модуля, межмодульного пути или входного порта модуля.
int◆acc_release_object(handle object)
 Освободить память, выделенную вызовами acc_next_input() и 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)
 Заменяет существующие задержки для примитивов, путей модулей, проверок временных соотношений, входных портов модулей и межмодульных путей.
int◆acc_replace_pulsere(handle object, double *r1, double *e1, double *r2, double *e2, ......, double *r12, double *e12)
 Заменяет существующие значения reject_limit и e_limit обработки импульсов для пути модуля, межмодульного пути или входного порта модуля.
int◆acc_set_pulsere(handle path, double reject_percentage, double e_percentage)
 Устанавливает значения обработки импульсов для пути модуля, межмодульного пути или входного порта модуля в процентах от задержки.
int◆acc_set_value(handle object, p_setval_value value_p, p_setval_delay delay_p)
 Устанавливает и распространяет значение для reg, переменной, пользовательской системной функции или последовательного UDP; процедурно присваивает reg или переменную; принудительно устанавливает reg, переменную или net.
p_setval_value и p_setval_delay — это структуры данных, определённые в acc_user.h.

Структуры

Далее описываются некоторые структуры, предназначенные для подпрограмм ACC.

Задействованные функцииСтруктуры
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;
объединение
{
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;