DPI-C的使用指南

最新推荐文章于 2024-05-28 10:43:53 发布
最新推荐文章于 2024-05-28 10:43:53 发布
阅读量2.1w 收藏 129
点赞数 8
分类专栏： systemverilog

第1章 C和C++

文件后缀名为c，VCS会使用gcc编译器；文件后缀名为cpp，cxx，cc，VCS会使用g++编译器。VCS的DPI接口是兼容C的，所以如果使用g++编译器，需要在c++的文件中加入如下：


#ifdef __cplusplus

extern "C" {

#endif

 // code 

 // code

#ifdef __cplusplus

}

#endif


第2章任务和函数

1.1 导入的任务和函数

语法：

import "DPI" [c_identifier =] [pure][context] function type name (args);

import "DPI" [c_identifier =] [context] task name (args);

规则说明：

1.       Context
使用context修饰的函数和任务，可以访问申明时的范围内的变量，而不仅仅局限在他的参数上。函数可以是pure，context或者其他类型的，任务只能是context或者non-context类型的。Context会导致仿真的效率变低，所以应当慎重使用。如果某个导出的函数或者任务，在C的环境中，需要通过PLI，VPI访问SV范围内的全局变量，或者调用EXPORT的函数或任务，那么需要Context修饰符。

// SystemVerilog side, test.sv

module top;

   import "DPI" context function void c_display();

   export "DPI" task sv_display;

   m1 m1_inst();

   m2 m2_inst();

   initial begin

     c_display();

   end

   task sv_display();

     $display("SV: top");

   endtask

endmodule

module m1;

   import "DPI" context function void c_display();

   export "DPI" task sv_display;

   initial begin

      c_display();

   end

   task sv_display();

      $display("SV: m1");

   endtask

endmodule

module m2;

   import "DPI" context function void c_display();

   export "DPI" task sv_display;

   initial begin

     c_display;

   end

   task sv_display();

      $display("SV: m2");

   endtask

endmodule

#include <svdpi.h>

extern int sv_display();

   void c_display() {

     io_printf("\nC: c_display\n");

     sv_display(); }

这个TB的执行结果如下：

C: c_display

SV: m1

C: c_display

SV: m2

C: c_display

SV: top

 

// SystemVerilog side, test.sv

module top;

   import "DPI" context function void c_display();

   export "DPI" task sv_display;

   m1 m1_inst();

   m2 m2_inst();

   initial begin

     #1;

     c_display();

   end

   task sv_display();

     $display("SV: top");

   endtask

endmodule

module m1;

import "DPI" context function void c_display();

   import "DPI" context function void mygetscope();

   export "DPI" task sv_display;

   initial begin

      mygetscope();

      c_display();

   end

   task sv_display();

     $display("SV: m1");

   endtask

endmodule

module m2;

   import "DPI" context function void c_display();

   export "DPI" task sv_display;

   initial begin

      #1;

      c_display;

   end

   task sv_display();

      $display("SV: m2");

   endtask

endmodule

 

#include <svdpi.h>

#include <vcsuser.h>

   extern int sv_display();

   svScope myscope;

   void mygetscope() {

      myscope = svGetScope();

   }

   void c_display() {

      svSetScope(myscope);

      io_printf("\nC: c_display\n");

      sv_display();

   }

这个TB的执行结果如下：

C: c_display

SV: m1

C: c_display

SV: m1

C: c_display

SV: m1

显然，在C函数中修改了Scope，那么sv_display将使用这个Scope中的导出任务。

2.       Pure
使用Pure的函数能够提高仿真效率。当函数的结果仅仅依赖它的输入参数时，可以使用pure修饰符，这样的函数是non_void类型的，他的参数没有output和inout类型。这样的函数不能进行任何文件操作，访问任何其余的变量。

3.       输入参数的方向。
可以是input，output，inout，不能是ref。

4.       函数的返回值
必须是简单类型。

1.2 导出的任务和函数

语法：

export "DPI" [c_identifier =] function name;

export "DPI" [c_identifier =] task name;

