<DATAPATHADDREGION 
"DATAPATH ADD REGION

Creates a datapath region to contain datapath functions.

Syntax

       DA*TAPATH AD*D RE*GION
       N*AME regionName
       [O*RIGIN pt1]
       [S*ELFUNCTIONS]
       [R*OWSPERBIT rowsPerBit]
       [FLIPROWS [FLIPROW0]]
       [BIT0ATT*OP];


Arguments

NAME regionName string
Required argument to specify the name of the region to be created.

ORIGIN pt1 point = (int int)
Optional argument to specify that the region origin is to be placed at the coordinate 'pt1'. If not specified, the region is placed at (0 0).

SELFUNCTIONS boolean
Optional argument specifying that only the selected functions should be assigned to the new region to be created. This overrides the default, which assigns all unassigned functions to the region.

ROWSPERBIT rowsPerBit float
Optional argument specifying the number of rows to be used by each bit of the functions in the region. The value 'rowsPerBit' is a positive number greater than zero. If this option is not specified the value defaults to 1.

FLIPROWS boolean
Optional argument specifying that every other row will be flipped, starting from bit 0, which by default will remain unflipped. The default, if this option is not specified, is that all rows will remain unflipped.

FLIPROW0 boolean
Optional argument specifying that row 0 will be flipped. This argument can only be specified with FLIPROWS. The default, if this option is not specified, is that row 0 will remain unflipped.

BIT0ATTOP boolean
Optional argument specifying that bit zero of the function should be placed at the top of the region. This overrides the default of bit zero being placed at the bottom of the region.

Description

This command is a necessary step that creates a datapath region in the design. The region can contain either all the functions in the design that have not been assigned to another Datapath region (default), or the functions that have been pre-selected before executing this command. At least one region is needed for using Datapath. The remaining options specify the various settings that the functions can have within the region. These options can also be set from the DATAPATH MODIFY REGION command.


Environment Variables

None


Examples

DATAPATH ADD REGION NAME dpath1 FLIPROWS;

Creates a region called 'dpath1' that contains all unassigned functions with its rows flipped, which has one (1) row per bit. Bit zero (0) will be at the bottom and the lower left corner, and it will be placed at (0 0).

DATAPATH ADD REGION NAME dpath2 SELECTED FLIPROWS FLIPROW0 BIT0ATTOP ORIGIN (200 10);

Creates a region called 'dpath2' placed at (200 10) that contains the pre-selected functions with flipped rows including row zero(0). Bit zero(0) will be at the top with one (1) row per bit.


Related Commands

DATAPATH MODIFY REGION
DATAPATH ASSIGN FUNCTIONS
DATAPATH UNASSIGN FUNCTIONS


Form to Command Line Mapping:

Datapath->Add Region... -> DATAPATH ADD REGION

The callback from this form will take the values and map them to the command arguments as shown below.

Region Name -> NAME
Functions to Assign -> SELFUNCTIONS
Rows Per Bit -> ROWSPERBIT
Region Origin -> ORIGIN
Bit Ordering -> BIT0ATTOP
Row Flipping -> FLIPROWS, FLIPROW0

Taking the form values below as an example.

Region Name: dpath1
Functions to Assign: selected
Rows Per Bit: 1 
Region Origin: X = 10, Y = 200
Bit Ordering: bit 0 at top
Row Flipping: flip every other row = (on), flip row 0 = (on)


The command line would look like -
DATAPATH ADD REGION NAME dpath1 ORIGIN (10 200) SELFUNCTIONS ROWSPERBIT 1 FLIPROWS FLIPROW0 BIT0ATTOP;"

	<Type QHELP>
	<Header "Datapath Add Region Command Help">
<beginAutoGen "** Do not edit from here to the endAutoGen tag **" >
	<Tag DPAddRegion
		<Toolname gsEnsemble>
		<Version 5.0>
		<Title "DP Add Region Form Help">
	>
<endAutoGen >
>

