TCL管理Vivado工程

TCL管理Vivado工程

工程结构
[图片]

[图片]

1. 项目目录

[图片]

  • config: 配置文件、coe文件等。
  • doc: 文档
  • fpga: 最后恢复的fpga工程目录
  • ip: ip文件
  • mcs: bit流文件等,方便直接使用
  • src: .v、.vh等源文件
  • tcl: 用来恢复工程的tcl脚本

2. 导出脚本文件

通过TCL Console 将目录切换到tcl目录。

  1. 生成新建工程tcl脚本
    在TCL Console执行

    write_project_tcl -use_bd_files {./project.tcl}
    
  2. 如果工程有bd文件,生成对应的tcl脚本用于恢复工程。
    ( 需要打开对应的bd文件,不打开会找不到)

    write_bd_tcl -no_ip_version {./bd.tcl}
    

    如果有多个bd文件,需要依次打开然后执行上述指令。
    -no_ip_version选项用于去除IP的版本信息,方便工程在高版本vivado中打开的情况。

  3. 生成IP文件脚本

    write_ip_tcl [get_ips ETH_RX_FIFO] {./ip.tcl}
    

    这里采用将原工程中ip的xci文件直接拷贝到ip目录中的方式。

  4. 添加仿真文件和约束文件
    将原工程的源文件、仿真文文件、约束文件拷贝到src目录下。
    [图片]

    • vcode中存放源文件
    • xdc中存放约束文件

3. 修改TCL脚本

3.1 project.tcl

  1. 修改工程路径
    将
    set origin_dir "."
    修改为
    set origin_dir [ file dirname [ info script ] ]  
    
  2. 修改_xil_proj_name_即可更改工程名字
    set _xil_proj_name_ "promanagement"
    
  3. 修改恢复后工程的存放路径( 这里希望生成的工程在fpga目录下)
    将
    # Create project
    create_project ${_xil_proj_name_} ./${_xil_proj_name_} -part xc7z020clg484-1
    修改为
    create_project ${_xil_proj_name_} ../fpga/${_xil_proj_name_} -part xc7z020clg484-1
    
  4. 修改block design相关的配置
    将
    set files [list \
     [file normalize "${origin_dir}/../../promanagement/promanagement.srcs/sources_1/bd/system/system.bd" ]\
     [file normalize "${origin_dir}/../../promanagement/promanagement.srcs/sources_1/bd/system/hdl/system_wrapper.v" ]\
     [file normalize "${origin_dir}/../../promanagement/promanagement.srcs/sources_1/new/top.v" ]\
    ]
    set imported_files [import_files -fileset sources_1 $files]
    
    # Set 'sources_1' fileset file properties for remote files
    # None
    
    # Set 'sources_1' fileset file properties for local files
    set file "system/system.bd"
    set file_obj [get_files -of_objects [get_filesets sources_1] [list "*$file"]]
    set_property -name "registered_with_manager" -value "1" -objects $file_obj
    修改为
    # Create block design
    source $origin_dir/bd.tcl
    
    # Generate the wrapper
    set design_name [get_bd_designs]
    make_wrapper -files [get_files $design_name.bd] -top -import
    set files [list \
        [file normalize "${origin_dir}/../src/vcode/top.v" ]\
    ]
    set imported_files [import_files -fileset sources_1 $files]
    
  5. 修改v文件配置
    在上一步的修改内容中实际上已经进行了配置
  6. 修改ip文件配置
    将
    set files [list \
     [file normalize "${origin_dir}/../../promanagement/promanagement.srcs/sources_1/ip/clk_wiz_0/clk_wiz_0.xci" ]\
    ]
    修改为
    set files [list \
     [file normalize "${origin_dir}/../ip/clk_wiz_0/clk_wiz_0.xci" ] \
    ]
    
  7. 修改约束文件配置
    将
    set file "new/top.xdc"
    set file_obj [get_files -of_objects [get_filesets constrs_1] [list "*$file"]]
    set file "[file normalize "$origin_dir/../../promanagement/promanagement.srcs/constrs_1/new/top.xdc"]"
    修改为
    set file "xdc/top.xdc"
    set file_obj [get_files -of_objects [get_filesets constrs_1] [list "*$file"]]
    set file "[file normalize "$origin_dir/../src/xdc/top.xdc"]"
    

3.2 bd.tcl

将
set list_projs [get_projects -quiet]
if { $list_projs eq "" } {
   create_project project_1 myproj -part xc7z020clg484-1
}
注释掉

4. 工程恢复

source project.tcl
### 使用 Git 管理 Vivado 工程的最佳实践 在使用 Git 管理 Vivado 工程时,需要明确哪些文件是版本控制的核心内容,哪些文件可以忽略。Vivado 生成的 FPGA 工程通常包含大量中间文件和生成文件,这些文件体积庞大,且可以通过脚本重新生成。因此,仅保留关键的设计源文件、约束文件、IP 核配置文件以及工程构建脚本是合理的做法。 #### 1. 需要纳入版本控制的文件 - **TCL 脚本**:用于重建工程的脚本(如 `prj_gen.tcl`)是必须保留的文件之一,因为整个工程可以通过运行该脚本重新生成[^2]。 - **设计源文件**:包括 Verilog 或 VHDL 源代码文件,这些是设计的核心内容。 - **约束文件**:例如 `.xdc` 文件,用于定义引脚分配和时序约束,是实现正确功能的关键。 - **IP 核配置文件**:如 `.xci` 和 `.xml` 文件,用于描述 IP 核的配置信息,这些文件不能通过脚本自动生成,必须保留[^2]。 - **仿真文件**:测试平台(testbench)和仿真脚本(如 `.do` 文件)也应纳入版本控制。 #### 2. 可以忽略的文件 - **综合与实现生成的中间文件**:包括 `.dcp`、`.bit`、`.bin`、`.ngc` 等,这些文件可以由源文件和脚本重新生成。 - **Vivado 自动生成的目录**:如 `project_1.srcs/`、`project_1.cache/`、`project_1.runs/` 等目录,这些目录包含综合、实现和仿真过程中生成的临时文件。 - **日志文件和调试文件**:如 `.log`、`.jou`、`.pb` 等,这些文件用于调试但不需长期保存。 #### 3. Git 忽略文件配置 可以通过 `.gitignore` 文件定义哪些文件或目录应被 Git 忽略。以下是一个适用于 Vivado 工程的 `.gitignore` 示例: ```bash # Vivado generated directories project_*.srcs/ project_*.cache/ project_*.runs/ # Bitstream and configuration files *.bit *.bin *.mcs *.prm # Synthesis and implementation files *.dcp *.edf *.ngc *.npl *.vpl # Log and journal files *.log *.jou *.pb # TCL project script prj_gen.tcl ``` #### 4. 提交与更新流程 在进行提交时,应确保只提交设计源文件、约束文件、IP 核配置文件和 TCL 脚本。可以使用以下 Git 命令提交更改: ```bash # 查看当前状态 git status # 添加所有修改的文件到暂存区 git add . # 提交更改到本地仓库 git commit -m "更新内容描述" # 推送更改到远程仓库 git push origin main ``` #### 5. 版本回退与恢复 如果需要回退到某个历史版本,可以通过 `git reflog` 查看提交记录,找到目标版本的哈希值,然后使用 `git reset --hard` 回退: ```bash # 查看历史操作记录 git reflog # 回退到指定版本 git reset --hard 版本号 ``` 通过这种方式,可以确保 Vivado 工程的版本管理更加高效、清晰,并且在需要时能够快速重建整个工程
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

暴风雨中的白杨

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值