uvm cmdline processor

参考资料:

1.《Practical UVM Step By Step with IEEE》chapter11;

2.《Practical UVM Step By Step with IEEE》chapter21.9;

3. uvm source code;

1.简介

(1) uvm cmdline processor是用来处理命令行信息的单实例类,便于将任意数量的参数传递到uvm环境中;

(2) uvm_cmdline processor有助于通过传递参数控制仿真以及debug uvm环境;

const uvm_cmdline_processor uvm_cmdline_proc = uvm_cmdline_processor::get_inst();

class uvm_cmdline_processor extends uvm_report_object;

  static local uvm_cmdline_processor m_inst;

  // Group: Singleton 

  // Function: get_inst
  //
  // Returns the singleton instance of the UVM command line processor.

  static function uvm_cmdline_processor get_inst();
    if(m_inst == null) 
      m_inst = new("uvm_cmdline_proc");
    return m_inst;
  endfunction
  ...
endclass

2.available global settings

(1)+UVM_DUMP_CMDLINE_ARGS:用于dump所有的命令行参数;

./simv +UVM_TESTNAME=wb_conmax_simple_cmdline_proc +UVM_DUMP_CMDLINE_ARGS +slave_adr_max=16777214 -l dump_cmdline.dat

(2)+UVM_TESTNAME=<class name>允许user指明哪个uvm_test或uvm_component会通过factory机制被实例化;

<sim command> +UVM_TESTNAME=read_modify_write_test

(3)+UVM_VERBOSITY=<verbosity>允许user指明所有uvm组件的初始冗余度阈值;

<sim command> +UVM_VERBOSITY=UVM_HIGH

(4)+UVM_TIMEOUT=<timeout>,<overridable>允许user指明global timeout时间;

<sim command> +UVM_TIMEOUT=200000,NO

(5)+UVM_MAX_QUIT_COUNT=<count>,<overridable>允许user设置UVM_EXIT action执行前,所能容忍的count action的最大数量;

<sim command> +UVM_MAX_QUIT_COUNT=5,NO

(6)+UVM_PHASE_TRACE:使能phase执行的追踪;

+UVM_PHASE_TRACE

(7)+UVM_OBJECTION_TRACE:使能objection的追踪;

+UVM_OBJECTION_TRACE

(8)+UVM_RESOURCE_DB_TRACE:使能resource_db访问的追踪;

+UVM_RESOURCE_DB_TRACE

(9)+UVM_CONFIG_DB_TRACE:使能config_db访问的追踪;

+UVM_CONFIG_DB_TRACE

3.控制仿真行为的命令行参数设置(与冗余度相关的,与严重性相关的,与配置相关的,与启动seq相关的,与重载相关的)

(1) +uvm_set_verbosity:+uvm_set_severity=<comp>,<id>,<current severity>,<new severity>用于重载冗余度;

<sim command> +uvm_set_severity=uvm_test_top.env0.*,BAD_CRC,UVM_ERROR,UVM_WARNING

(2) +uvm_set_action: +uvm_set_action=<comp>,<id>,<severity>,<action>用于设置指定组件指定id指定严重性级别信息对应的行为;

<sim command> +uvm_set_action=uvm_test_top.env0.*,_ALL_,UVM_ERROR,UVM_NO_ACTION

(3) +uvm_set_severity: +uvm_set_severity=<comp>,<id>,<current severity>,<new severity>用于重载指定组件指定id打印信息的严重性级别;

<sim command> +uvm_set_severity=uvm_test_top.env0.*,BAD_CRC,UVM_ERROR,UVM_WARNING

(4) +uvm_set_config_int:为指定组件的整型变量设置值;

 <sim command> +uvm_set_config_int=uvm_test_top.soc_env,mode,5

注1:通过+uvm_set_config_int传递的信息,由于+uvm_set_config_int等同于uvm_config_db#(uvm_bitstream_t)::set,所以,在uvc中采用uvm_config_db::get时,需要使用uvm_config_db#(uvm_bitstream_t)::set,而不是uvm_config_db#(int);

(5) +uvm_set_config_string:为指定组件的字符串类型变量设置值;

(6) +uvm_set_default_sequence:+uvm_set_default_sequence=<seqr>,<phase>,<type>设置default sequence;

<sim command> +uvm_set_default_sequence=path.to.sequencer,main_phase,seq_type

(7) +uvm_set_inst_override & +uvm_set_type_override

+uvm_set_inst_override=<req_type>,<override_type>,<full_inst_path>
+uvm_set_type_override=<req_type>,<override_type>[,<replace>]

4.debug switches

(1)+UVM_PHASE_TRACE

(2)+UVM_OBJECTION_TRACE

(3)+UVM_RESOURCE_DB_TRACE

(4)+UVM_CONFIG_DB_TRACE

5.uvm_cmdline_processor常用函数及示例

5.1常用函数

5.1.1 get_arg_values();

(1) get_arg_values的返回值是字符串类型的,

(2) 如果命令行传递一个整数,如+my_int=123456,通过get_arg_values将会得到字符串"123456",这不是一个整型宾亮; 需要采用atoi()函数对其进行转换;

5.2使用示例

(1) 声明uvm_cmdline_processor句柄,并通过get_inst例化;

(2) 调用uvm_cmdline_processor的函数获取命令行参数;

class A extends uvm_component;
    ...
    int slave_adr_max;
    ...
    function new(string name, uvm_component parent);
        super.new(name, parent);
    endfunction

    virtual function void build_phase(uvm_phase phase);
        uvm_cmdline_processor clp;
        string arg_values[$];
        clp=uvm_cmdline_processor::get_inst();
        void'(clp.get_arg_values("+slave_adr_max=", arg_values));
        slave_adr_max=arg_values[0].atoi();
        `uvm_info("CMDLINE_VALUE",$sformatf("slave_adr_max=%h",slave_adr_max),UVM_LOW)
    endfunction
endclass