Configuration¶

Configuration file location¶

The configuration file must be located in one of the following locations:

topwrap.yaml
~/.config/topwrap/topwrap.yaml
~/.config/topwrap/config.yaml

Configuration precedence¶

When multiple configuration files are present, the options are evaluated and overridden based on the location of the configuration file. The precedence, from highest to lowest, is as follows:

• topwrap.yaml in the current working directory

• ~/.config/topwrap/topwrap.yaml (user-specific configuration)

• ~/.config/topwrap/config.yaml (fallback configuration)

For example, if force_interface_compliance is set to true in ~/.config/topwrap/config.yaml but overridden to false in topwrap.yaml, the latter value will take precedence when running Topwrap in the directory containing topwrap.yaml.

Merging strategies for configuration options¶

Different configuration options use different merging strategies when multiple configuration files are combined:

• Override (e.g. force_interface_compliance): The value from the higher-precedence file completely replaces the value in lower-precedence files.

• Merge (e.g. repositories): Values from all configuration files are merged. For example, repositories defined in ~/.config/topwrap/topwrap.yaml are combined with repositories defined in topwrap.yaml.

Available config options¶

The configuration file for Topwrap provides the following options:

• force_interface_compliance

  • Type: Boolean

  • Default: false

  • Merging strategy: Override

  This option enforces compliance with interface definitions when parsing HDLs.

  For more details, refer to Interface compliance.

• repositories

  • Type: List of objects

  • Merging strategy: Merge

  • Specifies repositories to load, with each repository defined as an object containing the following fields:

    • name: (required) The name of the repository.

    • path: (required) The file system path to the repository.

  • Example of specifying multiple repositories:

    repositories:
      - name: name_of_repo
        path: path_to_repo
      - name: another_repo
        path: /absolute/path/to/repo
    

  Repositories are used to package and load multiple IP cores and custom interfaces.

  For more information, refer to User repositories.

Example configuration file¶

Here is a sample configuration file used in the hierarchy example

force_interface_compliance: true
repositories:
  - name: Hierarchies example
    path: ./repo/