uvmfTestBenchConfiguration

Configure YAML generation from DPI component generation and its integration with UVMF

Since R2024a

Add-On Required: This feature requires the ASIC Testbench for HDL Verifier add-on.

Description

The uvmfTestBenchConfiguration object controls the creation of a universal verification methodology framework (UVMF) complaint YAML file from the MATLAB^®-based DPI components.

Creation

Syntax

c = uvmfTestBenchConfiguration({svdpiConfiguration("uvmf-predictor"),svdpiConfiguration("uvmf-sequence")})

c = uvmfTestBenchConfiguration(testBenchKind,{svdpiObj1,svdpiObj2,...,svdpiObjn})

Description

c = uvmfTestBenchConfiguration({svdpiConfiguration("uvmf-predictor"),svdpiConfiguration("uvmf-sequence")}) creates a uvmfTestBenchConfiguration object to integrate DPI predictor and sequence components into the UVMF testbench. You can provide the svdpiConfiguration objects in the cell array in any order.

c = uvmfTestBenchConfiguration(testBenchKind,{svdpiObj1,svdpiObj2,...,svdpiObjn}) creates a uvmfTestBenchConfiguration object with the specified testBenchKind, or with the "default" testbench kind if none is specified. Provide any number of svdpiConfiguration objects according to the custom UVMF testbench YAML template.

Properties

Code Generation

SVDPIConfigurationContainer — Container of SystemVerilog DPI configuration objects

cell array of svdpiConfiguration objects

Container of the SystemVerilog DPI configuration objects, specified as a cell array of svdpiConfiguration objects. Use this property to generate and integrate DPI components into UVMF testbench.

Example: {pred, seq}

Data Types: cell array

BuildDirectory — Name of build directory

"uvmfbuild" (default) | string

Name of the build directory under which all the DPI components and YAML files generate, specified as a string.

Example: "C:/myDirectory"

Data Types: string

Testbench Type Information

UVMFTestBenchKind — Kind of UVMF testbench YAML to generate

"default" (default) | "custom"

Kind of UVMF testbench YAML to generate, specified as "default" or "custom".

• "default" — Generate a YAML file using the default testbench YAML template. In this kind, you can provide only one predictor component and one sequence component as arguments.

• "custom" — Generate a YAML file using the custom testbench YAML template that you provide. In this kind, you can provide multiple DPI components that are part of your custom UVMF testbench.

  To differentiate these custom DPI components in your custom UVMF testbench YAML, you can use unique template tags for input agent ports, output agent ports, and transaction vars in this format:

  %<gtd.MATLABFunctionName_INPUT_PORTS_DETAILS>,
  %<gtd.MATLABFunctionName_INPUT_TRANSACTION_VARS>,
  %<gtd.MATLABFunctionName_OUTPUT_PORTS_DETAILS>,
  %<gtd.MATLABFunctionName_OUTPUT_TRANSACTION_VARS>

  Where MATLABFunctionName is the name of the MATLAB function for which you want to generate the DPI component.

  To copy the YAML content corresponding to a custom DPI component, the template tag must be in this format:

  %<gtd.MATLABFunctionName_DPI_YAML>

  For an example, see Generate YAML from MATLAB Using Custom Template.

Example: "custom"

Data Types: string

TemplateDictionary — List of name and value pairs defined in template file

cell array of name-value pairs

List of name and value pairs defined in template file, specified as a cell array of the name-value pairs.

Each template file defines a template dictionary, which declares template-specific variables. Assign values to these variables as a cell array of variable names followed by values.

The template files expand tokens of the form %<Name> with Value. Names and values must be strings or character arrays.

Data Types: cell array

UVMFTestBenchYAMLTemplate — Template file to generate UVMF testbench YAML

character vector | string | cell array

Template file to generate the UVMF testbench YAML, specified as a character vector, string, or cell array.

Example: "C:/myDirectory/customyamltmplt.tlc"

Dependencies

To write this property, set the UVMFTestBenchKind property to "custom". Otherwise, this property is read-only.

Data Types: char | string | cell array

Object Functions

generateYAMLforUVMFTestBench

Generate YAML for complete UVMF testbench using template engine

Examples

