Nios® II Software Developer Handbook

ID 683525
Date 8/28/2023
Public
Document Table of Contents

14.1.2. Tcl Assignment Statements

A component publishes information by including Tcl assignment statements in its component description file, <component_name>_hw.tcl. Each assignment is a name-value pair that can be associated with the entire component, or with a single interface. When the assignment statement applies to the entire component, it is set using the set_module_assignment command. Assignment statements that apply to an interface are set using the set_interface_assignment command.

# These assignments apply to the entire component
# This is the syntax for the set_module_assignment command:
# set_module_assignment <assignment_name> <value>
# Here are 3 examples
set_module_assignment embeddedsw.CMacro.colorSpace "CMYK"
set_module_assignment embeddedsw.configuration.cpuArchitecture "My processor"
set_module_assignment embeddedsw.memoryInfo.IS_FLASH 1
# This is the syntax of the set_interface_assignment command:
# set_interface_assignment <interface_name> <assignment_name> <value>
# Here is an example
set_interface_assignment lcd0 embeddedsw.configuration.isPrintableDevice 1

When you generate a hardware system, the system integration tool, Platform Designer, creates an <sopc_builder_system>.sopcinfo file that includes all of the assignments for your component. The embedded software tools use these assignments for further processing. The system integration tool does not require any of the information included in these assignments to build the hardware representation of the component. The tool simply passes the assignments from the _hw.tcl file to the (.sopcinfo).