Функциональные возможности
Подпрограммы TF (задача/функция) в основном используются для передачи данных в двух направлениях на границе между Verilog и пользовательскими программами на C.
Подпрограммы TF всегда имеют префикс tf_ и определены в заголовочном файле veriuser.h. Поэтому при написании системных задач или функций на C необходимо добавить #include "veriuser.h" в C-файл.
Подпрограммы TF можно разделить на следующие варианты использования:
- Получение информации о системной задаче
- Получение информации о списке параметров
- Получение значений параметров
- Передача значений параметров обратно в системные задачи
- Отслеживание изменений значений параметров
- Получение информации о времени моделирования и запланированных событиях
- Арифметические операции
- Отображение информации
- Управление и сопровождение задач
- Другие задачи, такие как приостановка, завершение, сохранение и восстановление
Полный список TF-подпрограмм и краткие указания по их использованию см. в следующем разделе."8.3 Список TF-подпрограмм"。
Примеры TF-подпрограмм
Библиотека PLI-подпрограмм содержит большое количество функций. Их подробное объяснение по одной потребовало бы очень много места. Поэтому рекомендуется внимательно изучать отдельные подпрограммы только при необходимости. Ниже приведены примеры некоторых TF-подпрограмм, в основном иллюстрирующие базовый процесс разработки системных задач Verilog с использованием TF-подпрограмм.
Требования к проектированию
Иногда, чтобы уменьшить размер объектного файла после компиляции файла на языке C или вывести отладочную информацию в определённом формате, функция печати в программном обеспечении может не использовать встроенную функцию printf языка C и не использовать функцию io_printf из TF-подпрограмм. Вместо этого она использует интерфейс PLI и системные функции отображения Verilog ($display или $write) для реализации пользовательской функции печати программного обеспечения.
В данном проекте реализуется функция печати программного обеспечения с именем print_my, имеющая формат вывода "строка + целое число".
Анализ проекта
Пользовательская функция печати программного обеспечения print_my — это всего лишь неприглядная оболочка, используемая для передачи печатной информации в программные переменные формальных параметров. Чтобы передать печатную информацию в Verilog, также требуется системная задача, построенная с помощью TF-подпрограмм, с именем $send_my().
Следует отметить, что системные задачи, реализованные с помощью TF-подпрограмм, обычно должны вызываться в коде Verilog. Прямой вызов этой "системной задачи" из программного обеспечения эквивалентен вызову программной функции и не имеет прямой связи с описаниями соответствующих переменных в коде Verilog. Поэтому прямой вызов "программной функции" send_my в программной функции print_my не имеет смысла. Необходимо добавить в print_my некоторые специфические программные действия, чтобы инициировать вызов системной задачи $send_my из Verilog.
Если цифровая система содержит CPU, можно использовать метод записи в шину или память через программное обеспечение, а затем отслеживать соответствующие сигнальные переменные в тестбенче. Этот дизайн относительно мал по масштабу, поэтому можно использовать другой метод: Verilog продолжает выполнять системную задачу $send_my, а в программной функции print_my задается глобальная переменная для управления, выполнять ли передачу и печать информации.

