uvm设计分析——report

时间:2022-08-30 10:17:38

uvm_report实现中的类图,如下:

      uvm设计分析——report

  1)uvm_component均从uvm_report_object extend而来,其中定义了report_warning,error,info,fatal等方法接口;

  2)uvm_report_message和uvm_report_handle,是一个中介者的角色,实现调用接口和实现的分离;将report信息,

    打包成一个message的对象;并处理各种severity的override;

  3)uvm_report_server,实现该message具体的uvm_action;

  4)uvm_report_catcher,作为访问者,在tb top对某个id,serverity,verbosity的message进行处理,catch或throw;

uvm_report_object中实现了report的调用接口,以及report_handle的变量;

      uvm设计分析——report

    report_object和report_handle是绑定的关系,两者是互相composite的,object_report提供给用户的有两

类function:

    1)info,warning等调用function,其中verbosity在report_object中是被固定住的。

        error----uvm_low;

        fatal-----uvm_none;

           info、warning----uvm_medium;

      report是否被调用,还是要根据handle中的max_verbosity信息来确认的;

    2)对handle中变量的配置;每个report_object中的handle中的信息是不同的,所以区分调用report的component是

      很有必要的,

        所以sequence,默认使用m-sequencer来调用;

        port_base使用port_component来调用;

        其他默认使用uvm_root来调用;

其他的三个function:

    1)report_header,调用uvm_root的function,打印copyright信息;(uvm-root new的时候调用)

    2)report_summary,调用report_server的function,打印统计信息;

    3)die,当UVM_COUNT计数到一定值时,调用finish;

uvm_report_object:最终将report打包为message的格式,并将对象传递给handle;

handle拿到report对象,根据自己内部的override信息,将相应的信息,更新到message中;(就是severity的override信息)

handle中最重要的两个function:

    1)initial,在new的时候,调用,初始化severity对应的默认action,设置默认输出file为0,STDOUT;

      初始化max_verbosity_level为UVM_MEDIUM;

      uvm设计分析——report

    2)process_report_message,将message override处理后,交给server来处理;

几个重要的变量,数组或哈希:

    1)verbosity类;id_verbosities,severity_id_verbosities;

    2)actions类,id_actions,severity_actions,severity_id_actions;

    3)override类,sev_id_override,sev_overrid;

    4)file类;

report_server是一个virtual class,并且定义了pure function,默认使用的都是default_server,并且是singleton实例;

default_report_server,对信息执行相应的action,只有一个最重要的function:

    process_report_message:

      1)首选拿到目前的callback pool,uvm_report_cb中变量;uvm_report_catcher的对象;

      2)对于uvm_action为uvm_log或uvm_display的message,调用compose_message,打包格式;

      3)同一调用execute_report_message 的function;

          1)自加id和severity个数;

          2)uvm_display的message,调用$display function;

          3)uvm_log的message,调用fdisplay函数,需要除去STDOUT;

          4)uvm_count的message,自加quit_counter;

          5)uvm-exit的message,调用die function;

          6)uvm-stop的message,直接调用$stop;(该action,用的比较少)

三个主要的counter和一个变量:

      1)m_quit_counter;

      2)m_severity_counter;

      3)m_id_counter;

      4)m_max_quit_count;

还有一个general的function,report_summarize,打印各个counter的值;先调用catcher的summary;

以上的class中,在实现时,都是没有使用field_automation的,都是自己实现do_copy,do_print函数;

uvm_report_catcher,实现report的callback机制,uvm_pool被定义为uvm_report_cb,uvm_callback被extend为uvm_report_catcher;

核心处理函数,procee_report_catcher,提供接口catch() function来供用户extend,

        返回action_e类型enum------caught,throw,unknow_action;

        在返回值为throw的情况下,report会继续被server处理;

             caught的情况下,report不会继续被server处理;

catcher提供了足够的函数来进行message的删选;

      1)get_client,拿到调用的report_object;

      2)get_severity,拿到message的severity;

      3)get_verbosity,拿到message verbosity信息;

      4)get_id,拿到message id值;

      5)get_action,拿到message对应的action;

      6)get_filename,get_line,拿到对应的文件以及行号;

      相应的函数来进行message属性的修改;

      1)set_client,调用的report_object;

      2)set_severity,message的severity;

      3)set_verbosity,message verbosity信息;

      4)set_id,message id值;

      5)set_action,message对应的action;

在catcher的过程中,统计caught和throw的fatal,error,warning的个数,供summary调用;

相关的macros:

1)分别定义uvm_file和uvm_line是否打印;REPORT_DISBALE_FILE、LINE;

2)`uvm_info、warning、error、fatal;

3)`uvm_info_context、warning、error、fatal,指定了object,不使用当前的object进行调用;

4)`uvm_message_begin,end,不建议直接使用,severity,verbosity需要自己设置;

5)`uvm_message_context_begin,end,同上,区别只是显示调用object的enable_report函数,

6)`uvm_info_begin,end,warning_begin,end,error_begin,end,fatal_begin,end,只是不需要指明severity;

7)指明obejct的info_context_begin等macros;

相应的使用;

1)在vcs或者ius的命令行加+UVM_VERBOSITY=***,通过uvm_root,递归的设置所有comp的verbosity,

      uvm设计分析——report

2)在相应的comp内部直接调用相应的设置verbosity或者其他属性的函数;

      uvm设计分析——report