DONT_TOUCH

DONT_TOUCH

DONT_TOUCH指示工具不优化用户层次结构、实例化组件或

信号，以便优化不会跨模块边界发生，或者消除

对象虽然这可以帮助进行布图规划、分析和调试，但它可以抑制

优化，导致更大、更慢的设计。

重要提示：Xilinx建议在RTL源文件中设置此属性。需要的信号

keep经常在读取XDC文件之前进行优化。因此，在RTL中设置此属性可确保

使用该属性。

DONT_TOUCH属性的工作方式与KEEP或KEEP_HIERARCHY相同；然而

与KEEP和KEEP_HIERARCHY不同，DONT_TOUCH被前向注释为位置和路线

以防止实现过程中的逻辑优化。DONT_TOUCH对的影响

各种对象如下：

•基本实例：不要删除该实例。但是，该工具可以连接或

断开实例的引脚。

•分层实例：不要删除实例或添加或删除的任何引脚

例子该工具可以连接或断开引脚，并优化内部的逻辑

hiearchical模块。但是，优化不能将逻辑移入或移出

分层模块。这是对实例的层次边界的约束。

提示：使用DONT_TOUCH应用程序注册层次实例的所有输出。

•分层网络：不要移除网络，也不要连接或断开网络上的任何引脚。

提示：在分层网络上，DONT_TOUCH将只保留它所连接的分层段，

因此，您需要将其附加到要保留的所有线段上。

在模块或实体的各个端口中不支持DONT_TOUCH。如果需要

保留将DONT_TOUCH放在模块本身上的特定端口，或者使用以下Vivado

合成设置：

flatten_hierarchy="无"

使用DONT_TOUCH、KEEP或KEEP_HIERARCHY时要小心。在其他情况下

属性与DONT_TOUCH冲突时，DONT_TOUCH属性优先。

适用对象

•此属性可以放置在任何信号、层次模块或基元实例上。

°单元格（get_Cells）

°网络（get_Nets）

价值观

•FALSE：允许跨层次结构进行优化。这是默认设置。

•TRUE：通过不允许跨层次结构进行优化来保留层次结构

边界保留实例化的组件或网络以防止其

优化出了设计。
Syntax
Verilog Syntax
Place the Verilog attribute immediately before the user hierarchy instantiation:
(* DONT_TOUCH = "{TRUE|FALSE}" *)
Verilog Syntax Example
// Preserve the hierarchy of instance CLK1_rst_sync
(* DONT_TOUCH = "TRUE" *) reset_sync #(
.STAGES(5)
) CLK1_rst_sync (
.RST_IN(RST | ~LOCKED),
.CLK(clk1_100mhz),
.RST_OUT(rst_clk1)
);
Wire Example
(* dont_touch = "true" *) wire sig1;
assign sig1 = in1 & in2;
assign out1 = sig1 & in2;
Module Example
(* DONT_TOUCH = "true|yes" *)
module example_dt_ver
(clk,
In1,
In2,
out1);
Instance Example
(* DONT_TOUCH = "true|yes" *) example_dt_ver U0
(.clk(clk),
.in1(a),
.in2(b),
out1(c));
VHDL Syntax
Declare the VHDL attribute as follows:
attribute DONT_TOUCH : string;
Specify the VHDL attribute as follows:
attribute DONT_TOUCH of name: label is "{TRUE|FALSE}";
Where
• name is the instance name of a user defined instance.
VHDL Syntax Example
attribute DONT_TOUCH : string;
-- Preserve the hierarchy of instance CLK1_rst_sync
attribute DONT_TOUCH of CLK1_rst_sync: label is "TRUE";
...
CLK1_rst_sync : reset_sync
PORT MAP (
RST_IN => RST_LOCKED,
CLK => clk1_100mhz,
RST_OUT => rst_clk1
);
XDC Syntax
set_property DONT_TOUCH {TRUE|FALSE} [get_cells < instance_name >]
set_property DONT_TOUCH {TRUE|FALSE} [get_nets < net_name >]
Where:
• instance_name is a leaf cell or hierarchical cell.
• net_name is the name of a hierarchical net.
XDC Syntax Example

Preserve the hierarchy of instance CLK1_rst_sync

set_property DONT_TOUCH TRUE [get_cells CLK1_rst_sync]

Preserve all segments of the hierarchical net named by the Tcl variables

set_property DONT_TOUCH [get_nets -segments $hier_net]