1.3 示例

#include <svdpi.h>

extern void abp_write(int, int);

void c_test(int base) {

  int addr, data;

  for(addr=base; addr<base+5; addr++) {

    data = addr * 100;

    apb_write(addr, data);

    printf("C_TEST: APB_Write :  addr = 0x%8x, data = 0x%8x\n",

addr, data);

  }

}

// SystemVerilog side, test.sv

import "DPI" context task c_test(input int base_addr);

program top;

  semaphore bus_sem = new(1);

    export "DPI" task apb_write;

  task apb_write(input int addr, data);

   bus_sem.get(1);

   #10 $display("VLOG : APB Write : Addr = %x, Data = %x  ", addr, data);

   bus_sem.put(1);

  endtask

    initial begin

    fork

      c_test(32&apos;h1000);

      c_test(32&apos;h2000);

    join

  end

endprogram



第3章 参数的传递

1.1 参数传递方式

Small value通过值传递，其他的类型通过引用传递，open array通过handle传递。在SV中定义为input的参数，在C的实现中，参数通过const修饰。

1.2 Data Type Mapping

SYSTEMVERILOG TYPE

 

Integer，32位有符号整数，4状态Verilog数据类型。Time，64位无符号整数，4状态Verilog数据类型。对于C中的4状态packed数组。

标量的bit，logic，reg数据类型映射C中的unaigned char。

Packed bit，logic，reg数据类型，映射C中的svBit，svLogic。

C INPUT TYPE

C OUTPUT TYPE

byte

char

char*

 

shortint

short int

short int*

int

int

int*

longint

long int

long int*

real

double

double*

shortreal

float

float*

chandle

const void*

void*

string

const char*

char**

string[n]

const char*

char**

bit

svBit

svBit*

logic / reg

svLogic

svLogic*

bit[N:0]

const svBitVec32*

svBitVec32*

logic[N:0]

 reg[N:0]

const svLogicVec32*

svLogicVec32*

open array []

const svOpenArrayHandle

svOpenArrayHandle


1.1.1 示例1

import "DPI" function void mydisplay(int a[2][2],logic b[4]);

void mydisplay(int a[2][2],svLogic b[4])

svLogic占用一个字节。C中的0，1，2，3分别对应Verilog中的0，1，z，x。

1.1.2 Chandle

// SystemVerilog side, test.sv

program p1;

chandle memory;

import "DPI" function chandle int_new(int size);

import "DPI" function void put_int_data(int size, chandle memory);

initial begin

int size = 10;

$display("SV: call DPI to allocate memory for %0d int",size);

memory = int_new(size);

$display("SV: call DPI to  initialize the memory for %0d int",size);

put_int_data(size,memory);

end

endprogram

#include <svdpi.h>

#include <stdlib.h>

#include <stdio.h>

int i;

void * int_new(int size) {

int *memory;

memory = (int *)malloc(size*sizeof(int));

printf("C/C++: allocate memory for %0d int in int_new\n",size);

return memory;

}

void put_int_data(int size,void* memory) {

int *temp;

temp = (int *) memory;

for(i=0;i<size;i++) {

temp[i]=i;

printf("C/C++: memory[%0d] is set to %0d\n",i,temp[i]);

  }

}

1.2 Packed Array Data Type Mapping

svBitVecVal表示2状态的值。svLogicVecVal表示4状态的值。这些值按照32位的数组来组织。

1.2.1 示例1

// SystemVerilog side, test.sv

program p1;

   logic[63:0] a;

   import "DPI" function void mydisplay(logic[63:0] a);

   initial begin

      a[31:0] = 32'b0;

      a[63:32] = 32'hffff_ffff;

      mydisplay(a);

   end

endprogram

#include <svdpi.h>

void mydisplay(const svLogicVec32 a[2]) {

   printf("a[0]=%x\n",a[0].d);

   printf("a[1]=%x\n",a[1].d);

}

1.2.2 示例2

// SystemVerilog side, test.sv

