Globals

async uvm.base.uvm_globals.run_test(test_name='', dut=None) None[source]

Convenience function for uvm_top.run_test(). See UVMRoot for more information.

Parameters
  • test_name (str) – Name of the test to run.

  • dut – DUT object from cocotb

uvm.base.uvm_globals.uvm_get_report_object()[source]

Returns the nearest UVMReportObject when called. For the global version, it returns UVMRoot.

uvm.base.uvm_globals.uvm_report_enabled(verbosity, severity=0, id='')[source]

Returns 1 if the configured verbosity in ~uvm_top~ for this severity/id is greater than or equal to ~verbosity~ else returns 0.

See also UVMReportObject.uvm_report_enabled.

Static methods of an extension of UVMReportObject, e.g. UVMComponent-based objects, cannot call uvm_report_enabled because the call will resolve to the UVMReportObject.uvm_report_enabled, which is non-static. Static methods cannot call non-static methods of the same class.

uvm.base.uvm_globals.uvm_report_info(id, message, verbosity=200, filename='', line=0, context_name='', report_enabled_checked=False)[source]
uvm.base.uvm_globals.uvm_report_error(id, message, verbosity=100, filename='', line=0, context_name='', report_enabled_checked=False)[source]
uvm.base.uvm_globals.uvm_report_warning(id, message, verbosity=100, filename='', line=0, context_name='', report_enabled_checked=False)[source]
uvm.base.uvm_globals.uvm_report_fatal(id, message, verbosity=0, filename='', line=0, context_name='', report_enabled_checked=False)[source]

These methods, defined in package scope, are convenience functions that delegate to the corresponding component methods in ~uvm_top~. They can be used in module-based code to use the same reporting mechanism as class-based components. See `UVMReportObject for details on the reporting mechanism.

Note: Verbosity is ignored for warnings, errors, and fatals to ensure users do not inadvertently filter them out. It remains in the methods for backward compatibility.

uvm.base.uvm_globals.uvm_process_report_message(report_message)[source]

This method, defined in package scope, is a convenience function that delegate to the corresponding component method in ~uvm_top~. See `UVMReportObject for details on the reporting mechanism.

uvm.base.uvm_globals.uvm_string_to_severity(sev_str, sev)[source]
uvm.base.uvm_globals.uvm_string_to_action(action_str, action)[source]
uvm.base.uvm_globals.uvm_is_match(expr: str, _str: str) int[source]

Returns 1 if the two strings match, 0 otherwise.

The first string, ~expr~, is a string that may contain ‘*’ and ‘?’ characters. A * matches zero or more characters, and ? matches any single character. The 2nd argument, ~str~, is the string begin matched against. It must not contain any wildcards.

uvm.base.uvm_globals.uvm_string_to_bits(string: str) int[source]

Converts an input string to its bit-vector equivalent.

uvm.base.uvm_globals.uvm_has_verilator() bool[source]
uvm.base.uvm_globals.uvm_has_icarus() bool[source]
async uvm.base.uvm_globals.uvm_wait_for_nba_region() None[source]

Task: uvm_wait_for_nba_region

Callers of this task will not return until the ReadWrite region, thus allowing other processes any number of NullTrigger`s to settle out before continuing. See `UVMSequencerBase.wait_for_sequences for example usage.

uvm.base.uvm_globals.get_cs()[source]
uvm.base.uvm_globals.uvm_is_sim_active() bool[source]

Returns true if a simulator is active/attached. Returns False for example when running unit tests without cocotb Makefiles.

uvm.base.uvm_globals.uvm_sim_time(units='NS') int[source]

Returns current simtime in the given units (default: NS)

Parameters

units (str) – PS, NS, US, MS or S

Returns

Simulation time in specified units

Return type

int

async uvm.base.uvm_globals.uvm_zero_delay()[source]
uvm.base.uvm_globals.uvm_check_output_args(arr: List[Any]) None[source]

Check that all args in the arr are lists to emulate the SV inout/output/ref args

Raises
  • TypeError – If any of the args is not a list

  • ValueError – If any of the args is not empty list