Проектирование программного обеспечения
Код программной части приведен ниже, подробности объясняются в комментариях. Сохраните его в файл print_gyc.c.
Пример
// строка для печати, целочисленные данные, флаг начала программной печати
char *str_mes ;
unsigned int int_mes ;
int flags = 0;
//===== определение print_my(), используемой в C ======
void print_my(char * str_send, unsigned int int_send){
str_mes = str_send ;
int_mes = int_send ;
флаги = 1 ;
}
// данные символьного типа ASCII-кодов, соответствующих выводимой строке; исходная длина в символах ограничена 100
// например, символ "1" соответствует ASCII-коду 0x31, чьи данные символьного типа — 0x33, 0x31
char str_mes_format[200] ;
// когда подпрограммы TF передают данные строкового типа, они могут передавать данные только в соответствующем базовом формате
// например, "0xc0de1234" можно передать, но "www.example.com" нельзя
// поэтому исходные строковые данные необходимо преобразовать в данные символьного типа соответствующих ASCII-кодов
void byte2hexstr(char* str, char* dest, int len)
{
char tmp;
int i ;
char stb[16] = { '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'A', 'B', 'C', 'D', 'E', 'F' };
for (i = 0; i < len; i++){
tmp = str[i];
dest[i * 2] = stb[tmp >> 4];
dest[i * 2 + 1] = stb[tmp & 15];
}
return;
}
//===== определение PLI: send_my() =======
void send_my(){
int i = 0 ;
// обнаружить флаг начала программной печати flags
// и системная задача $send_my вызывается из Verilog с передачей 3 параметров
if (flags && tf_nump()==3) {
// преобразовать выводимые строковые данные в строковый тип, соответствующий ASCII
byte2hexstr(str_mes, str_mes_format, 100);
// передать данные шестнадцатеричного символьного типа во 2-й параметр системной задачи send_my
// длина составляет 1600 бит, что соответствует 100 символам и 200 элементам данных символьного типа ASCII
tf_strdelputp(2, 1600, 'H', str_mes_format, 0, 0);
// передать целочисленные данные в 3-й параметр
tf_putp(3, int_mes);
// передать флаг запуска аппаратной печати в 1-й параметр
tf_putp(1, 1) ;
флаги = 0 ;
}
}
Проектирование аппаратного обеспечения
Согласно результатам моделирования, данные, передаваемые из программного обеспечения в Verilog, хранятся в 1600-битном регистре, как показано на рисунке ниже.

Когда регистр содержит нормальные данные, он начинает сохранять нормальные символьные данные с 799-го бита (половина ширины регистра). Остальные младшие биты хранят "NULL" (соответствует данным 0) и системные данные по умолчанию. Длины этих двух частей данных варьируются в зависимости от длины сохраняемых нормальных данных.
Когда регистр не содержит нормальных данных, он использует более 800 бит длины регистра для хранения "NULL" (соответствует данным 0). Оставшаяся ширина хранит системные данные по умолчанию.
На основе вышеуказанных особенностей можно обнаруживать нормальные строковые данные без печати всех данных в регистре, избегая большого количества пустого пространства в выводе печати, которое повлияло бы на внешний вид.
Проект аппаратного кода Verilog выглядит следующим образом, конкретные детали объяснены в комментариях. Сохраните его в файл test.v.
Пример
module test ;
reg [1599:0] str_my ;
reg [31:0] int_my ;
reg flag_my ;
// постоянно проверять аппаратный флаг печати flagh, чтобы определить, нужно ли печатать
целое число i = 1599;
целое число j = 1599;
reg [7:0] str_tmp ; // регистр хранения строковых данных
initial begin
flagh = 0 ;
forever begin
#20 ;
// вызов системной задачи и передача данных из программного обеспечения в аппаратное (Verilog)
$send_my(flagh, str_my, int_my);
if (flagh) begin // начать вывод информации
#1 ;
// разрядность регистра избыточна; вывод всего приведёт к большому количеству пробелов
// здесь неиспользуемые биты регистра обнаруживаются и исключаются из вывода
for(i=1599; i>=0; i= i-8) begin
if (str_my[i -: 8] != 0)
break ;
end
// обычно половина разрядности регистра используется для хранения строковых данных
// поэтому, когда передача строки корректна, данные начинаются с str_my
$display("--DEBUG--- Количество допустимых данных: %d", i);
// если строковых данных нет, str_my тоже не будет полностью пустым
// но в str_my[799 -: 8] не будет данных
if (i<=791) begin
$display("--ERR--- ПОЖАЛУЙСТА, ВВЕДИТЕ КОРРЕКТНУЮ СТРОКОВУЮ ИНФОРМАЦИЮ!!!");
$display("--ERR--- Номер данных по умолчанию: %d", i);
$display("--ERR--- Структура строковых данных: %h", str_my);
end
else begin
$write("---YYY---");
for(j=i; j>=0; j= j-8) begin
str_tmp = str_my[j -: 8] ;
// остановить вывод, когда снова обнаружен нулевой символ
if (str_tmp == "") begin
break ;
end
// выводить посимвольно
else begin
$write("%s", str_tmp);
end
end
// выводить целочисленные данные
$write("%h \n", int_my);
end
/* $display не поддерживает доступ к переменным в частичных выборках векторных регистров
// поэтому следующее описание неверно; можно только повторно использовать $write для вывода
else begin
$display("--YYY--- %s%h", str_my[i : j], int_my);
end
*/
flagh = 0 ;
end
end
end
// остановить моделирование
initial begin
forever begin
#10000;
if ($time >= 300) $finish ;
end
end
endmodule
Вызов программного обеспечения
Поскольку программная часть этого проекта не может выполняться активно, добавлена дополнительная системная задача Verilog, разработанная с использованием подпрограмм TF. Когда эта системная задача выполняется в testbench, она может вызвать функцию print_my в программном обеспечении.
Добавьте следующий код на C в файл print_gyc.c:
if (tf_getp(1) == 1) // если значение первого параметра системной функции равно 1
print_my("It's the first successfull print: ", 0x20170714);
else if (tf_getp(1) == 2) // если значение второго параметра системной функции равно 2
print_my("2-й: ", 0x09070602);
else
print_my("", 0x1); // если строковые данные не переданы, сообщить об ошибке
}
Добавьте следующий код Verilog в файл test.v:
initial begin
#100 ;
$call_c_print(1);
#100 ;
$call_c_print(2);
#100 ;
$call_c_print(3);
end
Компиляция и моделирование
В Linux используйте следующую команду для компиляции print_gyc.c и вывода файла print_gyc.o. Обратите внимание на относительные пути.
gcc -I ${VCS_HOME}/include -c ../tb/print_gyc.cПри компиляции с VCS необходимо создать файл таблицы связей, распознаваемый VCS, с именем pli_gyc.tab и следующим содержимым.
$send_my и $call_c_print — это имена системных задач, вызываемых Verilog;
call=my_monitor, call=call_c_print и т. д. обозначают вызовы функций в программе на C;
$send_my call=send_my $call_c_print call=call_c_print
Добавьте строку параметров при компиляции с помощью VCS.
-P ../tb/pli_gyc.tab
Результаты моделирования следующие.
Как видно из рисунка, выводимая информация нормальна и не содержит лишних пробелов.
Когда в выводимой информации отсутствуют строковые данные, сообщается об ошибке вместе с выводом некоторой отладочной информации.
Вы можете изменить некоторые параметры в тестбенче для отладки и изучения форматов хранения данных.

Скачать исходный код главы
Скачать