Create uvmfTestBenchConfiguration Object and Integrate svdpiConfiguration Objects for MATLAB Functions

This example shows how to create a uvmfTestBenchConfiguration object and integrate two svdpiConfiguration objects for MATLAB functions.

Create Object for Default Testbench

Create uvmfTestBenchConfiguration object for the "default" UVMFTestBenchKind to use built-in UVMF testbench YAML template. Integrate svdpiConfiguration object of componentKind="uvmf-predictor" for a MATLAB function, mode_set_controller, and another svdpiConfiguration object of componentKind="uvmf-sequence" for a MATLAB function, mode_set_controller_test.

pred = svdpiConfiguration("uvmf-predictor"); 
pred.MATLABFunctionName = "mode_set_controller";
seq = svdpiConfiguration("uvmf-sequence"); 
seq.MATLABFunctionName = "mode_set_controller_test"; 
uvmfObject = uvmfTestBenchConfiguration({pred, seq});
generateYAMLforUVMFTestBench(uvmfObject);

Create Object for Custom Testbench

Create uvmfTestBenchConfiguration object for the "custom" UVMFTestBenchKind to use custom UVMF testbench YAML template, "custom_uvmf_test_bench.tlc". Integrate a single svdpiConfiguration object with componentKind="uvmf-sequence".

seq = svdpiConfiguration("uvmf-sequence"); 
seq.MATLABFunctionName = "chip_controller_test";
uvmfTestBenchKind = "custom";
uvmfObject = uvmfTestBenchConfiguration(uvmfTestBenchKind,{seq});
uvmfObject.UVMFTestBenchYAMLTemplate = "custom_uvmf_test_bench.tlc";
generateYAMLforUVMFTestBench(uvmfObject);

Generate YAML from MATLAB Using Custom Template

This example shows how to generate the YAML from MATLAB using a custom template.

Configure the UVMF testbench components that you want to include in the testbench. Create and configure the "uvmf-sequence" component.

seq = svdpiConfiguration("uvmf-sequence");
seq.MATLABFunctionName = "mode_set_controller_test";

Create and configure a "uvmf-custom" component.

custom1 = svdpiConfiguration("uvmf-custom");
custom1.MATLABFunctionName = "mode_custom1";

Create and configure another "uvmf-custom" component.

custom2 = svdpiConfiguration("uvmf-custom");
custom2.MATLABFunctionName = "mode_custom2"

Configure the UVMF testbench by passing the previously created testbench components.

uvmfTestBenchKind = "custom";
uvmfObject = uvmfTestBenchConfiguration(uvmfTestBenchKind, ...
{custom1,seq,custom2});

Assign the custom UVMF testbench template file to the uvmfTestBenchConfiguration object.

uvmfObject.UVMFTestBenchYAMLTemplate = 'myroot/custom_test_bench.tlc';

Generate the DPI component files along with the UVMF testbench YAML template.

generateYAMLforUVMFTestBench(uvmfObject);

For this example, you can use these template tags in a custom UVMF testbench YAML template:

%<gtd.mode_custom1_INPUT_PORTS_DETAILS>, 
%<gtd.mode_custom2_INPUT_PORTS_DETAILS>,
%<gtd.mode_custom1_INPUT_TRANSACTION_VARS>, 
%<gtd.mode_custom2_INPUT_TRANSACTION_VARS>,
%<gtd.mode_custom1_OUTPUT_PORTS_DETAILS>, 
%<gtd.mode_custom2_OUTPUT_PORTS_DETAILS>,
%<gtd.mode_custom1_OUTPUT_TRANSACTION_VARS>, 
%<gtd.mode_custom2_OUTPUT_TRANSACTION_VARS>,
%<gtd.mode_custom1_DPI_YAML>,
%<gtd.mode_custom2_DPI_YAML>

Tips

This object allows you to integrate the DPI components into the UVMF testbench. The UVMF code generator expects you to pass the DPI compilation flags to compile these DPI components. You can extract the DPI compilation flags by building the "info" target of the makefile that you generate using this object.

For example, use this command to build "info" target of the AbsVal_Blk.mk makefile.

make -f AbsVal_Blk.mk info

This log shows the compilation flags to pass to the UVMF code generator.

Version History

Introduced in R2024a