以下是使用 Vivado Design Suite 时所需的命名约定。不满足这些命名约定可能对设计或工具引发潜在风险,并导致设计流程中出现不可预测的行为。
- 源文件名称必须以字母(A-Z 和 a-z)开头,并且只能包含字母数字字符(A-Z、a-z 和 0-9)以及下划线 (_)。
- 输出文件名称必须以字母(A-Z 和 a-z)开头,并且只能包含字母数字字符(A-Z、a-z 和 0-9)以及下划线 (_)。
- 工程名称必须以字母(A-Z 和 a-z)开头,并且只能包含字母数字字符(A-Z、a-z 和 0-9)以及下划线 (_)。
- 工程目录名称必须以字母(A-Z 和 a-z)开头,并且只能包含字母数字字符(A-Z、a-z 和 0-9)、波浪线 (~) 以及下划线 (_)。
警告:
Windows 操作系统对于路径长度存在 260 个字符的限制,这可能影响 Vivado 工具。为避免此问题,创建工程、定义 IP 或托管 IP 工程或者创建块设计时,请尽可能使用较短的名称和目录位置。
针对工程名称、文件名或目录名称不支持使用下列字符:
- ! # $ % ^ & * ( ) ` ; < > ? , [ ] { } ' " |
- 制表符 (\t)
- 回车符 (\r)
- 换行符 (\n)
- / 或 \(包含在目录名称或文件名中,而不是作为路径分隔符)
针对目录名称不支持使用下列字符:
- 。(作为终结字符的点)
针对文件名称或工程名称不支持使用下列字符:
- @注释: 在 Vivado IDE 中,针对新文件名称或新工程名称不支持使用 @ 字符。Vivado IDE 支持将磁盘上名称包含 @ 字符的现有文件添加到工程中。Vivado IDE 可打开工程名称包含 @ 字符的工程。您可使用 Tcl Console(Tcl 控制台)创建名称包含 @ 字符的工程。
重要: Windows 操作系统支持目录名称和文件名中包含空格。但您应避免使用空格,以便保留 Windows 与 Linux 操作系统之间的工程或文件的可移植性。
Vivado Design Suite 支持使用正斜杠 (/) 作为 Windows 和 Linux 平台的路径分隔符。仅在 Windows 平台上允许使用反斜杠 (\) 作为路径分隔符。
不支持在工程名称、文件名或目录名称中使用以上未明确提及的任何字符。