DATAPATH UNASSIGN FUNCTIONS

Unassigns functions from an existing Datapath Region.

Syntax

          DA*TAPATH U*NASSIGN F*UNCTIONS
          N*AME regionName
          [S*ELECTED | F*NNAME functionNameList]

Arguments   

NAME regionName string
Required argument that specifies the name of the region that the functions are to be removed from. The 'regionName' must be the name as specified in the NAME option of the DATAPATH ADD REGION command that created the region.

SELECTED boolean
Optional argument to specify that the functions to remove from the region will be pre-selected by the user. This option cannot be used in conjunction with either the FNNAME or ALL options.

FNNAME functionName string [string [string ...]]
Optional argument to specify the function, or list of functions, to remove from the region. This option cannot be used in conjunction with the SELECTED option. The end of the function name list is denoted by either another keyword or the ending semi-colon ';'.

Note: If neither the SELECTED or FNNAME options are used, then by default, all functions of the region will be unassigned.

Description 

This command is an optional step that allows the user to remove functions from a previously created Datapath region in the design. When functions are removed from a region that region will automatically be retiled such that the boundary of the region will be modified to contain the remaining functions. This command is also called from the 'Modify Region' form in Silicon Ensemble to remove functions from the region currently being edited.


Examples

DATAPATH UNASSIGN FUNCTIONS NAME dpath1;
Removes all functions from the region 'dpath1'.

DATAPATH UNASSIGN FUNCTIONS NAME dpath2 SELECTED;
Removes all pre-selected functions from the region 'dpath2'.
 
DATAPATH UNASSIGN FUNCTIONS NAME dpath3 FNNAME I123 I124 I126;
Removes the functions I123, I124 and I126 from the region dpath3.


Related Commands

DATAPATH ADD REGION
DATAPATH MODIFY REGION
DATAPATH ASSIGN FUNCTIONS


Form to Command Line Mapping:

Datapath->Modify Region... -> DATAPATH UNASSIGN FUNCTIONS

The callback from the 'Remove Functions (All Assigned, Selected)' buttons on the form will map to the command arguments as shown below.

Region Name -> NAME
Remove Functions
Selected -> SELECTED


Taking the form values below as an example.

Region Name: dpath1
Remove Functions: All Assigned

The command line would look like -
DATAPATH UNASSIGN FUNCTIONS NAME dpath1;

