Import files and/or directories into the active fileset
Syntax
import_files [‑fileset <arg>] [‑force] [‑of_objects <args>] [‑norecurse]
[‑flat] [‑relative_to <arg>] [‑quiet] [‑verbose] [<files>...]
Returns
A list of file objects that were imported
Usage
Name | Description |
---|---|
[-fileset]
|
Fileset name |
[-force]
|
Overwrite files of the same name in project directory |
[-of_objects]
|
RMs to import the files to |
[-norecurse]
|
Disables the default behavior of recursive directory searches |
[-flat]
|
Import the files into a flat directory structure |
[-relative_to]
|
Import the files with respect to the given relative directory |
[-quiet]
|
Ignore command errors |
[-verbose]
|
Suspend message limits during command execution |
[<files>]
|
Name of the files to import into fileset |
Categories
Description
Imports one or more files or the source file contents of one or more directories to the specified fileset.
import_files
command to import a list of files:
import_files {file1 file2 file3 ... fileN}
This command is different from the add_files
command, which adds files by reference into the specified fileset. This command imports the files into the local project folders under project.srcs\<fileset>\imports and then adds the file to the specified fileset.
Arguments
-fileset
<name> - (Optional) The fileset to which the specified source files should be added. If the specified fileset does not exist, the tool will return an error. If no fileset is specified the files will be added to the source fileset by default.
-force
- (Optional) Overwrite files of the same name in the local project directory and in the fileset.
-norecurse
- (Optional) Do not recurse through subdirectories of any specified directories. Without this argument the tool will also search through any subdirectories for additional source files that can be added to a project.
-flat
- (Optional) Import all files into the imports folder without preserving their relative paths. By default the directory structure of files is preserved as they are imported into the design.
-relative_to
<arg> - (Optional) Import the files relative to the specified directory. This allows you to preserve the path to the imported files in the directory structure of the local project. The files will be imported to the imports folder with the path relative to the specified directory.
-relative_to
argument is ignored if the -flat
argument is also specified. The -flat
command eliminates the directory structure of the imported files.-quiet
- (Optional) Execute the command quietly, returning no messages from the command. The command also returns TCL_OK regardless of any errors encountered during execution.
-verbose
- (Optional) Temporarily override any message limits and return all messages from this command.
set_msg_config
command.Examples
import_files -fileset constrs_1 top.ucf
-fileset
argument is not specified. In addition, the -norecurse
argument restricts the tool to looking only in the specified \level1 directory and not searching any subdirectories. All valid source files will be imported into the \imports folder of the project because the -flat
argument has been specified.
import_files C:/Data/FPGA_Design/level1 -norecurse -flat
-flat
option a \level1 directory would be created inside of the \imports folder of the project.-fileset
argument is not specified. Valid source files are imported from the \level1 directory, and all subdirectories, and the files will be written into the \imports folder of the project starting at the \Data directory due to the use of the -relative_to
argument.
import_files C:/Data/FPGA_Design/level1 -relative_to C:/Data