How to integrate the UVM scoreboard

The UVM scorebaord is easily integrated into your existing testbench environment.

Compiling the UVM scoreboard

To get the UVM scoreboard compiled you need to add src/pk_syoscb.sv to your list of files that are compliled when compiling your testbench. How this is done is highly dependent on the verification environment since some environemnts compile everything into different libraries and some do not etc.

Accessing the UVM scoreboard from your own code

Once the UVM scoreboard is compiled with the veritication environment then it is accessible either by explicit scoping:

   class myclass;
     pk_syoscb::cl_syoscb my_new_scb;
     ...

or by importing the complte package into your scope:

   import pk_syoscb::*;

   class myclass;
     cl_syoscb my_new_scb;
     ...

Instantiating the UVM scoreboard

The UVM scoreboard itself needs to be instantiated along with the configuration object. The simplest way to to this is to add the UVM scorebaord and the configuration object to the UVM environment:

   import pk_syoscb::*;

   class cl_scbtest_env extends uvm_env;

     cl_syoscb     syoscb;   
     cl_syoscb_cfg syoscb_cfg;
    
     `uvm_component_utils_begin(cl_scbtest_env)
       `uvm_field_object(syoscb,     UVM_ALL_ON)
       `uvm_field_object(syoscb_cfg, UVM_ALL_ON)
     `uvm_component_utils_end
    
     ... 

   endclass: cl_scbtest_env

   function void cl_scbtest_env::build_phase(uvm_phase phase);
     super.build_phase(phase);
   
     this.syoscb_cfg = cl_syoscb_cfg::type_id::create("syoscb_cfg");
     this.syoscb = cl_syoscb::type_id::create("syoscb", this);
   
     ...
               
   endfunction: build_phase

Configuring the UVM scoreboard

The UVM scoreboard ocnfiguration object needs to be configured after it has been created. The following example shows how two queues Q1 and Q2 wit Q1 as the primary queue. Futhermore one producer P1 is added to both queues:

   function void cl_scbtest_env::build_phase(uvm_phase phase);
     super.build_phase(phase);
   
     this.syoscb_cfg = cl_syoscb_cfg::type_id::create("syoscb_cfg");
     this.syoscb = cl_syoscb::type_id::create("syoscb", this);
   
     this.syoscb_cfg.set_queues({"Q1", "Q2"});
     void'(this.syoscb_cfg.set_primary_queue("Q1")); 
     void'(this.syoscb_cfg.set_producer("P1", {"Q1", "Q2"})); 
               
     ...

   endfunction: build_phase

Factory overwrites

Finally, the wanted queue and compare algorithm implementation needs to be selected. This is done by facotry overwrites since they can be changed test etc.

The following queue implemenations are available:

1. Standard SV squeue (cl_syoscb_queue_std)

and the following compare alorithms are available:

1. Out-of-Order (cl_syoscb_compare_ooo)

The folloing example shows how they are configured:

   cl_syoscb_queue::set_type_override_by_type(cl_syoscb_queue::get_type(),              
                                              cl_syoscb_queue_std::get_type(),
                                              "*");

   factory.set_type_override_by_type(cl_syoscb_compare_base::get_type(),
                                     cl_syoscb_compare_ooo::get_type(),
                                     "*");