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

Подпрограммы TF часто используются для двунаправленной передачи данных между Verilog и пользовательскими подпрограммами на C. Когда подпрограмма с префиксом tf_ имеет соответствующую подпрограмму с префиксом tf_i, указатель экземпляра, над которым выполняются операции в соответствующей подпрограмме с префиксом tf_i, должен быть передан как дополнительная переменная в конце списка переменных.

Подпрограммы TF не имеют явных маркеров классификации в своих соглашениях об именовании. Ниже приведена краткая сводка.

Получение информации о задаче и функции

Тип возвращаемого значенияФормат вызова и описание
char *◆tf_getinstance()
 Получить указатель на текущий экземпляр определённой пользователем системной задачи или функции.
char *◆tf_mipname()
◆tf_imipname(char *instance_p)
 Получить иерархическое путевое имя экземпляра модуля в виде строки.
char *◆tf_spname()
◆tf_ispname(char *instance_p)
 Получить иерархическое путевое имя области видимости в виде строки.

Получение информации о списке переменных

Тип возвращаемого значенияФормат вызова и описание
int◆tf_nump()
◆tf_inump(char *instance_p)
 Получить количество аргументов задачи или функции.
int◆tf_typep(int narg)
◆tf_itypep(int narg, char *instance_p)
 Получить тип аргумента системной задачи/функции.
int◆tf_sizep(narg)
◆tf_isizep(int narg, char *instance_p)
 Получить битовую длину аргумента системной задачи/функции.
t_tfexprinfo *◆tf_exprinfo(int narg, t_tfexprinfo *exprinfo_p)
◆tf_iexprinfo(int narg, t_tfexprinfo *exprinfo_p, char *instance_p)
 Получить информацию о выражении аргумента системной задачи/функции.
t_tfexprinfo — это структура данных, определённая в veriuser.h.
t_tfnodeinfo *◆tf_nodeinfo(int narg, t_tfnodeinfo *nodeinfo_p)
◆tf_inodeinfo(int narg, t_tfnodeinfo *nodeinfo_p, char *instance_p)
 Получить информацию об узле аргумента системной задачи/функции.
t_tfnodeinfo — это структура данных, определённая в veriuser.h.

Получить значение параметра

Тип возвращаемого значенияФормат вызова и описание
int◆tf_getp(int narg)
◆tf_igetp(int narg, char *instance_p)
 Получить значение аргумента системной задачи/функции в виде целого числа или указателя на строку символов
double◆tf_getrealp(int narg)
◆tf_igetrealp(int narg, char *instance_p)
 Получить значение аргумента системной задачи/функции как значение с двойной точностью.
int◆tf_getlongp(int *aof_highvalue, int narg)
◆tf_igetlongp(int *aof_highvalue, int narg, char *instance_p)
 Получить значение аргумента системной задачи/функции как 64-битное целое число.
char *◆tf_strgetp(int narg, int format)
◆tf_istrgetp(int narg, int format, char *instance_p)
 Получить форматированные значения аргументов системной задачи/функции.
char *◆tf_getcstringp(int narg)
◆tf_igetcstringp(int narg, char *instance_p)
 Получить значение аргумента системной задачи/функции как строку.
int◆tf_evaluatep(int narg)
◆tf_ievaluatep(int narg, char *instance_p)
 Вычислить выражение аргумента системной задачи/функции.

Установить значение параметра

Тип возвращаемого значенияФормат вызова и описание
int◆tf_putp(int narg, int value)
◆tf_iputp(int narg, int value, char *instance_p)
 Записать целочисленное значение в аргумент системной задачи/функции или возвращаемое значение функции.
int◆tf_putrealp(int narg, double value)
◆tf_iputrealp(int narg, double value, char *instance_p)
 Записать вещественное значение в аргумент системной задачи/функции или возвращаемое значение функции.
int◆tf_putlongp(int narg, int lowvalue, int highvalue)
◆tf_iputlongp(int narg, int lowvalue, int highvalue, char *instance_p)
 Записать 64-битное целочисленное значение в аргумент системной задачи/функции или возвращаемое значение функции.
