21.4.35 sd_instantiate_macro

Description

This tcl command instantiates a Microsemi primitive macro in a SmartDesign component.

sd_instantiate_macro -sd_name {smartdesign component name} \
                     -macro_name {macro module name} \
                     [-instance_name {instance name}] 

Arguments

ParameterTypeDescription
sd_namestringSpecifies the name of the SmartDesign component. It is mandatory.
macro_namestringSpecifies the name of the macro being instantiated in the SmartDesign component. It is mandatory.
instance_namestringSpecifies the instance name of the macro. It is optional. By default, the instance name is <macroname>_<index> (index is an automatically generated integer starting at 0 such that the instance name is unique in the SmartDesign).
Return TypeDescription
NoneNone

Error Codes

Error CodeDescription
NoneRequired parameter 'macro_name' is missing.
NoneRequired parameter 'sd_name' is missing.
NoneUnable to find macro 'some_macro_name' in the ADLIB database.
NoneThe component 'component_name' doesn't exist.
NoneParameter 'param_name' is not defined. Valid command formatting is 'sd_instantiate_macro -sd_name "sd_name" -macro_name "macro_name" [-instance_name "instance_name"]'.

Supported Families

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

Example

  • The following Tcl command shows how to use instance of "MX2" multiplexer macro in TOP design:

    sd_instantiate_macro -sd_name {TOP} -macro_name {MX2} -instance_name {MX2_0}
  • The following Tcl command shows how to use instance of "MX2" multiplexer macro in TOP design, in this case creates instance with macro name and index(unique number):

    sd_instantiate_macro -sd_name {TOP} -macro_name {MACC_PA}