Implementation of the in-order comparison algorithm for N queues. More...

Inheritance diagram for cl_syoscb_compare_io:

Collaboration diagram for cl_syoscb_compare_io:

Public Attributes
cl_syoscb_item	primary_item
	Scoreboard wrapper item from the primary queue.

Protected Member Functions
virtual void	primary_loop_do ()
	Compare Strategy API: Implementation of the in-order comparison algorithm. More...

virtual void	count_producers (string producer="")
	Compare Strategy API: Checks if the producer of the current item exists in all other queues, and whether all other queues have at least 1 item from that producer. More...

virtual void	secondary_loop_do ()
	Compare Strategy API: Loop through all the secondary queues, checking if the first item in that secondary queues matches the first in the primary queue. More...

virtual void	primary_loop_do ()
	Compare Strategy API: Loop over the primary queue, selecting primary items to compare against items in the secondary queues. More...

virtual void	count_producers (string producer="")
	Compare Strategy API: Checks if the producer of the current item exists in all other queues, and whether all other queues have at least 1 item from that producer. More...

virtual void	secondary_loop_do ()
	Compare Strategy API: Loop over all secondary queues to find a match for the primary item. More...

Protected Member Functions inherited from cl_syoscb_compare_base
virtual void	init ()
	Compare Strategy API: Executes some preliminary common operations before starting comparisons: Split queues into primary and secondary Create iterator for the chosen primary queue

virtual void	compare_do_greed (t_scb_compare_greed greed)
	Compare Strategy API: Try to remove a match and drain all the potential remaining matches inside the queues according to the greed level given as argument. More...

virtual void	compare_init ()
	Compare Strategy API: Verifies if the conditions for starting a compare are met: Verify that all queues currently contain at least one element Verify that all queues have at least one element from the same producer as the producer returned by get_count_producer() (the primary item being searched for) If the conditions are met then go variable is triggered, and the compare process can start. More...

virtual void	compare_do ()
	Compare Strategy API: Starts the actual comparison operation Perform initialization on the primary queue, if necessary Start the primary queue loop

virtual string	get_primary_queue_name ()
	Compare Strategy API: Gets the name of this scoreboard's primary queue. More...

virtual void	split_queues ()
	Compare Strategy API: Splits the scoreboard's queues into 1 primary queue and N-1 secondary queues. More...

virtual void	check_queues ()
	Compare Strategy API: Check if any queue is empty. More...

virtual void	create_primary_iterator ()
	Compare Strategy API: Creates the iterator for the primary queue and sets the pointer to its first element

virtual void	primary_loop_init ()
	Compare Strategy API: Contains all the operations to be executed immediately before starting the primary loop. More...

virtual void	static_queue_split_do ()
	Compare Strategy API: Splits queues into primary and secondary when a primary queue has been specified. More...

virtual void	dynamic_queue_split_do ()
	Compare Strategy API: Splits queues into primary and secondary when a primary queue has not been specified. More...

virtual bit	delete ()
	Compare Strategy API: Deletes matched items from the primary and all secondary queues if a match was found. More...

virtual string	get_count_producer ()
	Compare Strategy API: Returns the name of the producer that the compare method should evaluate in order to verify if it makes sense to start a comparison. More...

virtual int unsigned	get_queues_item_cnt ()
	Compare Strategy API: Gets the total number of items in all the queues at the moment of the function call. More...

Additional Inherited Members
Public Member Functions inherited from cl_syoscb_compare_base
virtual void	compare_control (bit cc)
	Compare API: Toggle comparisons on or off More...

virtual void	compare_trigger (string queue_name="", cl_syoscb_item item=null)
	Compare API: Starts a comparison by calling compare_main if comparisons are not disabled. More...

virtual void	compare_main (t_scb_compare_greed greed)
	Compare API: Main function that contains all the actual compare operations requested by the compare algorithm. More...

virtual void	set_cfg (cl_syoscb_cfg cfg)
	Set the scoreboard configuration associated with this comparer's scoreboard. More...

virtual cl_syoscb_cfg	get_cfg ()
	Gets the scoreboard configuration object associated with this scoreboard.

virtual string	generate_miscmp_table (cl_syoscb_item primary_item, cl_syoscb_item secondary_item, string sec_queue_name, uvm_comparer comparer, string cmp_name)
	Generates a side-by-side comparison of the seq. More...

virtual void	do_copy (uvm_object rhs)
	Custom do_dopy implementation for secondary queues.

Protected Attributes inherited from cl_syoscb_compare_base
cl_syoscb_cfg	cfg
	Handle to the configuration object.

bit	do_split = 0b1
	Indicates how queues should be split into a primary queue and array of secondary queues. More...

bit	go = 0b1
	Indicates whether a comparison can be started (1) or not (0)

bit	disable_compare = 0b0
	If set to 1'b1, no comparisons are performed. If 1'b0, comparisons are executed.

string	primary_queue_name
	Name of primary queue.

