ADD REnaming Rule
[[-PIN_MULTIDIM_TO_1DIM] [-ADD | -NOADD]
[-NOASCEND | -ASCEND] [-VERBOSE] ]
[<rule_name> <string> <string> [[ -MAp ]
[-TYpe < PI | E | Z | DFf | DLat | CUt | BBox | PO>… |-NOTYpe <PI | E | Z | DFf | DLat | CUt | BBox | PO>…] |-MOdule
|-PIn [-BBox <module_name>] ]
[-REPlace]
[-Golden | -Revised | -BOth] ] (Setup / LEC Mode)
Specifies renaming rules for key point mapping, module renaming (when reading in the library and designs for hierarchical comparisons), and pin renaming for blackboxes
Use the REPORT RENAMING RULE command to display the list of all renaming rules. Conformal applies renaming rules sequentially, in the order they were added.
Key Point Mapping
When you define renaming rules in the Setup system mode, they guide the automatic mapping process that occurs during the system mode switch from Setup to LEC. When you are in the LEC system mode, and find that the key point mapping is not complete, define additional renaming rules and repeat key point mapping to improve the mapping results. The automatic mapping process refers to the naming specified by the final renaming rules.
Module Renaming
You must use this command before theREAD LIBRARY andREAD DESIGN commands. It helps map modules together for hierarchical comparisons.
Pin Renaming
Renaming Rule Structure
When defining renaming rules, the first string specifies the pattern to be matched; the second string specifies how Conformal is to rename or make substitutions. The first string can contain expressions of the following types:
Any character can be preceded by the escape character “\” to cancel any special meaning it has. Use the escape character whenever any of the following special characters represents a simple character.
% . * + ^ $ | ( ) [ ] \
The second string can contain expressions of the following types:
%d Matches one or more digits,[0-9]+
%a Matches one or more alphabetical characters,[a-zA-Z]+
%s Matches one or more digits or alphabetical characters,
[0-9a-zA-Z]+
%u Matches one or more alphabetical characters or underscores,
[a-zA-Z_]+
%w Matches one or more digits or alphabetical characters or
underscores,[0-9a-zA-Z_]+
x Matches character “x”
abc Matches string “abc”
. Matches any single character
* Matches zero or more repetitions of the preceding expression
+ Matches one or more repetitions of the preceding expression
^bol Matches “bol” only when it occurs at the beginning of a string
eol$ Matches “eol” only when it occurs at the end of a string
x|abc Matches “x” or “abc”
[oz!] Matches “o”, “z”, or “!”
(pattern) Matches anything that is matched by “pattern” and renders it referable (through@n) in the substitution string
The following table shows implementation examples for various pattern-matching and substitution strings. For pattern-matching strings, use parentheses to group individual patterns into a single pattern, as demonstrated in the example(ab|de)*.
@n Replaces the string that matches the nth%d,%a,%s, or a pattern enclosed in parentheses.
Thenis a digit other than0, and you can use@{nn}to refer to further matches (that is,10…99)
#(expr) Where “expr” is an arbitrary expression that can only contain constant integers,@n expressions, and the operators+,-,*,/
and( )
First String Second String Source Result
%a%d @1[@2] xyz123 xyz[123] %a_%d @1[@2] arr_5 arr[5] _z_ / _z_top_z_inst /top/inst ^abc XYZ abcabc XYZabc abc$ XYZ abcabc abcXYZ ^abc$ XYZ abcabc abcabc
^abc$ XYZ abc XYZ
[oz!] $ aaoaazaa!aa aa$aa$aa$aa \%d\%s AA %a%d%s%b %aAA%b
\(ab ZZ xx(abcd xxZZcd %s\.%d @1[@2] xx.123 xx[123] (x|abc) YY abcx abcx YYYY YYYY (ab|de)* YY ababdeab YY
%s%d @1[#(7-@2)] abc3 abc[4] %s%d @1[#(2*@2)] abc5 abc[10] reg%d\[%d\] reg[@2] reg2[5] reg[5]
Important
Do not include the forward slash, “/”, at the top level for either the first or second string.
For example, express/top_module/adder/reg[5] as
top_module/adder/reg[5].
Parameters
-PIN_MULTIDIM_TO_1DIM
Allows you to create renaming rules to map multidimensional array pins to one-dimensional array pins.
-ADD Shows the pins found when adding the rules into the system.
This is the default.
-NOADD Shows the pins found without adding the rules.
-NOASCEND Renames the pins in an descending order. This is the default.
-ASCEND Renames the pins in an ascending order.
-VERBOSE Shows the renaming patterns.
rule_name Specifies a rule identification name assigned to a specific renaming rule.
<string> <string> The first string represents the pattern to be matched. The second string represents the substitution pattern.
-MAp Specifies that the renaming rule applies to key point mapping.
This is the default.
-TYpe keypoint_type…
Renames all key points with the specified type. The available types are as follows:
PI Primary Inputs
E TIE-E gates
Z TIE-Z gates
DFF D flip-flops
CUT Artificial gates for breaking combinational feedback loops
BBOX Blackboxes
PO Primary Outputs
-NOTYpe keypoint_type…
Renames all key points except the specified types. The available types are as follows:
PI Primary Inputs
E TIE-E gates
Z TIE-Z gates
DFF D flip-flops
DLAT D-latches
CUT Artificial gates for breaking combinational feedback loops
BBOX Blackboxes
PO Primary Outputs
-MOdule Specifies that the renaming rule applies to module renaming when the library and design are read in.
-PIn Specifies that the renaming rule applies to pin names of blackboxes.
-BBox module_name Specifies that the pin renaming rules apply to the specified blackbox module.
-REPlace Allows the redefinition of an existing renaming rule.
Tip
The difference between usingadd renaming rule -replace as opposed to usingdelete renaming rule followed byadd renaming rule is that renaming rules that are redefined remain in the same position in the list of renaming rules. By deleting and adding a rule, the new definition will appear at the end of the list. In some cases, the order in which renaming rules are applied might affect the result.
Example
In the following command,y2[1:0][2:0] in moduletest2 is renamedy2[5:0]:
add renaming rule -pin_multidim_to_1dim // Rule created for (test2) y2[1:0][2:0] // Rule created for (test1) y1[1:0][1:0] // Rule created for (top) y2[1:0][2:0] // Rule created for (top) y1[1:0][1:0] // Rule created for (top) ym[2:3][2:0][1:0]
// 5 rules created. Rules for top module must be manually validated.
You can use theREPORT RENAMING RULE command to view the added rules.
Related Commands
CHANGE NAME
DELETE RENAMING RULE MAP KEY POINTS
READ DESIGN READ LIBRARY
REPORT RENAMING RULE SET MAPPING METHOD SET NAMING RULE TEST RENAMING RULE
-Golden Specifies that the renaming rule applies to the Golden design.
This is the default.
-Revised Specifies that the renaming rule applies to the Revised design.
-BOth Specifies that the renaming rule applies to both the Golden and Revised designs.