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的变量;
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;
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,
2)在相应的comp内部直接调用相应的设置verbosity或者其他属性的函数;