Функциональные возможности

Основные функции, выполняемые подпрограммами 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.

Пример

#include "acc_user.h"

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.

Пример

module counter10(
   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.

Пример

`timescale 1ns/1ps
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

Журнал результатов моделирования выглядит следующим образом.

Из журнала видно, что сравнение программного и аппаратного подсчёта корректно, а состояние после завершения счётчиком одного цикла подсчёта также нормально.

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

Скачать