Функциональные возможности
Основные функции, выполняемые подпрограммами ACC:
- Чтение информации о конкретных объектах из внутренних структур данных
- Запись информации о конкретных объектах во внутренние структуры данных
Типы объектов, с которыми могут работать подпрограммы ACC:
- Экземпляры модулей, порты модулей, сквозные пути модулей и пути между модулями
- Модули верхнего уровня
- Экземпляры примитивов и порты примитивов
- Типы переменных, такие как wire, reg, parameter, integer, time, real и т. д.
- Проверки синхронизации
- Именованные события
Основные характеристики подпрограмм ACC:
- Все имеют префикс acc_
- В начале необходимо вызвать acc_initialize() для инициализации среды
- При завершении необходимо вызвать acc_close()
- При использовании функций из библиотеки ACC необходимо подключить заголовочный файл acc_user.h
- Для доступа к объектам используется понятие дескрипторов. Дескриптор — это предопределенный тип данных, указывающий на конкретный объект в проекте. Получив дескриптор, можно получить доступ ко всей информации об объекте. Это аналогично понятию файлового дескриптора в языке C. Дескрипторы объявляются с помощью ключевого слова handle.
Основные типы подпрограмм ACC:
- Подпрограммы работы с дескрипторами (handle): возвращают дескриптор объекта в проекте, всегда имеют префикс acc_handle_.
- Подпрограммы перехода к следующему (next): возвращают дескриптор следующего объекта в заданном наборе объектов проекта, всегда имеют префикс acc_next_ и принимают объект, на который сделана ссылка, в качестве параметра.
- Подпрограммы связи изменения значения (VCL): могут добавлять и удалять объекты из списка объектов, для которых отслеживаются изменения значений, всегда имеют префикс acc_vcl_ и не имеют возвращаемого значения.
- Подпрограммы извлечения (fetch): могут извлекать информацию об атрибутах, такую как иерархические пути, всегда с префиксом acc_fetch_.
- Разные подпрограммы (miscellaneous): используются для выполнения различных прочих операций, связанных с подпрограммами доступа. Например, acc_initialize() и acc_close() — обе относятся к разным подпрограммам.
- Подпрограммы модификации (modify): могут изменять внутренние структуры данных.
Полный список подпрограмм ACC и краткие инструкции по их использованию см. в следующем разделе"8.5 Список подпрограмм ACC"。
Примеры подпрограмм ACC
Ниже приведены примеры использования только некоторых подпрограмм ACC, в основном иллюстрирующие базовый процесс разработки системных задач Verilog с использованием подпрограмм ACC.
Требования к проектированию
На этот раз разработайте системную задачу, которая отслеживает счетчик.
С одной стороны, системная задача отслеживает значение счетчика в Verilog; с другой стороны, после обнаружения тактового сигнала счета в Verilog она также выполняет программный подсчет и сравнивает значения программного и аппаратного счетчиков, чтобы проверить корректность аппаратной логики. В то же время, когда счетчик досчитывает до определенного значения, она выводит значения некоторых сигнальных переменных.
Такой подход к проектированию также является распространенным сценарием для интерфейсов PLI. Программная часть реализует логическую функцию, называемую CModel. Затем аппаратная часть также реализует ту же логическую функцию с помощью Verilog. Через программу интерфейса PLI программная и аппаратная программы могут выполняться одновременно и сравнивать результаты, чтобы проверить корректность проекта аппаратной логики.
Анализ проекта
В части интерфейса PLI используется подпрограмма Value Change Link для отслеживания тактового сигнала. Как только приходит передний фронт тактового сигнала, вызывается программная функция для выполнения программного подсчета и сравнения значений программного и аппаратного счетчиков.
Проектирование программного обеспечения
Код программной разработки приведён ниже, подробности объяснены в комментариях. Сохраните его в файл monitor_gyc.c.
Пример
handle hand_rstn, hand_clk, hand_cnt, hand_cout ;
int cnt_soft = 0 ; //Значение программного счётчика
int cout_soft = 0 ; //Бит переполнения программного счётчика
//Функция программного подсчёта и сравнения
void act_monitor(){
p_acc_value value ; //Объявление переменной структуры, определённой в ACC
//Чтение значения сигнальной переменной в Verilog, строкового типа
char *rstn_rtl_str = acc_fetch_value(hand_rstn, "%d", value);
char *clk_rtl_str = acc_fetch_value(hand_clk, "%d", value);
char *cnt_rtl_str = acc_fetch_value(hand_cnt, "%d", value);
char *cout_rtl_str = acc_fetch_value(hand_cout, "%d", value);
//Преобразовать строку в целое число
int rstn_rtl = atoi(rstn_rtl_str) ;
int clk_rtl = atoi(clk_rtl_str) ;
int cnt_rtl = atoi(cnt_rtl_str) ;
int cout_rtl = atoi(cout_rtl_str) ;
//Программный счётчик
//Сброс
if (!rstn_rtl) {
cnt_soft = 0 ;
cout_soft = 0 ;
io_printf("---iii--- Сброс состояния! \n");
}
//Нормальная работа
else if (rstn_rtl && clk_rtl) {
if (cnt_soft == 9) {
cnt_soft = 0 ; //Подсчет 10
}
else {
cnt_soft = cnt_soft + 1 ; //Подсчет
}
}
cout_soft = cnt_soft == 9 ? 1 : 0 ; //Перенос
//Сравнить значения программного и аппаратного счетчиков, когда тактовый сигнал низкий; это относительно безопасное время
if (!clk_rtl && rstn_rtl) {
if ((cnt_soft != cnt_rtl) || (cout_soft != cout_rtl)) {
io_printf("--Err--- счетчик rtl: %d, программный счетчик: %d\n", cnt_rtl, cnt_soft);
io_printf("--Ошиб--- rtl cout: %d, и soft cout: %d\n", cout_rtl, cout_soft");
}
//Если при сравнении программного и аппаратного счёта нет ошибки, вывести значения состояния сигналов по завершении одного цикла счёта
else if (cnt_soft == 9) {
io_printf("--Монитор--- rtl и soft cnt: %d\n", cnt_soft");
io_printf("--Монитор--- rtl и soft cout: %d\n", cout_soft");
}
}
}
//Интерфейс PLI, мониторинг изменений тактового сигнала
void my_monitor() {
acc_initialize(); //Требуется инициализация
//Получить переменную-дескриптор первого параметра системной задачи my_monitor
hand_rstn = acc_handle_tfarg(1);
hand_clk = acc_handle_tfarg(2);
hand_cnt = acc_handle_tfarg(3);
hand_cout = acc_handle_tfarg(4);
//"#define VCL_VERILOG_LOGIC 2" в acc_user.h
//Указывает, что механизм обратного вызова VCL должен сообщать
//Как только hand_clk изменится, вызвать функцию act_monitor
acc_vcl_add(hand_clk, act_monitor, null, vcl_verilog_logic);
acc_close(); //Закрыть задачу
}
Проектирование аппаратного обеспечения
Описание десятичного счётчика на Verilog выглядит следующим образом. Сохраните его в файл counter10.v.
Пример
input rstn,
input clk,
output [3:0] cnt,
output cout);
reg [3:0] cnt_temp ;
always@(posedge clk or negedge rstn) begin
if (! rstn) begin
cnt_temp <= 4'b0 ;
end
else if (cnt_temp==4'd9) begin
cnt_temp <=4'b000;
end
else begin
cnt_temp <= cnt_temp + 1'b1 ;
end
end
assign cout = (cnt_temp==4'd9) ;
assign cnt = cnt_temp ;
endmodule
testbench
Описание тестового стенда приведено ниже. Сохраните его в файл test.v.
Пример
module test ;
reg rstn, clk ;
wire [3:0] cnt ;
wire cout ;
initial begin
rstn = 0 ;
clk = 0 ;
#19.8;
rstn = 1 ;
end
always #5 clk = ~clk ;
counter10 u_cnt(
.rstn (rstn),
.clk (clk),
.cnt (cnt),
.cout (cout));
initial begin
$my_monitor(test.rstn, test.clk, test.cnt, test.cout);
end
initial begin
forever begin
#100;
if ($time >= 300) $finish ;
end
end
endmodule
Компиляция и моделирование
В Linux используйте следующую команду для компиляции monitor_gyc.c и получения файла monitor_gyc.o. Обратите внимание на относительный путь.
gcc -I ${VCS_HOME}/include -c ../tb/monitor_gyc.cПри компиляции с помощью VCS необходимо создать связующий файл, который может распознать VCS. Назовите файл pli_gyc.tab со следующим содержимым.
$my_monitor — это имя системной задачи, вызываемой в Verilog;
call=my_monitor означает вызов функции my_monitor() в программе на C;
acc=rw:* задаёт атрибуты системной задачи. rw указывает, что внутренние данные можно читать и записывать. После двоеточия можно объявить модуль или область сигналов, на которые действует системная задача. ":*" означает, что она может действовать на все модули.
$my_monitor call=my_monitor acc=rw:*
Добавьте строку параметров при компиляции с помощью VCS.
-P ../tb/pli_gyc.tab
Журнал результатов моделирования выглядит следующим образом.
Из журнала видно, что сравнение программного и аппаратного подсчёта корректно, а состояние после завершения счётчиком одного цикла подсчёта также нормально.

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