21.4.13 sd_create_bif_port

Description

This Tcl command creates a SmartDesign Bus Interface port of a given type. This command is used to create top level Bus Interface ports in a SmartDesign component to connect to the instance level Bus Interface ports of the same type.

sd_create_bif_port -sd_name {smartdesign component name} \
                   -port_name {port name} \
                   -port_bif_vlnv {vendor:library:name:version} \
                   -port_bif_role {port bif role} \
                   -port_bif_mapping {[bif port name:port name]+}

Arguments


Parameter	Type	Description
sd_name	string	Specifies the name of the SmartDesign component. It is mandatory.
port_name	string	Specifies the name of the Bus Interface port to be added in the SmartDesign. It is mandatory.
port_bif_vlnv	string	Specifies the version identifier of the Bus Interface port to be added in the SmartDesign. It is mandatory.
port_bif_role	string	Specifies the role of the Bus Interface port to be added in the SmartDesign.
port_bif_mapping	string	Specifies the mapping between the bus interface formal names and the SmartDesign ports mapped onto that bus interface port. It is mandatory.


Return Type	Description
None	None

Error Codes


Error Code	Description
None	Required parameter 'sd_name' is missing.
None	Parameter 'sd_name' has illegal value.
None	The component 'design_name' does not exist.
None	Required parameter 'port_name' is missing.
None	Parameter 'port_name' has illegal value.
None	Required parameter 'port_bif_vlnv' is missing.
None	Parameter 'port_bif_vlnv' has illegal value.
None	Parameter 'port_bif_role' has illegal value.
None	Required parameter 'port_bif_role' is missing.
None	Parameter 'port_bif_mapping' has illegal value.
None	Required parameter 'port_bif_mapping' is missing.
SDCTRLO2	Port name 'bif_name' already exist.
None	Parameter 'param_name' is not defined. Valid command formatting is 'sd_create_bif_port -sd_name "sd_name" -port_name "port_name" -port_bif_vlnv "port_bif_vlnv" -port_bif_role "port_bif_role" -port_bif_mapping "[port_bif_mapping]+"'.

Supported Families


Supported Families
PolarFire®
PolarFire SoC
RTG4™
SmartFusion® 2
IGLOO® 2

Example

This example creates bif port with "BIF_1" name, "AMBA:AMBA2:APB:r0p0" vendor:library:name:version, {"PADDR:PADDR" \"PENABLE:PENABLE" \ "PWRITE:PWRITE" \ "PRDATA:PRDATA" \ "PWDATA:PWDATA" \ "PREADY:PREADY" } bif mapping and "slave" role:

sd_create_bif_port -sd_name {sd1} \
                   -port_name {BIF_1} \
                   -port_bif_vlnv {AMBA:AMBA2:APB:r0p0} \
                   -port_bif_role {slave} \
                   -port_bif_mapping {"PADDR:PADDR" \                                                                   
                                      "PENABLE:PENABLE" \
                                      "PWRITE:PWRITE" \
                                      "PRDATA:PRDATA" \
                                      "PWDATA:PWDATA" \
                                      "PREADY:PREADY" }

v2024.2