int◆tf_propagatep(int narg)
◆tf_ipropagatep(int narg, char *instance_p)
 Распространить значение аргумента системной задачи/функции.
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)
 Записать значение в аргумент системной задачи/функции из спецификации строкового значения, используя 32-битную целочисленную задержку.
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)
 Записать значение в аргумент системной задачи/функции из спецификации строкового значения, используя задержку в виде вещественного числа.
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)
 Записать значение в аргумент системной задачи/функции из спецификации строкового значения, используя 64-битную целочисленную задержку.

Отслеживание изменений значений параметров

Тип возвращаемого значенияФормат вызова и описание
int◆tf_asynchon()
◆tf_iasynchon(char *instance_p)
 Включить асинхронный вызов приложения misctf при изменении значений аргументов системной задачи/функции.
int
(всегда 0)
◆tf_asynchoff()
◆tf_iasynchoff(char *instance_p)
 Отключить асинхронный вызов приложения misctf.
int◆tf_synchronize()
◆tf_isynchronize(char *instance_p)
 Синхронизировать до конца шага времени моделирования.
int◆tf_rosynchronize()
◆tf_irosynchronize(char *instance_p)
 Синхронизировать до конца шага времени моделирования.
int◆tf_getpchange(int narg)
◆tf_igetpchange(int narg, char *instance_p)
 Получить индекс следующего аргумента системной задачи/функции, значение которого изменилось.
int◆tf_copypvc_flag(int narg)
◆tf_icopypvc_flag(int narg, char *instance_p)
 Скопировать флаги изменения значений аргументов системной задачи/функции.
int◆tf_movepvc_flag(int narg)
◆tf_imovepvc_flag(int narg, char *instance_p)
 Переместить флаги изменения значений аргументов системной задачи/функции.
int◆tf_testpvc_flag(int narg)
◆tf_itestpvc_flag(int narg, char *instance_p)
 Проверка флагов изменения значений аргументов системной задачи/функции.

Синхронизация задач

Тип возвращаемого значенияФормат вызова и описание
int◆tf_gettime()
◆tf_igettime(char *instance_p)
 Возвращает текущее время моделирования в виде 32-битного целого числа.
double◆tf_getrealtime()
◆tf_igetrealtime(char *instance_p)
 Возвращает текущее время моделирования в формате с двойной точностью.
int◆tf_getlongtime(int *aof_hightime)
◆tf_igetlongtime(int *aof_hightime, char *instance_p)
 Возвращает текущее время моделирования в виде 64-битного целого числа.
Возвращает младшие (крайние правые) 32 бита времени моделирования.
char *◆tf_strgettime()
 Получить текущее время моделирования в виде строки.
int◆tf_getnextlongtime(int *aof_lowtime, int *aof_hightime)
 Получить следующее время, на которое запланировано событие моделирования
int◆tf_gettimeprecision()
◆tf_igettimeprecision(char *instance_p)
 Получить точность временного масштаба модуля или моделирования.
int◆tf_gettimeunit()
◆tf_igettimeunit(char *instance_p)
 Получить единицу временного масштаба модуля или моделирования.
int◆tf_setdelay(int delay)
◆tf_isetdelay(int delay, char *instance_p)
 Активировать приложение misctf в определённое время моделирования.
int◆tf_setlongdelay(int lowdelay, int highdelay)
◆tf_isetlongdelay(int lowdelay, int highdelay, char *instance_p)
 Активировать приложение misctf в определённое время моделирования.
int◆tf_setrealdelay(double realdelay)
◆tf_isetrealdelay(double realdelay, char *instance_p)
 Активировать приложение misctf в определённое время моделирования.
void◆tf_scale_longdelay(char *instance_p, int delay_lo, int delay_hi, int *aof_delay_lo, int *aof_delay_hi)
 Преобразовать 64-битную целочисленную задержку в масштаб времени экземпляра модуля.
