21.4.42 sd_rename_port
(Ask a Question)Description
This Tcl command renames a SmartDesign port name.
Important: This command is not required to build
a SmartDesign component. It maps to an interactive user action in the SmartDesign
Canvas and will not be present in the exported SmartDesign component Tcl
description.
sd_rename_port -sd_name {smartdesign component name} \
-current_port_name {port name} \
-new_port_name {new port name}Arguments
| Parameter | Type | Description |
|---|---|---|
| sd_name | string | Specifies the name of the SmartDesign component. It is mandatory. |
| current_port_name | string | Specifies the name of the port to be renamed in the SmartDesign
component. It is mandatory. Note: Only port names
can be renamed, and not port types (scalar ports cannot be
renamed as bus ports and vice versa). |
| new_port_name | string | Specifies the new name of the specified port. It is mandatory. |
| Return Type | Description |
|---|---|
| None | None |
Error Codes
| Error Code | Description |
|---|---|
| None | 'P*' is containing the invalid character '*'. |
| None | Parameter 'new_port_name' has illegal value. |
| None | Required parameter 'sd_name' is missing. |
| None | Parameter 'current_port_name' has illegal value. |
| None | Port 'port_name' doesn't exist. |
| None | Required parameter 'current_port_name' is missing. |
| None | Required parameter 'new_port_name' is missing. |
| None | Parameter 'param_name' is not defined. Valid command formatting is 'sd_rename_port -sd_name "sd_name" -current_port_name "current_port_name" -new_port_name "new_port_name"'. |
| SDCTRL02 | Port name already exists. |
Supported Families
| Supported Families |
|---|
| PolarFire® |
| PolarFire SoC |
| RTG4™ |
| SmartFusion® 2 |
| IGLOO® 2 |
Example
The following command renames c1 port name with c2 in "top" design:
sd_rename_port -sd_name {top} -current_port_name {c1} -new_port_name {c2}See Also
- sd_create_scalar_port