cl_syoscb_queue_base	primary_queue
	Handle to primary queue.

string	secondary_queue_names []
	Names of secondary queues.

cl_syoscb_queue_base	secondary_queues []
	Handles to secondary queues.

cl_syoscb_proxy_item_base	secondary_item_found [string]
	Associative array used to indicate if a matching item was found in a secondary queue. More...

cl_syoscb_proxy_item_base	primary_item_proxy
	Proxy item for the item being searched for in all secondary queue.

cl_syoscb_queue_iterator_base	primary_queue_iter
	Iterator into primary queue.

string	current_queue_name
	Name of the queue currently being searched.

cl_syoscb_item	current_item
	Handle to the item passed in by cl_syoscb::add_item.

Detailed Description

Implementation of the in-order comparison algorithm for N queues.

Definition at line 2 of file cl_syoscb_compare_io.svh.

Member Function Documentation

◆ count_producers() [1/2]

void cl_syoscb_compare_io::count_producers ( string producer = "" )

protectedvirtual

Compare Strategy API: Checks if the producer of the current item exists in all other queues, and whether all other queues have at least 1 item from that producer.

If true, assigns 1'b1 to member variable go If false, assigns 1'b0 to member variable go

Parameters

producer The producer to check if exists in all other queues. If not set, checks if the producer of current_item exists in other queues. If set, checks for that producer in other queues.

Reimplemented from cl_syoscb_compare_base.

Definition at line 63 of file cl_syoscb_compare_io.svh.

◆ count_producers() [2/2]

virtual void cl_syoscb_compare_io::count_producers ( string producer = "" )

protectedvirtual

Compare Strategy API: Checks if the producer of the current item exists in all other queues, and whether all other queues have at least 1 item from that producer.

If true, assigns 1'b1 to member variable go If false, assigns 1'b0 to member variable go

Parameters

producer The producer to check if exists in all other queues. If not set, checks if the producer of current_item exists in other queues. If set, checks for that producer in other queues.

Reimplemented from cl_syoscb_compare_base.

◆ primary_loop_do() [1/2]

void cl_syoscb_compare_io::primary_loop_do ( )

protectedvirtual

Compare Strategy API: Implementation of the in-order comparison algorithm.

In the primary loop, the algorithm extracts the oldest inserted element from the primary queue, and then starts looping over all secondary queues to find a matching item in secondary_loop_do. If matching items are found, these are removed from all of the queues If no matching items are found, a miscompare is generated and a UVM_ERROR is issued.

Reimplemented from cl_syoscb_compare_base.

Reimplemented in cl_syoscb_compare_io_2hp, and cl_syoscb_compare_io_2hp.

Definition at line 39 of file cl_syoscb_compare_io.svh.

References cl_syoscb_compare_base::cfg, cl_syoscb_queue_base::get_item(), cl_syoscb_cfg::get_scb_name(), cl_syoscb_queue_iterator_base::next(), primary_item, cl_syoscb_compare_base::primary_item_proxy, cl_syoscb_compare_base::primary_queue, cl_syoscb_compare_base::primary_queue_iter, cl_syoscb_compare_base::secondary_item_found, secondary_loop_do(), and cl_syoscb_string_library::sprint_item().

◆ primary_loop_do() [2/2]

virtual void cl_syoscb_compare_io::primary_loop_do ( )

protectedvirtual

Compare Strategy API: Loop over the primary queue, selecting primary items to compare against items in the secondary queues.

Note: Abstract method. This method must be implemented in a subclass.

Reimplemented from cl_syoscb_compare_base.

Reimplemented in cl_syoscb_compare_io_2hp, and cl_syoscb_compare_io_2hp.

◆ secondary_loop_do() [1/2]

void cl_syoscb_compare_io::secondary_loop_do ( )

protectedvirtual

Compare Strategy API: Loop through all the secondary queues, checking if the first item in that secondary queues matches the first in the primary queue.

If a match is found, this is recorded in cl_syoscb_compare_base::secondary_items_found

Reimplemented from cl_syoscb_compare_base.

Definition at line 74 of file cl_syoscb_compare_io.svh.

References cl_syoscb_compare_base::cfg, cl_syoscb_queue_base::create_iterator(), cl_syoscb_queue_iterator_base::first(), cl_syoscb_compare_base::generate_miscmp_table(), cl_syoscb_cfg::get_comparer(), cl_syoscb_cfg::get_default_comparer(), cl_syoscb_queue_base::get_item(), cl_syoscb_queue_base::get_iterator(), cl_syoscb_item::get_producer(), cl_syoscb_cfg::get_scb_name(), cl_syoscb_queue_iterator_base::next(), primary_item, cl_syoscb_compare_base::primary_queue_name, cl_syoscb_compare_base::secondary_item_found, cl_syoscb_compare_base::secondary_queue_names, cl_syoscb_compare_base::secondary_queues, and cl_syoscb_string_library::sprint_item().