void◆tf_scale_realdelay(char *instance_p, double realdelay, double *aof_realdelay)
 Преобразовать задержку с плавающей запятой двойной точности в масштаб времени экземпляра модуля.
void◆tf_unscale_longdelay(char *instance_p, int delay_lo, int delay_hi, int *aof_delay_lo, int *aof_delay_hi)
 Преобразовать задержку из внутренних единиц времени моделирования в масштаб времени конкретного модуля.
void◆tf_unscale_realdelay(char *instance_p, double realdelay, double *aof_realdelay)
 Преобразовать задержку, выраженную во внутренних единицах времени моделирования, в масштаб времени конкретного модуля.
int◆tf_clearalldelays()
◆tf_iclearalldelays(char *string_p)
 Очистить все запланированные реактивации, созданные tf_setdelay() или tf_isetdelay().

Арифметические операции

Тип возвращаемого значенияФормат вызова и описание
int
(всегда 0)
◆tf_add_long(int *aof_low1, int *aof_high1, int low2, int high2)
 Сложить два 64-битных целых числа.
int
(всегда 0)
◆tf_subtract_long(int *aof_low1, int *aof_high1, int low2, int high2)
 Вычесть два 64-битных целых числа.
void◆tf_multiply_long(int *aof_low1, int *aof_high1, int low2, int high2)
 Умножить два 64-битных целых числа.
void◆tf_divide_long(int *aof_low1, int *aof_high1, int low2, int high2)
 Разделить два 64-битных целых числа.
int◆tf_compare_long(int low1, int high1, int low2, int high2)
 Сравнивает два 64-битных целых значения.
char *◆tf_longtime_tostr(int lowtime, int hightime)
 Преобразует 64-битное целое значение времени в строку символов.
void◆tf_real_to_long(double realvalue, int *aof_low, int *aof_high)
 Преобразует вещественное число в 64-битное целое.
void◆tf_long_to_real(int low, int high, double *aof_real)
 Преобразует 64-битное целое в вещественное число.

Отображение информации

Тип возвращаемого значенияФормат вызова и описание
void◆io_printf(char *format, arg1, ..., arg12)
 Выводит форматированное сообщение в выходной канал программного продукта, который вызвал PLI-приложение, и в файл журнала продукта.
void◆io_mcdprintf(int mcd, char *format, arg1, ..., arg12)
 Записывает форматированное сообщение в один или несколько файлов.
int
(всегда 0)
◆tf_error(char *format, arg1,..., arg5)
 Вывести сообщение об ошибке.
int
(всегда 0)
◆tf_warning(char *format, arg1, ..., arg5)
 Вывести предупреждающее сообщение.
int
(всегда 0)
◆tf_message(int level, char *facility, char *code, char *message, arg1,..., arg5)
 Вывести сообщение об ошибке или предупреждение с управлением прерыванием программного продукта.
int
(всегда 0)
◆tf_text(char *message, arg1,..., arg5)
 Сохранить информацию о сообщении об ошибке.

Внутреннее обслуживание задач

Тип возвращаемого значенияФормат вызова и описание
int
(всегда 0)
◆tf_setworkarea(char *workarea)
◆tf_isetworkarea(char *workarea, char *instance_p)
 Сохранить указатель на пользовательские данные в рабочей области.
char *◆tf_getworkarea()
◆tf_igetworkarea(char *instance_p)
 Получить указатель на рабочую область.

Другие подпрограммы

Тип возвращаемого значенияФормат вызова и описание
int
(всегда 0)
◆tf_dostop()
 Перевести программный продукт в интерактивный режим.
int
(всегда 0)
◆tf_dofinish()
 Завершить выполнение программного продукта.
char *◆mc_scan_plusargs(char *startarg)
 Сканировать командную строку вызова программного продукта на наличие опций с плюсом (+).
int◆tf_write_save(char *blockptr, int blocklen)
 Добавить блок данных в файл сохранения.
int◆tf_read_restart(char *blockptr, int blocklen)
 Получить блок данных из ранее записанного файла сохранения.