UVM Field机制详解一：宏和用法介绍

别列兹喵

已于 2024-05-26 21:59:15 修改

阅读量810

点赞数 29

分类专栏： UVM 文章标签： systemverilog

于 2024-05-26 21:57:09 首次发布

本文链接：https://blog.csdn.net/y475351429/article/details/139217928

版权

UVM 专栏收录该内容

4 篇文章 7 订阅

订阅专栏

一简要

UVM Field机制，就是在环境中继承于object的类中定义一些变量，然后使用UVM自带的宏来注册这些变量，最后可以针对这些类使用内置方法，比如copy,print,compare等。在UVM中是非常常见的使用方法。

二 field机制的使用方法

typedef enum{
        BLUE=0,
        RED =1
        }color_e;

//UVM中绝大部分类均继承于uvm_object，故继承于UVM内置类的子类均可调用uvm_field宏
class test_class extends uvm_transaction;
   int    aaa_int;
   string bbb_string;
   color_e color_enum;
   `uvm_object_utils_begin(test_class)
      `uvm_object_int(aaa_int            ,UVM_ALL_ON)
      `uvm_object_string(bbb_string      ,UVM_ALL_ON)
      `uvm_object_enum(color_e,color_enum,UVM_ALL_ON | UVM_NOPRINT)
   `uvm_object_utils_end
endclass

class test2_class;
  test_class test1;
  test_class test2;
  test1 = new();
  test2 = new();
  test1.print();
  test1.compare(test2);
  test1.copy(test2);
endclass

可以看到，在代码中定义了三种类型的变量，分别调用了不同的宏去注册。而在test2_class中，例化了这个类，然后通过test.print()等去调用这些方法，print是其中的一种方法，实际效果是将注册进去的类用一种格式打印出来。下面是uvm中内置的filed机制的所有方法和使用说明。

UVM field机制方法
方法名	使用方法	介绍(其中成员均指注册的成员)
copy	tr1.copy(tr2);	将tr2中的成员变量值复制到tr1中，两个对象均需要实例化
clone	$cast(tr1,tr2.clone())；	将tr2中的成员变量值复制到tr1中，其中tr2需要实例化，tr1不需要实例化，clone不能直接使用=赋值，必须使用cast,具体原因可看后续copy章节。
compare	tr1.compare(tr2)；	将tr1中的成员与tr2中的成员进行比较，两个对象均需要实例化
print	tr1.print()；	将tr1中的成员按照标准格式打印出来，打印内容包括类型，名字，值等。
pack	tr1.pack(pack_out);	将tr1中的所有成员，按bit打包成bit数组，其中pack_out是bit类型的动态数组。
pack_bytes	tr1.pack_bytes(pack_out);	将tr1中的所有成员，按bit打包成byte数组，其中pack_out是无符号byte类型的动态数组。
pack_int	tr1.pack_ints(pack_out);	将tr1中的所有成员，按bit打包成int数组，其中pack_out是无符号int类型的动态数组。
unpack	tr1.unpack(pack_in);	将bit类型的动态数组还原乘tr1中的所有成员,其中pack_in是bit类型的定宽数组（或new之后的动态数组）。
unpack_bytes	tr1.unpack_bytes(pack_in);	将byte类型的动态数组还原乘tr1中的所有成员,其中pack_in是无符号byte类型的定宽数组（或new之后的动态数组）。
unpack_int	tr1.unpack_ints(pack_in);	将int类型的动态数组还原乘tr1中的所有成员,其中pack_in是无符号int类型的定宽数组（或new之后的动态数组）。
record	tr1.tr_handle=1; tr1.record();	将tr1中的所有成员按照格式打印到文件中。和其他方法不同，在使用record的时候不能注册之后直接使用，必须先将tr_handle参数置一，具体原因可看后续record章节。

三 field机制的注册宏

在成员的注册时，使用的宏一般需要传入两个参数，一个是成员的名字，另一个是注册的flag。flag表示对应成员的功能启动与否，是一种简单的对于方法的控制手段。先介绍一下flag。

3.1 flag

由源码可以看出，flag是一个15bit（或者更大）的数，每一个bit表示一个状态，有三个parameter在该版本可以表示所有功能均开启，即UVM_DEFAULT, UVM_ALL_ON, UVM_FLAGS_ON。比较常用的是UVM_ALL_ON, UVM_DEFAULT比其他parameter多一个bit，是为了后续功能增加的预留项。现在的版本，用UVM_ALL_ON是足够的。

实际上，在FLAG中真正生效的是1,3,5...bit，也就是UVM_NO*的parameter。置1为有效，即关闭相关功能。所以输入0和输入UVM_ALL_ON的效果是一致的。不过为了避免产生歧义，还是建议使用UVM_ALL_ON。

由于flag是一个常数，所以在需要关闭某些功能的时候，可以在调用宏时，传入下面这样的参数即可。UVM_ALL_ON | UVM_NORECORD ,若是要关闭更多功能，可以在后面或上更多位。

3.2 注册宏

1.基础类

注册类别	注册宏
整形	`uvm_field_int(ARG,FLAG)
浮点	`uvm_field_real(ARG,FLAG)
object（uvm_object的子类）	`uvm_field_object(ARG,FLAG)
事件	`uvm_field_event(ARG,FLAG)
字符串	`uvm_field_string(ARG,FLAG)
枚举	`uvm_field_enum(T,ARG,FLAG)

基础类包括int，real，oject，event，string类型，传入的参数都是两个，第一个ARG是变量的名字，第二个则是前面说的flag。

还有一个是枚举类型，在类中定义枚举类型时，若需要注册，则必须先使用typedef定义一个枚举类型的变量类型。然后在类中使用该枚举类型去定义一个变量。而在注册时，需要将该枚举类型作为参数传入，即宏中的T。

2.定宽数组

注册类别	注册宏
int类型的定宽数组	`uvm_field_sarray_int(ARG,FLAG)
object类型的定宽数组	`uvm_field_sarray_object(ARG,FLAG)
string类型的定宽数组	`uvm_field_sarray_string(ARG,FLAG)
enum类型的定宽数组	`uvm_field_sarray_enum(T,ARG,FLAG)

定宽数组的参数类别比基础类要少一些，但是传入的参数和基础类的一致，另外值得一说的是，enum类型的定宽数组也必须传入三个参数。在白皮书中写的是与其他定宽数组一样的两个参数，这是错误的。

注:白皮书上写错的原因是，源码中在写在前面的枚举数组宏确实只传入了两个参数，但是该部分的宏是不做使用的，用一个UVM_EMPTY_MACROS控制关闭了，若是不定义该宏，实际使用的是在后面的宏定义，该部分只是对所有注册宏做一个列举。具体可以看源码中的uvm_object_defines.svh文件。

3. 动态数组

注册类别	注册宏
int类型的动态数组	`uvm_field_array_int(ARG,FLAG)
object类型的动态数组	`uvm_field_array_object(ARG,FLAG)
string类型的动态数组	`uvm_field_array_string(ARG,FLAG)
enum类型的动态数组	`uvm_field_array_enum(T,ARG,FLAG)

该部分与定宽数组一致，故不做说明，只做列举。

4. 队列

注册类别	注册宏
int类型的队列	`uvm_field_queue_int(ARG,FLAG)
object类型的队列	`uvm_field_queue_object(ARG,FLAG)
string类型的队列	`uvm_field_queue_string(ARG,FLAG)
enum类型的队列	`uvm_field_queue_enum(T,ARG,FLAG)

该部分与定宽数组一致，故不做说明，只做列举。

5. 关联数组

注册类别	注册宏
int类型，key为string	`uvm_field_aa_int_string(ARG,FLAG)
int类型，key为int(有符号或无符号）	`uvm_field_aa_int_int(_unsigned)
int类型，key为integer(有符号或无符号）	`uvm_field_aa_int_int_integer(_unsigned)
int类型，key为byte(有符号或无符号）	`uvm_field_aa_int_byte(_unsigned)
int类型，key为shortint(有符号或无符号）	`uvm_field_aa_int_shortint(_unsigned)
int类型，key为longint(有符号或无符号）	`uvm_field_aa_int_longint(_unsigned)
字符串类型，key为int	`uvm_field_aa_string_int
object类型，key为int	`uvm_field_aa_object_int
int类型，key可选	`uvm_field_aa_int_key(KEY,ARG,FLAG)