Nios® II Software Developer Handbook

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

16.3.1. Overview of BSP Settings

A BSP setting consists of a name/value pair.

The format in which you specify the setting value depends on the setting type. Several settings types are supported.

Table 62.  Allowed Formats for each Setting Type
Setting Type Format When Setting Format When Getting
boolean 0/1 or false/true 0/1
number 0x prefix for hexadecimal or no prefix for a decimal number decimal
string Quoted string

Use "none" to set empty string.

In the SBT command line, to specify a string value with embedded spaces, surround the string with a backslash-double-quote sequence (\"). For example:

--set APP_INCLUDE_DIRS \"lcd board\"

Quoted string
Table 63.  BSP Setting Contexts
Setting Context Description
Intel FPGA LWHAL Settings available with the Intel FPGA Lightweight HAL BSP or any BSP based on it.
Intel FPGA HAL Settings available with the Intel FPGA HAL BSP or any BSP based on it (for example, Micrium MicroC/OS-II).
Micrium 
MicroC/OS-II Settings available if using the Micrium MicroC/OS-II BSP. All Intel FPGA HAL BSP settings are also available because MicroC/OS-II is based on the Intel FPGA HAL BSP.
Intel FPGA BSP Makefile Generator Settings available if using the Intel FPGA BSP makefile generator (generates the Makefile and public.mk files). These settings control the contents of makefile variables. This generator is always present in Intel FPGA HAL BSPs or any BSPs based on the Intel FPGA HAL.
Intel FPGA BSP Linker Script Generator Settings available if using the Intel FPGA BSP linker script generator (generates the linker.x and linker.h files). This generator is always present in Intel FPGA HAL BSPs or any BSPs based on the Intel FPGA HAL.

Do not confuse BSP settings with BSP Tcl commands. This section covers BSP settings, including their types, meanings, and legal values.