Specifications

Updating Your BSP
When you update a BSP, you recreate the BSP settings file based on the current hardware definition and
previous BSP settings.
Note: You must always regenerate your BSP after updating the BSP settings file.
What Happens
Updating a BSP has the following effects:
• System-dependent settings are derived from the original BSP settings file, but adjusted to correspond
with any changes in the hardware system.
• Non-system-dependent BSP settings persist from the original BSP settings file.
For more information about actions taken when you regenerate the BSP after updating it, refer to the
“Regenerating Your BSP” chapter.
Related Information
Regenerating Your BSP on page 4-30
When to Update Your BSP
Updating your BSP is necessary in the following circumstances:
• A change to your BSP settings is required.
• Changes to your .sopcinfo file make it inconsistent with your BSP. The following are examples of
system changes that affect BSP system-dependent settings:
• Renaming the processor
• Renaming or removing a memory, the stdio device, or the system timer device
• Changing the size of a memory component when using a custom memory map
• Changing the processor reset or exception slave port or offset
• Adding or removing an external interrupt controller (EIC)
• Changing the parameters of an EIC
• When you attempt to rebuild your project, an error message indicates that you must update the BSP.
How to Update Your BSP
You can update your BSP at the command line. You have the option to use a Tcl script to control your
BSP settings.
From the command line, use the nios2-bsp-update-settings command. You can use the --script option
to define the BSP with a Tcl script.
For more information about the nios2-bsp-update-settings command, refer to the "Nios II Software
Build Tools Reference" chapter.
nios2-bsp-update-settings does not reapply default settings unless you explicitly call the top-level default
Tcl script with the --script option.
For more information about using the default Tcl script, refer to the “Specifying BSP Defaults” chapter.
Alternatively, you can update your BSP with the nios2-bsp script. nios2-bsp determines that your BSP
already exists, and uses the nios2-bsp-update-settings command to update the BSP settings file.
The nios2-bsp script executes the default Tcl script every time it runs, overwriting previous default
settings.
4-32
Updating Your BSP
NII5V2
2015.05.14
Altera Corporation
Nios II Software Build Tools
Send Feedback