program p1;

   integer i;

   import "DPI" function void mydisplay(integer i);

   initial begin

      i = 32'h0000_0101;

      $display("SV: %h",i);

      mydisplay(i);

      i = 32'h0000_zzxx;

      $display("SV: %h",i);

      mydisplay(i);

   end

endprogram

#include <svdpi.h>

void mydisplay(svLogicVec32 *i) {

      io_printf("C: i.d is %d\n",i->d);

io_printf("C: i.c is %d\n",i->c);

}

1.2.3 示例3

Packed Struct

// SystemVerilog side, test.sv

program p1;

   typedef struct packed {bit[1:0] a; bit b; bit c;} ps;

   import "DPI" function void mydisplay(ps p);

   initial begin

      ps val1;

      val1 = 4'hb;

      mydisplay(val1);

   end

endprogram

#include <svdpi.h>

void mydisplay(svBitVec32 p) {

   printf("p is %x\n",p);

}



1.1 Open Array Data Type Mapping

开放的数组就是在SV中定义这个参数时，没有指定数组的深度，仅仅像这样子定义a[]。在C中，使用svOpenArrayHandle进行变量申明。对于Scalar变量，可以直接得到其指针，再操作数据。对于Packed变量，可以使用特定的函数进行访问。

int svLeft(const svOpenArrayHandle h, int d);

int svRight(const svOpenArrayHandle h, int d);

int svLow(const svOpenArrayHandle h, int d);

int svHigh(const svOpenArrayHandle h, int d);

int svIncrement(const svOpenArrayHandle h, int d);

int svSize(const svOpenArrayHandle h, int d);

int svDimensions(const svOpenArrayHandle h);

 

void *svGetArrayPtr(const svOpenArrayHandle);得到数组的指针。

int svSizeOfArray(const svOpenArrayHandle);数组的体积，按照字节计数。

void *svGetArrElemPtr(const svOpenArrayHandle, int indx1,...);

 

对packed array进行写操作的函数。

void svPutBitArrElemVecVal(const svOpenArrayHandle d, const svBitVecVal* s, int indx1, ...);

void svPutBitArrElem1VecVal(const svOpenArrayHandle d, const svBitVecVal* s, int indx1);

void svPutBitArrElem2VecVal(const svOpenArrayHandle d, const svBitVecVal* s, int indx1, int indx2);

void svPutBitArrElem3VecVal(const svOpenArrayHandle d, const svBitVecVal* s,int indx1, int indx2, int indx3);

void svPutLogicArrElemVecVal(const svOpenArrayHandle d, const svLogicVecVal* s, int indx1, ...);

void svPutLogicArrElem1VecVal(const svOpenArrayHandle d, const svLogicVecVal* s, int indx1);

void svPutLogicArrElem2VecVal(const svOpenArrayHandle d, const svLogicVecVal* s, int indx1, int indx2);

void svPutLogicArrElem3VecVal(const svOpenArrayHandle d, const svLogicVecVal* s, int indx1, int indx2, int indx3);

对packed array进行读操作的函数。

void svGetBitArrElemVecVal(svBitVecVal* d, const svOpenArrayHandle s, int indx1, ...);

void svGetBitArrElem1VecVal(svBitVecVal* d, const svOpenArrayHandle s, int indx1);

void svGetBitArrElem2VecVal(svBitVecVal* d, const svOpenArrayHandle s, int indx1, int indx2);

void svGetBitArrElem3VecVal(svBitVecVal* d, const svOpenArrayHandle s, int indx1, int indx2, int indx3);

void svGetLogicArrElemVecVal(svLogicVecVal* d, const svOpenArrayHandle s, int indx1, ...);

void svGetLogicArrElem1VecVal(svLogicVecVal* d, const svOpenArrayHandle s, int indx1);

void svGetLogicArrElem2VecVal(svLogicVecVal* d, const svOpenArrayHandle s, int indx1, int indx2);

void svGetLogicArrElem3VecVal(svLogicVecVal* d, const svOpenArrayHandle s, int indx1, int indx2, int indx3);

