Чтобы сохранить оригинальный колорит подпрограмм и избежать низкого уровня перевода, все списки подпрограмм сохраняют свои английские описания. Не все подпрограммы были здесь проверены. Из-за проблем с версией или переписыванием могут быть пропуски; исправления приветствуются. При их использовании рекомендуется внимательно изучить соответствующий тип подпрограммы и чаще обращаться к типам параметров и настройкам в других примерах.
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_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; объединение { 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; |