Specifications

This command supports the following properties:
• hw_class_name—The name of the hardware class which your device driver supports. The hardware
class name is also the Component Name shown in the Component Editor. Example:
altera_avalon_uart. This property is only available for device drivers. This property is required for
all drivers.
• version—The version number of this package. set_sw_property uses version numbers to determine
compatibility between hardware (peripherals) and their software (drivers), as well as to choose the
most recent software or driver if multiple compatible versions are available. A version can be any
alphanumeric string, but is usually a major and one or more minor revision integers. The dot (.)
character separates major and minor revision numbers. Examples: 9.0, 5.0sp1, 3.2.11. This property
is optional, but recommended. If you do not specify a version, the newest version of the package is
used.
• min_compatible_hw_version—Specifies that the device driver supports the specified hardware
version, or all greater versions. This property is only available for device drivers. If your device driver
supports only one or more specific versions of a hardware class, use the add_sw_property
specific_compatible_hw_version command instead. See the version property documentation for
information about version strings. This property is optional. This property is only available for device
drivers.
• auto_initialize—Boolean value that specifies alt_sys_init.c needs to initialize your package. If
enabled, you must provide a header file containing INSTANCE and INIT macros.
This property is optional; if unspecified, alt_sys_init.c does not contain references to your driver or
software. This property is only available for device drivers and software packages.
• bsp_subdirectory—Specifies the top-level directory where nios2-bsp-generate-files copies all source
files for this package. This property is a path relative to the top-level BSP directory. This property is
optional; if unspecified, nios2-bsp-generate-files copies the driver or software package into the
drivers subdirectory of any BSP including this software.
• alt_sys_init_priority—This property assigns a priority to the software package or device driver.
The value of this property must be a positive integer. Use this property to customize the order of
macro calls in the BSP alt_sys_init.c file. Specifying the priority is useful if your software or driver must
be initialized before or after other software in the system. For example, your driver might depend on
another driver already being initialized.
This property is optional. The default priority is 1000. This property is only available for device drivers
and software packages.
• display_name—This property is used for user interfaces and other tools that wish to show a human-
readable name to identify the software being described in the .tcl script. display_name is set to a few
words of text (in quotes) that name your software. For example: Altera Nios II driver.
This property is optional. If not set, tools that attempt to use the display name use the package name
created with the appropriate create_ command.
• extends_bsp_type—This property specifies which BSP type that an operating system (created with
the create_os command) extends (if any). Currently, only the Altera HAL (HAL) is supported. This
command is required for all operating systems that wish to use HAL-compatible generators in the Nios
II BSP tools. It is also required for operating systems that require the Altera HAL, device driver, or
software package source files that are HAL compatible in BSPs created with that operating system. An
operating system that extends HAL is presumed to be compatible with device drivers that support
HAL. This command is only available for operating systems.
• callback_source_file—This property specifies a Tcl source file containing callback functions.
NII5V2
2015.05.14
set_sw_property
15-105
Nios II Software Build Tools Reference
Altera Corporation
Send Feedback