对标量开放数组的访问。

svBit  svGetBitArrElem  (const  svOpenArrayHandle  s,  int  indx1, ...);

svBit svGetBitArrElem1(const svOpenArrayHandle s, int indx1);

svBit  svGetBitArrElem2(const  svOpenArrayHandle  s,  int  indx1, int indx2);

svBit  svGetBitArrElem3(const  svOpenArrayHandle  s,  int  indx1, int indx2, int indx3);

svLogic svGetLogicArrElem (const svOpenArrayHandle s, int indx1, ...);

svLogic svGetLogicArrElem1(const svOpenArrayHandle s, int indx1);

svLogic svGetLogicArrElem2(const svOpenArrayHandle s, int indx1, int indx2);

svLogic svGetLogicArrElem3(const svOpenArrayHandle s, int indx1, int indx2, int indx3);

void svPutLogicArrElem (const svOpenArrayHandle d, svLogic value, int indx1, ...);

void svPutLogicArrElem1(const svOpenArrayHandle d, svLogic value, int indx1);

void svPutLogicArrElem2(const svOpenArrayHandle d, svLogic value, int indx1, int indx2);

void svPutLogicArrElem3(const svOpenArrayHandle d, svLogic value, int indx1, int indx2, int indx3);

void svPutBitArrElem (const svOpenArrayHandle d, svBit value, int indx1, ...);

void svPutBitArrElem1(const svOpenArrayHandle d, svBit value, int indx1);

void svPutBitArrElem2(const svOpenArrayHandle d, svBit value, int indx1, int indx2);

void svPutBitArrElem3(const svOpenArrayHandle d, svBit value, int indx1, int indx2, int indx3);

 

1.1.1 示例1  Two-Dimensional Open Array

// SystemVerilog side, test.sv

program p1;

   int a[6:1][8:3];

   import "DPI" function void mydisplay(inout int h[][]);

   initial begin

      for(int i=1;i<6;i++)

for(int j=3;j<8;j++) a[i][j]= i+j;

   mydisplay(a);

for(int i=1;i<6;i++)

   for(int j=3;j<8;j++) $display(a[i][j]);

   end

endprogram

#include <svdpi.h>

int i,j;

void mydisplay(svOpenArrayHandle h) {

   int lo1 = svLow(h,1);int hi1 = svHigh(h,1);

   int lo2 = svLow(h,2);int hi2 = svHigh(h,2);

   int *a;

   for(i=lo1;i<=hi1;i++)

      for(j=lo2;j<=hi2;j++) {

a =(int*)svGetArrElemPtr2(h,i,j);

printf("[%d][%d]=%d\n",i,j,*a);

*a = i*j;

      }

}

输出结果：这个例子，我有个疑问，当参数增加一个long long *p，这时的再对这个两维的数组进行访问就会出现奇怪的问题。C中维数变成1了，数组的大小还是正确的。目前不知道原因。

[1][3]=4

[1][4]=5

...

1.1.2 示例2

Example 26-16  Another Packed Array

// SystemVerilog side, test.sv

program p1;

   import "DPI" function void mydisplay(input bit[4:2] a[]);

   bit[4:2] a[8];

   initial begin

      for(int i=0;i<8;i++) a[i]= 15+i;

      for(int i=0;i<8;i++) $display("SV: a[%0d]",i,a[i]);

      mydisplay(a);

   end

endprogram

#include <svdpi.h>

int i;

void mydisplay(const svOpenArrayHandle a)

   {

      svBitVec32 c;

      int low = svLow(a,1);

      int high = svHigh(a,1);

      for(i=low;i<=high;i++) {

         svGetBitArrElemVec32(&c,a,i);

         printf("C: a[%d]=%d\n",i,c);

      }

   }

输出结果。

C: a[0]=7

C: a[1]=0

C: a[2]=1


sxlwzl
关注
  • 8
    点赞
  • 踩
  • 129
    收藏
    觉得还不错? 一键收藏
  • 1
    评论
