UVM基础之---Command-line Processor
提供一个厂商独立的通用接口命令行参数,支持分类:
1. 基本参数和值:get_args,get_args_matches
2. 工具信息:get_tool_name(),get_tool_version()
3. 支持从命令行设置各种UVM变量如冗长和配置设置积分和字符串类型: +uvm_set_config_int, +uvm_set_config_string
类:uvm_cmdline_processor:
这个类在模拟过程中提供一个命令参数接口,这个类应该是当成一个单例类使用,但这不是必须的。一个全局变量 uvm_cmdline_proc在初始化的时候创建,用于访问命令行提供的信息。也支持从命令行配置各种各样的UVM变量。
下面简单的分析下这个类的实现机制:首先这个类继承自uvm_report_object,是一个单态类。
protected string m_argv[$];
protected string m_plus_argv[$];
protected string m_uvm_argv[$]; 首先是基本的参数操作:
get_args(output string args[$]) 命令行的所有用于控制仿真状态的参数做成一个队列并返回。
get_plusargs(output string args[$]) :返回一个队列,包含所有用于启动仿真的附加参数。
get_uvm_args(output string args[$]) : 使用一个队列返回所有uvm参数。
get_arg_matches(string match, ref string args[$]) :这个函数加载所有匹配match string的参数到一个队列,并返回匹配的个数。如果表达式包含//扩展正则表达式,下面是一个例子:
//| string myargs[$]
//| initial begin
//| void'(uvm_cmdline_proc.get_arg_matches("+foo",myargs)); //matches +foo, +foobar
//| //doesn't match +barfoo
//| void'(uvm_cmdline_proc.get_arg_matches("/foo/",myargs)); //matches +foo, +foobar,
//| //foo.sv, barfoo, etc.
//| void'(uvm_cmdline_proc.get_arg_matches("/^foo.*\.sv",myargs)); //matches foo.sv
//| //and foo123.sv,
//| //not barfoo.sv.
function int get_arg_matches (string match, ref string args[$]);
`ifndef UVM_CMDLINE_NO_DPI
chandle exp_h = null;
int len = match.len(); //检查match的长度
args.delete();
if((match.len() > 2) && (match[0] == "/") && (match[match.len()-1] == "/")) begin//如果长度大于2 且包含//
match = match.substr(1,match.len()-2);//提取需要match的表达式
exp_h = uvm_dpi_regcomp(match);//使用dpi匹配满足表达式,
if(exp_h == null) begin
uvm_report_error("UVM_CMDLINE_PROC", {"Unable to compile the regular expression: ", match}, UVM_NONE);
return 0;
end
end
foreach (m_argv[i]) begin
if(exp_h != null) begin
if(!uvm_dpi_regexec(exp_h, m_argv[i]))
args.push_back(m_argv[i]);
end
else if((m_argv[i].len() >= len) && (m_argv[i].substr(0,len - 1) == match))
args.push_back(m_argv[i]);
end
if(exp_h != null)
uvm_dpi_regfree(exp_h);
`endif
return args.size();
endfunction get_arg_value(string match,ref string value):从args里面找到第一个满足match的参数,并返回对应的值
get_arg_values(string match, ref srring values[$]) : 从args里面找到所有满足match的参数,并返回一个值得队列。返回参数是匹配的个数。
function new(string name = ""); 用于收集命令行传来的参数,并保存到对应的队列里面
string s;
string sub;
int doInit=1;
super.new(name);
do begin
s = uvm_dpi_get_next_arg(doInit);
doInit=0;
if(s!="") begin
m_argv.push_back(s);
if(s[0] == "+") begin
m_plus_argv.push_back(s);
end
if(s.len() >= 4 && (s[0]=="-" || s[0]=="+")) begin
sub = s.substr(1,3);
sub = sub.toupper();
if(sub == "UVM")
m_uvm_argv.push_back(s);
end
end
end while(s!=""); 命令行调试:
1. +UVM_DUMP_CMDLINE_ARGS,允许用户dump所有的命令行参数发给report机制,在uvm_root里面实现
2. +UVM_TESTNAME= 指定需要从工厂里面创建的test,如果指定很多,则使用第一个。在uvm_root实现,通过run_test调用
3.+UVM_VERBOSITY= 指定message的冗余程度,在uvm_root实现,通过uvm_root:new()调用
4. +uvm_set_verbosity 允许用户在特定的phase对特定的message的冗余度进行调整
// ~+uvm_set_verbosity=<comp>,<id>,<verbosity>,<phase>~ and
// ~+uvm_set_verbosity=<comp>,<id>,<verbosity>,time,<time>~
+uvm_set_verbosity=uvm_test_top.env0.agent1.*,_ALL_,UVM_FULL,time,800
5. +uvm_set_action:指定对应的message的动作
+uvm_set_action=uvm_test_top.env0.*,_ALL_,UVM_ERROR,UVM_NO_ACTION
6. +uvm_set_severity : 指定对应message的严重等级:
7. +UVM_TIMEOUT=
8. +UVM_MAX_QUIT_COUNT 用于指定当出现几个ERROR就退出仿真
9. +UVM_PHASE_TRACE
10. +UVM_OBJECTION_TRACE
11. +UVM_RESOURCE_DB_TRACE
12. +UVM_CONFIG_DB_TRACE
13. 工厂替换参数:
// Variable: +uvm_set_inst_override
// Variable: +uvm_set_type_override
// ~+uvm_set_inst_override=<req_type>,<override_type>,<full_inst_path>~ and
// ~+uvm_set_type_override=<req_type>,<override_type>[,<replace>]~
//| <sim command> +uvm_set_type_override=eth_packet,short_eth_packet
14. 设置变量参数:
// Variable: +uvm_set_config_int
// Variable: +uvm_set_config_string
// ~+uvm_set_config_int=<comp>,<field>,<value>~ and
// ~+uvm_set_config_string=<comp>,<field>,<value>~