uvm设计分析——report
Posted _9_8
tags:
篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了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或者其他属性的函数；
以上是关于uvm设计分析——report的主要内容，如果未能解决你的问题，请参考以下文章
report源码分析——report_handle和report_server和report_catcher