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