Additional Tcl Scripts#

Warning

Outdated Documentation! This documentation version is out of date. Please check the latest version 2026.1.

Hog provides a series of Tcl scripts, which executes different common tasks. These scripts are located in ./Hog/Tcl/utils. To execute the scripts, you need to open first the Vivado Tcl Shell.

  vivado -mode tcl

Run each script with the -h option to see the full list of arguments/options and usage example.

Tip

Some of these scripts can be executed with tclsh. To do this, you need to install a package called “tcllib” available on yum and apt.

check_syntax.tcl#

This script checks the code syntax of a vivado project.

Arguments:

  • <project_name>: the project name

Usage:

  source Hog/Tcl/utils/check-syntax.tcl -tclargs <project_name>

compile_modelsimlib.tcl#

This script compiles the ModelSim libraries needed to simulate Vivado projects with ModelSim. The libraries are stored into the directory ./SimulationLib. Usage:

  source Hog/Tcl/utils/compile_modelsimlib.tcl

compile_questalib.tcl#

This script compiles the QuestaSim libraries needed to simulate Vivado projects with QuestaSim. The libraries are stored into the directory ./SimulationLib. Usage:

  source Hog/Tcl/utils/compile_questalib.tcl

get_ips.tcl#

To speed-up IPs re-generation, Hog allows the user to store compiled IPs into an EOS directory and retrieve them instead of recompile them. This is particularly useful for the CI or if the project repository has been freshly cloned. The IPs are stored to EOS together with their SHA, so they are retrieved only if the .xci was not modified. The instructions to store the IPs to EOS are detailed in the section IP synthesis. get_ips.tcl is used to retrieve IPs from EOS. To execute this command you need to have EOS software installed on your machine.

Arguments:

  • <project_name>: the project name

Options:

  • -eos_ip_path <IP PATH>: the EOS path where IPs are stored

Usage:

  source Hog/Tcl/utils/get-ips.tcl -tclargs [-eos_ip_path <IP_PATH>] <project_name>

make_doxygen.tcl#

This script is used to create the doxygen documentation. The doxygen configuration file must be stored into ./doxygen/doxygen.conf. If there is no such file, the command will use ./Hog/Templates/doxygen.conf as doxygen configuration file. You require a version of Doxygen newer than 1.8.13 installed on your machine, to execute this script

Usage:

  source Hog/Tcl/utils/make_doxygen.tcl

This script is used by Hog CI

check_yaml_ref.tcl#

This script checks that the Hog submodule SHA matches the ref in your .gitlab-ci.yml file. The .gitlab-ci.yml file defines what stages of the Hog Continuous Integration will be run. For more information, please consult the Hog-CI chapter.

If the two SHAs do not match, the script returns an Error, suggests few solutions to fix the problem.

This script is run by default in the pre-synthesis stage.

Usage:

  source Hog/Tcl/utils/check_yaml_ref.tcl

copy_xml.tcl#

This script copies IPBus XML files (see IPbus section) listed in a Hog list file of a specific project. It also replaces the version and SHA place holders, if they are present in any of the XML files. If a working installation of IPbus is on the system and the gen_ipbus_addr_decode script is in the PATH and working, copy_xml.tcl is able to check your XML files against the VHDL address doecode files and generate them if they are not there of they need to be updated.

Arguments:

  • <project name>: The project that contains the IPbus XML list file

  • <dest_dir>: the destination directory

Options:

  • [-generate]: if this option is set, the address decode VHDL files will be re generated and copied in the location specified in the xml.lst file

Usage:

  source copy_xml.tcl [-generate] <xml_list_file> <dest_dir>

project_sha.tcl#

This script returns the git SHA of the last commit or the version in which a specified project was modified.

Arguments:

  • <project name>: the name of the project

Options:

  • -version: if set, the version is returned rather than the git SHA

  • -ext_path: path to external libraries if any

Usage:

  source project_sha.tcl [-version] [-ext_path <external path>] <project name>

generate_yaml.tcl#

This script generates a gitlab-ci.yml config file for the dynamic CI child pipeline (see dynamic CI). It can also be used to create a template non dynamic project yaml file.

Options:

  • -runall: if set, it will generate a gitlab-ci yml file for all projects in the Top folder, even if it has not been modified with respect to the target branch

  • -static: if set, it will generate a template non dynamic project yaml file for every project in the Top folder

  • -ext_path: path to external libraries if any

Outputs:

  • generated-config.yml: child pipeline yml needed by dynamic CI, if -static flag is not set

  • .gitlab-ci.yml: template project non dynamic yaml file, if -static flag is set

  • new_gitlab-ci.yml: template project non dynamic yaml file, if -static flag is set and .gitlab-ci.yml already exists in the project

Usage:

  source generate_yaml.tcl [-runall] [-static] [-ext_path <external path>]

reformat.tcl#

This script formats tcl scripts indentation.

Arguments:

  • <tcl_script>: the tcl script to format

Options:

  • -tab_width <pad width>: the tab width to be used to indent the code (default = 2)

Usage:

  source Hog/Tcl/utils/reformat.tcl [-tab_width <pad_width>] <tcl_script>