专栏目录
c++ gdi修改dpi_SV DPI-C接口学习心得
weixin_39736379的博客
11-27 876
1、是什么？？DPI(Direct Programming Interface)，全称直接编程接口，是SV与其它语言(C/C++)交互的接口，基本上是唯一接口了。2、为什么？？说完是什么，那么我们可以考虑一下了，为什么需要这个接口呢？或者说为什么SV/UVM需要与其它语言产生交互呢？其实就是SV和C之间的一种转换关系。这就涉及到了一些应用场景，我们可以说几个看看。（1）我们知道，在模块级乃至子系统...
如何通过DPI-C连接Verilog/SystemVerilog和C/C++
poena的博客
05-09 5063
1. 在Verilog中调用C函数 首先：准备好纯C/C++代码。比如： #include <iostream> int helloFromCpp(int a) { // 0 is 0 // 1 is 1 // 2 is Z // 3 is X int a_int = a; cout << "(C++) a is " << a_int << endl; return 0; } 其次：在verilog调用C函数 module
IC开发——VCS基本用法
最新发布
飞鹤的程序员人生
05-28 3144
VCS是编译型verilog仿真器，处理verilog的源码过程如下：VCS先将verilog/systemverilog文件转化为C文件，在linux下编译链接生成可执行文件，在linux下运行simv即可得到仿真结果。VCS使用步骤，先编译verilog源码，再运行可执行文件：编译命令的格式：vcs sourcefile [compile_time_option] （编译选项用来控制编译过程）执行仿真命令格式：./simv [run_time_option]
DPI-C
punkchang88的博客
03-14 2627
What is DPI-C？ DPI-C 是systemverilog为了与其他语言（c/c++）进行交互而设计的机制，通过DPI-C可以完成： SV call C function C call SV function Example testbench.sv : module dpi_test; export "DPI-C" function sv_print; import "DPI-C" context function void c_print(); initial begi
基于DPI-C接口的systemverilog和C之间的动态数组传递
hungtaowu的博客
10-21 1422
sv和c之间的动态数组传递
数字IC仿真测试与C语言函数的DPI-C调用
weixin_39015789的博客
09-25 2875
数字IC仿真测试与C语言函数的DPI-C调用 在深入数字IC仿真设计后，经常需要用到C语言相关函数或任务的配合使用，在system verilog中引入了DPI(Direct Programming Interface） 能够更方便简洁的连接到C，C++或者其他编程语言进行连仿。只要使用import 声明就可以调用导入一个C程序，就像在调用System verilog 中的子函数function一...
DPI-C 进阶
shimly123456的博客
10-31 219
看起来 DPI-C 似乎并不只在 verilator 上起作用 下面这个网址包含了 一些 verilator 手册上没有的 DPI-C 用法，包括二维数组传递：svOpenArrayHandle https://blog.csdn.net/zhajio/article/details/109362408?ops_request_misc=%257B%2522request%255Fid%252...
dpi-enabled-ovs:使用 DPI 功能扩展 OVS
06-03
- **文档**：介绍如何编译、安装和配置 DPI 扩展的指南。 - **示例规则**：展示如何定义和应用 DPI 规则的样本文件。 - **测试用例**：用于验证功能正确性和性能的测试脚本。 - **Shell 脚本**：可能包含自动化构建...
超微 X12DAI-N6 主板用户手册
03-25
3. **安装指南**：仔细阅读主板安装指南，按照指导步骤正确安装处理器、内存等组件，避免因错误安装导致的故障。 4. **维护保养**：定期进行维护保养工作，确保系统的稳定运行。例如清理灰尘、检查散热器等。 5....
modelsim_DPI_SY与systemC的联合仿真.docx
06-04
在本例中，我们探讨的是如何使用Modelsim 2019通过DPI（Dynamic-Programming Interface）接口调用C函数进行混合仿真。以下是一个详细的步骤指南： 1. **安装Modelsim 2019**：首先，你需要安装Modelsim 2019。确保...
SV及UVM接口应用_systemverilog_dpi-c_uvm验证_UVM_UVMDPI_
09-29
我们本节谈DPI的应用将就着更简单直观的实际场景，来谈一谈如何满足那些习惯于写C测试的“老测试员”们，使得他们可以在C环境下写C测试用例，而无需关注与底层验证环境是否由UVM实现还是实际硬件去执行C的代码。
my_2.5.2.rar_VCS DPI_VC_hdrs.c_ncverilog_peacepr1_uvm实例
09-20
uvm实例，带dpi-c，vcs,ncverilog.questo
火龙果（redpitaya）开发板常用接口C语言开发指南（一）——环境配置（持续更新中）
01-06
——本人为《火龙果实战指南——搭建基于Zynq处理器的测量仪器与创新实践平台》一书的作者之一，为了便于各位快速上手火龙果开发板，现提供部分实战指南，包含环境配置、源码、效果等，供大家学习交流使用。...
你必须知道的495个C语言问题-高清扫描版300dpi
09-28
《你必须知道的495个C语言问题》是一本专为C语言学习者和开发者设计的指南，它涵盖了从基础概念到高级特性的广泛问题集合。这本书的高清扫描版300dpi提供了清晰的阅读体验，对于那些喜欢纸质书感觉但又希望方便电子...
verilog 通过DPI-C调用C 流水灯模拟
yvee的博客
12-21 803
verilog 通过DPI-C调用C简单示例
DPI-C SV与C语言数据类型映射
weixin_40634003的博客
03-10 4180
1、是什么？？ DPI(Direct Programming Interface)，全称直接编程接口，是SV与其它语言(C/C++)交互的接口，基本上是唯一接口了。 2、为什么？？ 说完是什么，那么我们可以考虑一下了，为什么需要这个接口呢？或者说为什么SV/UVM需要与其它语言产生交互呢？ 其实就是SV和C之间的一种转换关系。 这就涉及到了一些应用场景，我们可以说几个看看。 （1）我们知道，在模块级乃至子系统级的验证，使用SV就完全够用了，而在更上面的层级，例如系统级，多采用大量的C代码组成。那么为了完成.
[SV]SystemVerilog與C語言的接口（SystemVerilog DPI C++）
元直的博客
03-30 2552
SystemVerilog DPI C++ SystemVerilog DPI (Direct Programming Interface) is an interface which can be used to interface SystemVerilog with foreign languages...
通过DPI集成C++ model
weixin_41994704的博客
10-22 727
DPI：direct program interface 在仿真环境中集成C， C++模型是一个遇见的问题，下面展示如何集成C++ model. 虽然项目环境是E-language的,但是顶层文件tb.sv 是SV语言，这里是在tb.sv中通过DPI集成C++的方式。 在这里插入图片描述 ...
import "DPI-C"
07-28
import "DPI-C"是SystemVerilog中的一个导入声明，用于导入DPI-C接口。通过这个导入声明，可以在SystemVerilog中调用C语言编写的函数或方法。例如，可以使用import "DPI-C" function来导入C语言中的sin、round、floor和ceil函数，以便在SystemVerilog中使用这些函数进行数学运算。此外，还可以使用import "DPI-C" function来导入其他C、C++或SystemC编写的函数，以实现SystemVerilog与这些外部语言的交互。 #### 引用[.reference_title] - *1* *3* [systemverilog学习 --- DPI和结构体（语法完结）](https://blog.csdn.net/weixin_45614076/article/details/126536829)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_result","utm_medium":"distribute.pc_search_result.none-task-cask-2~all~insert_cask~default-1-null.142^v91^insert_down28v1,239^v3^insert_chatgpt"}} ] [.reference_item] - *2* [数字IC仿真测试与C语言函数的DPI-C调用](https://blog.csdn.net/weixin_39015789/article/details/101383149)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_result","utm_medium":"distribute.pc_search_result.none-task-cask-2~all~insert_cask~default-1-null.142^v91^insert_down28v1,239^v3^insert_chatgpt"}} ] [.reference_item] [ .reference_list ]
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值