removePortGroup

R2026b

Remove port group mapping from svdpiConfiguration or DPICustomTemplateConfiguration object

Since R2023a

Syntax

removePortGroup(cfg,groupName)

Description

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

removePortGroup(cfg,groupName) removes a port group named name from a svdpiConfiguration or DPICustomTemplateConfiguration object.

Examples

Add and Remove Ports from Scoreboard

Create a configuration object using the UVM scoreboard template. Then add port groups to the object:

• inFromMon — monitor inputs to the scoreboard

• inFromPred — predictor inputs to the scoreboard

• inErrorThreshold — configuration inputs to the scoreboard

c = svdpiConfiguration('uvm-scoreboard');
addPortGroup(c, 'MONITOR_INPUTS','inFromMon'); % single input
addPortGroup(c, 'PREDICTOR_INPUTS',{'inFromPred1','inFromPred2'}); % array of 2 ports
addPortGroup(c, 'CONFIG_OBJECT_INPUTS',inErrorThreshold);

Now, remove the configuration port group from the object:

c.removePortGroup('CONFIG_OBJECT_INPUTS');

Add and Remove Ports from Predictor

Create a configuration object using the UVM predictor template. Then add port groups to the object:

• inFromMon — monitor inputs to the predictor

• inErrorThreshold — configuration inputs to the predictor

c = svdpiConfiguration('uvm-predictor');
addPortGroup(c, 'PREDICTOR_INPUTS','inFromMon'); % single input
addPortGroup(c, 'CONFIG_OBJECT_INPUTS',{'inErrorThreshold'});

Now, remove the configuration port group from the object:

c.removePortGroup('CONFIG_OBJECT_INPUTS');

You can configure or remove port groups from the UVM sequence in the same way.

Input Arguments

cfg — SystemVerilog DPI configuration

svdpiConfiguration or DPICustomTemplateConfiguration object

SystemVerilog DPI configuration, specified as an svdpiConfiguration or DPICustomTemplateConfiguration object.

groupName — HDL port group name

string | character vector

Remove a port group from the object. Specify the name of the port group as a string or character vector.

Example: name='CONFIG_OBJECT_INPUTS'

Version History

Introduced in R2023a

R2026b: Function supports DPICustomTemplateConfiguration object

Remove port group from custom template. Use with DPICustomTemplateConfiguration object.