systemverilog中的DPI-C用例介绍

文章目录


前言

本文主要基于VCS内置的三个关于DPI-C的使用用例,记录一下DPI-C的使用方法。测试用例的路径为$VCS_HOME/doc/examples/testbench/sv/。测试用例包括:dpi_longint,dpi_packed_array,dpi_structure。


一、dpi_longint

这个例子主要介绍,利用DPI-C,在C代码中,修改SV中一个长整型的数据。在SV中,利用DPI-C,将长整型数据,通过指针传递到C函数中,并在C函数中进行修改打印,返回到SV时,数据已经被C修改。

如下为SV代码。

cpp 复制代码
program p1;
	longint i1;
	
	import "DPI" function void mydisplay(inout longint i1);
	initial begin
		i1=64'h1234_5678_9abc_def0;
		$display("SV: i1 is %0h",i1);
		mydisplay(i1);
		$display("SV(after DPI call): i1 is %0h",i1);
	end

endprogram

如下为C代码,函数的参数为指针类型,利用指针实现C代码与SV代码共享内存空间,从而实现C代码中,修改SV代码中的变量。

cpp 复制代码
#include "svdpi.h"
#include "vcsuser.h"

extern "C" {
	void mydisplay(long long *i1) {
		io_printf("C: size of long long is %0d bytes\n",sizeof(long long));
		io_printf("C: i1 is %llx\n",*i1);
		(*i1) = (*i1) * 2;	
		io_printf("C: change i1 to %llx\n",*i1);
		
	}
}

如下为仿真log,可以看到C代码中修改值后,回到SV中,该变量的值也发生了改变。

bash 复制代码
SV: i1 is 123456789abcdef0
C: size of long long is 8 bytes
C: i1 is 123456789abcdef0
C: change i1 to 2468acf13579bde0
SV(after DPI call): i1 is 2468acf13579bde0

二、dpi_packed_array

这个例子主要演示,将SV中的数组传递给C,并在C中进行使用。

下面为SV代码,对数组a进行初始化并打印,然后将a传递给C。

cpp 复制代码
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]=%0d",i,a[i]);
		mydisplay(a);
		
	end


endprogram

如下为C代码,利用svOpenArrayHandle接收SV传递过来的数组,通过svLow获取数组的最低索引,通过svHigh获取数组的最高索引,然后通过svGetBitArrElemVec32获取数组里边的值,并循环打印该数组。

cpp 复制代码
#include "vcsuser.h"
#include "svdpi.h"

extern "C" {

	void mydisplay(const svOpenArrayHandle a) {
		
		svBitVec32 c;

		int low = svLow(a,1);
		int high = svHigh(a,1);

		for(int i=low;i<=high;i++) {
			svGetBitArrElemVec32(&c,a,i);
			io_printf("C: a[%d]=%d\n",i,c);
		}
	}
}

如下为仿真结果。

bash 复制代码
SV: a[0]=7
SV: a[1]=0
SV: a[2]=1
SV: a[3]=2
SV: a[4]=3
SV: a[5]=4
SV: a[6]=5
SV: a[7]=6
C: a[0]=7
C: a[1]=0
C: a[2]=1
C: a[3]=2
C: a[4]=3
C: a[5]=4
C: a[6]=5
C: a[7]=6

三、dpi_structure

这个例子主要演示SV中的结构体,如何通过DPI-C传递到C代码中进行修改。

以下是SV代码,对SV中的结构体初始化打印后,传递给C。

cpp 复制代码
program p1;
	typedef struct {
		int a;
		int b;
	} mystruct;

	import "DPI" function void mydisplay(inout mystruct s1);
	mystruct s1;
	initial begin
		s1.a =10;
		s1.b =20;
		$display("SV: s1.a=%0d,s1.b=%0d",s1.a,s1.b);

		mydisplay(s1);
		$display("SV after DPI call: s1.a=%0d,s1.b=%0d",s1.a,s1.b);
	end 
	
endprogram

以下是C代码,参数传递是结构体指针。

cpp 复制代码
#include "stdio.h"
#include "svdpi.h"

extern "C" {

	typedef struct {
		int a;
		int b;
	}  mystruct;

	void mydisplay(mystruct *s1) {
		int s2;
		printf("C: gets values from SV, s1.a=%d, s1.b=%d\n",s1->a,s1->b);
		s1->a = 100;
		s1->b = 200;
		printf("C: set values,  s1.a=%d, s1.b=%d\n",s1->a,s1->b);
	}	
}

仿真结果如下:

bash 复制代码
SV: s1.a=10,s1.b=20
C: gets values from SV, s1.a=10, s1.b=20
C: set values,  s1.a=100, s1.b=200
SV after DPI call: s1.a=100,s1.b=200

四、相关参考

SV和C之间的参数索引表

4状态类型SV与C之间的对应关系

C中提供的队列访问函数。


总结

本文主要通过VCS自带的三个DPI-C测试用例,记录一下SV中DPI-C的使用方法。

相关推荐
爱学习的小邓同学27 分钟前
数据结构 --- 队列
c语言·数据结构
啟明起鸣7 小时前
【网络编程】简易的 p2p 模型,实现两台虚拟机之间的简单点对点通信,并以小见大观察 TCP 协议的具体运行
c语言·网络·tcp/ip·p2p
秋说12 小时前
【PTA数据结构 | C语言版】线性表循环右移
c语言·数据结构·算法
芯岭技术13 小时前
MS32C001-C单片机,32位ARM M0+内核,宽电压、低功耗、小封装。
c语言·arm开发·单片机
minji...15 小时前
数据结构 算法复杂度(1)
c语言·开发语言·数据结构·算法
秋说16 小时前
【PTA数据结构 | C语言版】在顺序表 list 的第 i 个位置上插入元素 x
c语言·数据结构·list
楼田莉子17 小时前
数据学习之队列
c语言·开发语言·数据结构·学习·算法
秋说17 小时前
【PTA数据结构 | C语言版】返回单链表 list 中第 i 个元素值
c语言·数据结构·list
双叶83618 小时前
(C++)任务管理系统(正式版)(迭代器)(list列表基础教程)(STL基础知识)
c语言·开发语言·数据结构·c++·list
七七七七0718 小时前
类与对象【下篇】-- 关于类的其它语法
c语言·开发语言·c++