Implementation of the 2-queue, high speed in-order comparison algorithm. More...
Inheritance diagram for cl_syoscb_compare_io_2hp:
Collaboration diagram for cl_syoscb_compare_io_2hp:
Protected Member Functions | |
| virtual void | compare_do () |
| Compare Strategy API: Mandatory overwriting of the base class' do_compare method. More... | |
| virtual void | primary_loop_do () |
| Compare Strategy API: Selects the primary queue's first element, comparing it to the secondary queue's first element. More... | |
| virtual void | compare_do () |
Compare Strategy API: Starts the actual comparison operation
| |
| virtual void | primary_loop_do () |
| Compare Strategy API: Implementation of the in-order comparison algorithm. More... | |
| Protected Member Functions inherited from cl_syoscb_compare_io | |
| 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 | 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:
| |
| 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:
| |
| 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... | |
Protected Attributes | |
| cl_syoscb_queue_base | secondary_queue |
| Handle to the secondary queue. | |
| 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. | |
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. | |
| Public Attributes inherited from cl_syoscb_compare_io | |
| cl_syoscb_item | primary_item |
| Scoreboard wrapper item from the primary queue. | |
Detailed Description
Implementation of the 2-queue, high speed in-order comparison algorithm.
Definition at line 2 of file cl_syoscb_compare_io_2hp.svh.
Member Function Documentation
◆ compare_do()
|
protectedvirtual |
Compare Strategy API: Mandatory overwriting of the base class' do_compare method.
Here the actual in-order 2-queue compare is implemented.
The algorithm is a specialization of the normal in-order compare which handles N queues. Here, only 2 queues are allowed and the compare simply just checks if the first item in the primary queue matches the first item in the secondary queue. If not then a UVM error is issued.
Reimplemented from cl_syoscb_compare_base.
Definition at line 31 of file cl_syoscb_compare_io_2hp.svh.
References primary_loop_do(), cl_syoscb_compare_base::primary_loop_init(), and cl_syoscb_compare_base::secondary_queues.
◆ primary_loop_do() [1/2]
|
protectedvirtual |
Compare Strategy API: Selects the primary queue's first element, comparing it to the secondary queue's first element.
Does this without using secondary_loop_do, as no looping is required.
Reimplemented from cl_syoscb_compare_io.
Definition at line 44 of file cl_syoscb_compare_io_2hp.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(), cl_syoscb_compare_io::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::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().
Referenced by compare_do().
◆ primary_loop_do() [2/2]
|
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_io.
The documentation for this class was generated from the following files:
