f4pga/sfbuild/docs/modules/common/io_rename.md
Krzysztof Boronski cd2ad7144c Up-to-date version of sfbuild
Signed-off-by: Krzysztof Boronski <kboronski@antmicro.com>
2022-04-26 12:16:36 +02:00

27 lines
No EOL
1 KiB
Markdown

# sfbuild module "io_rename"
##### _Category: Common_
-------------------------------
This module provides a way to rename (ie. change) dependencies and values of an
instance of a different module. It wraps another, module whoose name is specified in `params.module` and changes the names of the dependencies and values it relies on.
## Setup
### 1. Parameters
* `module` (string, required) - name of the wrapped module
* `params` (dict[string -> any], optional): parameters passed to the wrapped
module instance.
* `rename_takes` (dict[string -> string]) - mapping for inputs ("takes")
* `rename_produces` (dict[string -> string]) - mapping for outputs ("products")
* `rename_values` (dict[string -> string]) - mapping for values
In the three mapping dicts, keys represent the names visible to the wrapped module
and values represent the names visible to the modules outside.
Not specifying a mapping for a given entry will leave it with its original name.
### 2. Values
All values specified for this modules will be accessible by tyhe wrapped module.