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

ParameterTypeDescription
sd_namestringSpecifies the name of the SmartDesign component. It is mandatory.
port_namestringSpecifies the name of the Bus Interface port to be added in the SmartDesign. It is mandatory.
port_bif_vlnvstringSpecifies the version identifier of the Bus Interface port to be added in the SmartDesign. It is mandatory.
port_bif_rolestringSpecifies the role of the Bus Interface port to be added in the SmartDesign.
port_bif_mappingstringSpecifies the mapping between the bus interface formal names and the SmartDesign ports mapped onto that bus interface port. It is mandatory.
Return TypeDescription
NoneNone

Error Codes

Error CodeDescription

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" }

See Also

  • hdl_core_add_bif

  • hdl_core_assign_bif_signal

  • sd_create_bif_net