hal
default
Feb 18, 2016 1:07:07 AM
1455750427597
./
../sys_controller_bsp/settings.bsp
../../sys.sopcinfo
default
nios2_qsys_0
1.9
hal.sys_clk_timer
ALT_SYS_CLK
UnquotedString
none
none
system_h_define
Slave descriptor of the system clock timer device. This device provides a periodic interrupt ("tick") and is typically required for RTOS use. This setting defines the value of ALT_SYS_CLK in system.h.
none
false
common
hal.timestamp_timer
ALT_TIMESTAMP_CLK
UnquotedString
none
none
system_h_define
Slave descriptor of timestamp timer device. This device is used by Altera HAL timestamp drivers for high-resolution time measurement. This setting defines the value of ALT_TIMESTAMP_CLK in system.h.
none
false
common
hal.max_file_descriptors
ALT_MAX_FD
DecimalNumber
32
32
system_h_define
Determines the number of file descriptors statically allocated. This setting defines the value of ALT_MAX_FD in system.h.
If hal.enable_lightweight_device_driver_api is true, there are no file descriptors so this setting is ignored. If hal.enable_lightweight_device_driver_api is false, this setting must be at least 4 because HAL needs a file descriptor for /dev/null, /dev/stdin, /dev/stdout, and /dev/stderr.
false
hal.enable_instruction_related_exceptions_api
ALT_INCLUDE_INSTRUCTION_RELATED_EXCEPTION_API
BooleanDefineOnly
false
false
system_h_define
Enables API for registering handlers to service instruction-related exceptions. Enabling this setting increases the size of the exception entry code.
These exception types can be generated if various processor options are enabled, such as the MMU, MPU, or other advanced exception types.
false
hal.linker.allow_code_at_reset
ALT_ALLOW_CODE_AT_RESET
Boolean
1
0
none
Indicates if initialization code is allowed at the reset address. If true, defines the macro ALT_ALLOW_CODE_AT_RESET in linker.h.
If true, defines the macro ALT_ALLOW_CODE_AT_RESET in linker.h. This setting is typically false if an external bootloader (e.g. flash bootloader) is present.
false
hal.linker.enable_alt_load
none
Boolean
1
0
none
Enables the alt_load() facility. The alt_load() facility copies sections from the .text memory into RAM. If true, this setting sets up the VMA/LMA of sections in linker.x to allow them to be loaded into the .text memory.
This setting is typically false if an external bootloader (e.g. flash bootloader) is present.
false
hal.linker.enable_alt_load_copy_rodata
none
Boolean
0
0
none
Causes the alt_load() facility to copy the .rodata section. If true, this setting defines the macro ALT_LOAD_COPY_RODATA in linker.h.
none
false
hal.linker.enable_alt_load_copy_rwdata
none
Boolean
1
0
none
Causes the alt_load() facility to copy the .rwdata section. If true, this setting defines the macro ALT_LOAD_COPY_RWDATA in linker.h.
none
false
hal.linker.enable_alt_load_copy_exceptions
none
Boolean
0
0
none
Causes the alt_load() facility to copy the .exceptions section. If true, this setting defines the macro ALT_LOAD_COPY_EXCEPTIONS in linker.h.
none
false
hal.linker.enable_exception_stack
none
Boolean
0
0
none
Enables use of a separate exception stack. If true, defines the macro ALT_EXCEPTION_STACK in linker.h, adds a memory region called exception_stack to linker.x, and provides the symbols __alt_exception_stack_pointer and __alt_exception_stack_limit in linker.x.
The hal.linker.exception_stack_size and hal.linker.exception_stack_memory_region_name settings must also be valid. This setting must be false for MicroC/OS-II BSPs. The exception stack can be used to improve interrupt and other exception performance if the EIC is *not* used.
false
common
hal.linker.exception_stack_size
none
DecimalNumber
1024
1024
none
Size of the exception stack in bytes.
Only used if hal.linker.enable_exception_stack is true.
false
common
hal.linker.exception_stack_memory_region_name
none
UnquotedString
onchip_memory2_0
none
none
Name of the existing memory region that will be divided up to create the 'exception_stack' memory region. The selected region name will be adjusted automatically when the BSP is generated to create the 'exception_stack' memory region.
Only used if hal.linker.enable_exception_stack is true.
false
common
hal.linker.enable_interrupt_stack
none
Boolean
0
0
none
Enables use of a separate interrupt stack. If true, defines the macro ALT_INTERRUPT_STACK in linker.h, adds a memory region called interrupt_stack to linker.x, and provides the symbols __alt_interrupt_stack_pointer and __alt_interrupt_stack_limit in linker.x.
The hal.linker.interrupt_stack_size and hal.linker.interrupt_stack_memory_region_name settings must also be valid. This setting must be false for MicroC/OS-II BSPs. Only enable if the EIC is used exclusively. The exception stack can be used to improve interrupt and other exception performance if the EIC is *not* used.
false
common
hal.linker.interrupt_stack_size
none
DecimalNumber
1024
1024
none
Size of the interrupt stack in bytes.
Only used if hal.linker.enable_interrupt_stack is true.
false
common
hal.linker.interrupt_stack_memory_region_name
none
UnquotedString
onchip_memory2_0
none
none
Name of the existing memory region that will be divided up to create the 'interrupt_stack' memory region. The selected region name will be adjusted automatically when the BSP is generated to create the 'interrupt_stack' memory region.
Only used if hal.linker.enable_interrupt_stack is true.
false
common
hal.stdin
none
UnquotedString
jtag_uart_0
none
system_h_define
Slave descriptor of STDIN character-mode device. This setting is used by the ALT_STDIN family of defines in system.h.
none
false
common
hal.stdout
none
UnquotedString
jtag_uart_0
none
system_h_define
Slave descriptor of STDOUT character-mode device. This setting is used by the ALT_STDOUT family of defines in system.h.
none
false
common
hal.stderr
none
UnquotedString
jtag_uart_0
none
system_h_define
Slave descriptor of STDERR character-mode device. This setting is used by the ALT_STDERR family of defines in system.h.
none
false
common
hal.log_port
none
UnquotedString
none
none
public_mk_define
Slave descriptor of debug logging character-mode device. If defined, it enables extra debug messages in the HAL source. This setting is used by the ALT_LOG_PORT family of defines in system.h.
none
false
none
hal.make.build_pre_process
BUILD_PRE_PROCESS
UnquotedString
none
none
makefile_variable
Command executed before BSP built.
none
false
none
hal.make.ar_pre_process
AR_PRE_PROCESS
UnquotedString
none
none
makefile_variable
Command executed before archiver execution.
none
false
none
hal.make.bsp_cflags_defined_symbols
BSP_CFLAGS_DEFINED_SYMBOLS
UnquotedString
none
none
makefile_variable
Preprocessor macros to define. A macro definition in this setting has the same effect as a "#define" in source code. Adding "-DALT_DEBUG" to this setting has the same effect as "#define ALT_DEBUG" in a souce file. Adding "-DFOO=1" to this setting is equivalent to the macro "#define FOO 1" in a source file. Macros defined with this setting are applied to all .S, .c, and C++ files in the BSP. This setting defines the value of BSP_CFLAGS_DEFINED_SYMBOLS in the BSP Makefile.
none
false
none
hal.make.ar_post_process
AR_POST_PROCESS
UnquotedString
none
none
makefile_variable
Command executed after archiver execution.
none
false
none
hal.make.as
AS
UnquotedString
nios2-elf-gcc
nios2-elf-gcc
makefile_variable
Assembler command. Note that CC is used for .S files.
none
false
none
hal.make.build_post_process
BUILD_POST_PROCESS
UnquotedString
none
none
makefile_variable
Command executed after BSP built.
none
false
none
hal.make.bsp_cflags_debug
BSP_CFLAGS_DEBUG
UnquotedString
none
-g
makefile_variable
C/C++ compiler debug level. '-g' provides the default set of debug symbols typically required to debug a typical application. Omitting '-g' removes debug symbols from the ELF. This setting defines the value of BSP_CFLAGS_DEBUG in Makefile.
none
false
common
hal.make.ar
AR
UnquotedString
nios2-elf-ar
nios2-elf-ar
makefile_variable
Archiver command. Creates library files.
none
false
none
hal.make.rm
RM
UnquotedString
rm -f
rm -f
makefile_variable
Command used to remove files during 'clean' target.
none
false
none
hal.make.cxx_pre_process
CXX_PRE_PROCESS
UnquotedString
none
none
makefile_variable
Command executed before each C++ file is compiled.
none
false
none
hal.make.bsp_cflags_warnings
BSP_CFLAGS_WARNINGS
UnquotedString
-Wall
-Wall
makefile_variable
C/C++ compiler warning level. "-Wall" is commonly used.This setting defines the value of BSP_CFLAGS_WARNINGS in Makefile.
none
false
none
hal.make.bsp_arflags
BSP_ARFLAGS
UnquotedString
-src
-src
makefile_variable
Custom flags only passed to the archiver. This content of this variable is directly passed to the archiver rather than the more standard "ARFLAGS". The reason for this is that GNU Make assumes some default content in ARFLAGS. This setting defines the value of BSP_ARFLAGS in Makefile.
none
false
none
hal.make.bsp_cflags_optimization
BSP_CFLAGS_OPTIMIZATION
UnquotedString
-Os
-O0
makefile_variable
C/C++ compiler optimization level. "-O0" = no optimization,"-O2" = "normal" optimization, etc. "-O0" is recommended for code that you want to debug since compiler optimization can remove variables and produce non-sequential execution of code while debugging. This setting defines the value of BSP_CFLAGS_OPTIMIZATION in Makefile.
none
false
common
hal.make.as_post_process
AS_POST_PROCESS
UnquotedString
none
none
makefile_variable
Command executed after each assembly file is compiled.
none
false
none
hal.make.cc_pre_process
CC_PRE_PROCESS
UnquotedString
none
none
makefile_variable
Command executed before each .c/.S file is compiled.
none
false
none
hal.make.bsp_asflags
BSP_ASFLAGS
UnquotedString
-Wa,-gdwarf2
-Wa,-gdwarf2
makefile_variable
Custom flags only passed to the assembler. This setting defines the value of BSP_ASFLAGS in Makefile.
none
false
none
hal.make.as_pre_process
AS_PRE_PROCESS
UnquotedString
none
none
makefile_variable
Command executed before each assembly file is compiled.
none
false
none
hal.make.bsp_cflags_undefined_symbols
BSP_CFLAGS_UNDEFINED_SYMBOLS
UnquotedString
none
none
makefile_variable
Preprocessor macros to undefine. Undefined macros are similar to defined macros, but replicate the "#undef" directive in source code. To undefine the macro FOO use the syntax "-u FOO" in this setting. This is equivalent to "#undef FOO" in a source file. Note: the syntax differs from macro definition (there is a space, i.e. "-u FOO" versus "-DFOO"). Macros defined with this setting are applied to all .S, .c, and C++ files in the BSP. This setting defines the value of BSP_CFLAGS_UNDEFINED_SYMBOLS in the BSP Makefile.
none
false
none
hal.make.cc_post_process
CC_POST_PROCESS
UnquotedString
none
none
makefile_variable
Command executed after each .c/.S file is compiled.
none
false
none
hal.make.cxx_post_process
CXX_POST_PROCESS
UnquotedString
none
none
makefile_variable
Command executed before each C++ file is compiled.
none
false
none
hal.make.cc
CC
UnquotedString
nios2-elf-gcc -xc
nios2-elf-gcc -xc
makefile_variable
C compiler command.
none
false
none
hal.make.bsp_cxx_flags
BSP_CXXFLAGS
UnquotedString
none
none
makefile_variable
Custom flags only passed to the C++ compiler. This setting defines the value of BSP_CXXFLAGS in Makefile.
none
false
none
hal.make.bsp_inc_dirs
BSP_INC_DIRS
UnquotedString
none
none
makefile_variable
Space separated list of extra include directories to scan for header files. Directories are relative to the top-level BSP directory. The -I prefix's added by the makefile so don't add it here. This setting defines the value of BSP_INC_DIRS in Makefile.
none
false
none
hal.make.cxx
CXX
UnquotedString
nios2-elf-gcc -xc++
nios2-elf-gcc -xc++
makefile_variable
C++ compiler command.
none
false
none
hal.make.bsp_cflags_user_flags
BSP_CFLAGS_USER_FLAGS
UnquotedString
none
none
makefile_variable
Custom flags passed to the compiler when compiling C, C++, and .S files. This setting defines the value of BSP_CFLAGS_USER_FLAGS in Makefile.
none
false
none
hal.make.ignore_system_derived.sopc_system_id
none
Boolean
0
0
public_mk_define
Enable BSP generation to query SOPC system for system ID. If true ignores export of 'SOPC_SYSID_FLAG += --id=<sysid>' and 'ELF_PATCH_FLAG += --id=<sysid>' to public.mk.
none
false
none
hal.make.ignore_system_derived.sopc_system_timestamp
none
Boolean
0
0
public_mk_define
Enable BSP generation to query SOPC system for system timestamp. If true ignores export of 'SOPC_SYSID_FLAG += --timestamp=<timestamp>' and 'ELF_PATCH_FLAG += --timestamp=<timestamp>' to public.mk.
none
false
none
hal.make.ignore_system_derived.sopc_system_base_address
none
Boolean
0
0
public_mk_define
Enable BSP generation to query SOPC system for system ID base address. If true ignores export of 'SOPC_SYSID_FLAG += --sidp=<address>' and 'ELF_PATCH_FLAG += --sidp=<address>' to public.mk.
none
false
none
hal.make.ignore_system_derived.sopc_simulation_enabled
none
Boolean
0
0
public_mk_define
Enable BSP generation to query if SOPC system has simulation enabled. If true ignores export of 'ELF_PATCH_FLAG += --simulation_enabled' to public.mk.
none
false
none
hal.make.ignore_system_derived.fpu_present
none
Boolean
0
0
public_mk_define
Enable BSP generation to query if SOPC system has FPU present. If true ignores export of 'ALT_CFLAGS += -mhard-float' to public.mk if FPU is found in the system. If true ignores export of 'ALT_CFLAGS += -mhard-soft' if FPU is not found in the system.
none
false
none
hal.make.ignore_system_derived.cdx_present
none
Boolean
0
0
public_mk_define
If true, prevents GCC from using CDX instructions. If false, GCC uses CDX instructions if present in the CPU.
none
false
none
hal.make.ignore_system_derived.bmx_present
none
Boolean
0
0
public_mk_define
If true, prevents GCC from using BMX instructions. If false, GCC uses BMX instructions if present in the CPU.
none
false
none
hal.make.ignore_system_derived.hardware_multiplier_present
none
Boolean
0
0
public_mk_define
Enable BSP generation to query if SOPC system has multiplier present. If true ignores export of 'ALT_CFLAGS += -mno-hw-mul' to public.mk if no multiplier is found in the system. If true ignores export of 'ALT_CFLAGS += -mhw-mul' if multiplier is found in the system.
none
false
none
hal.make.ignore_system_derived.hardware_mulx_present
none
Boolean
0
0
public_mk_define
Enable BSP generation to query if SOPC system has hardware mulx present. If true ignores export of 'ALT_CFLAGS += -mno-hw-mulx' to public.mk if no mulx is found in the system. If true ignores export of 'ALT_CFLAGS += -mhw-mulx' if mulx is found in the system.
none
false
none
hal.make.ignore_system_derived.hardware_divide_present
none
Boolean
0
0
public_mk_define
Enable BSP generation to query if SOPC system has hardware divide present. If true ignores export of 'ALT_CFLAGS += -mno-hw-div' to public.mk if no division is found in system. If true ignores export of 'ALT_CFLAGS += -mhw-div' if division is found in the system.
none
false
none
hal.make.ignore_system_derived.debug_core_present
none
Boolean
0
0
public_mk_define
Enable BSP generation to query if SOPC system has a debug core present. If true ignores export of 'CPU_HAS_DEBUG_CORE = 1' to public.mk if a debug core is found in the system. If true ignores export of 'CPU_HAS_DEBUG_CORE = 0' if no debug core is found in the system.
none
false
none
hal.make.ignore_system_derived.big_endian
none
Boolean
0
0
public_mk_define
Enable BSP generation to query if SOPC system is big endian. If true ignores export of 'ALT_CFLAGS += -meb' to public.mk if big endian system.
none
false
none
hal.make.ignore_system_derived.hardware_fp_cust_inst_divider_present
none
Boolean
0
0
public_mk_define
Enable BSP generation to query if SOPC system floating point custom instruction with a divider is present. If true ignores export of 'ALT_CFLAGS += -mcustom-fpu-cfg=60-2' and 'ALT_LDFLAGS += -mcustom-fpu-cfg=60-2' to public.mk if the custom instruction is found in the system.
none
false
none
hal.make.ignore_system_derived.hardware_fp_cust_inst_no_divider_present
none
Boolean
0
0
public_mk_define
Enable BSP generation to query if SOPC system floating point custom instruction without a divider is present. If true ignores export of 'ALT_CFLAGS += -mcustom-fpu-cfg=60-1' and 'ALT_LDFLAGS += -mcustom-fpu-cfg=60-1' to public.mk if the custom instruction is found in the system.
none
false
none
hal.enable_exit
ALT_NO_EXIT
Boolean
0
1
public_mk_define
Add exit() support. This option increases code footprint if your "main()" routine does "return" or call "exit()". If false, adds -DALT_NO_EXIT to ALT_CPPFLAGS in public.mk, and reduces footprint
none
false
none
hal.enable_small_c_library
none
Boolean
1
0
public_mk_define
Causes the small newlib (C library) to be used. This reduces code and data footprint at the expense of reduced functionality. Several newlib features are removed such as floating-point support in printf(), stdin input routines, and buffered I/O. The small C library is not compatible with Micrium MicroC/OS-II. If true, adds -msmallc to ALT_LDFLAGS in public.mk.
none
false
common
hal.enable_clean_exit
ALT_NO_CLEAN_EXIT
Boolean
0
1
public_mk_define
When your application exits, close file descriptors, call C++ destructors, etc. Code footprint can be reduced by disabling clean exit. If disabled, adds -DALT_NO_CLEAN_EXIT to ALT_CPPFLAGS -D'exit(a)=_exit(a)' in public.mk.
none
false
none
hal.enable_runtime_stack_checking
ALT_STACK_CHECK
Boolean
0
0
public_mk_define
Turns on HAL runtime stack checking feature. Enabling this setting causes additional code to be placed into each subroutine call to generate an exception if a stack collision occurs with the heap or statically allocated data. If true, adds -DALT_STACK_CHECK and -fstack-limit-register=et to ALT_CPPFLAGS in public.mk.
none
false
none
hal.enable_gprof
ALT_PROVIDE_GMON
Boolean
0
0
public_mk_define
Causes code to be compiled with gprof profiling enabled and the application ELF to be linked with the GPROF library. If true, adds -DALT_PROVIDE_GMON to ALT_CPPFLAGS and -pg to ALT_CFLAGS in public.mk.
none
false
common
hal.enable_c_plus_plus
ALT_NO_C_PLUS_PLUS
Boolean
0
1
public_mk_define
Enable support for a subset of the C++ language. This option increases code footprint by adding support for C++ constructors. Certain features, such as multiple inheritance and exceptions are not supported. If false, adds -DALT_NO_C_PLUS_PLUS to ALT_CPPFLAGS in public.mk, and reduces code footprint.
none
false
none
hal.enable_reduced_device_drivers
ALT_USE_SMALL_DRIVERS
Boolean
1
0
public_mk_define
Certain drivers are compiled with reduced functionality to reduce code footprint. Not all drivers observe this setting. The altera_avalon_uart and altera_avalon_jtag_uart drivers switch from interrupt-driven to polled operation. CAUTION: Several device drivers are disabled entirely. These include the altera_avalon_cfi_flash, altera_avalon_epcs_flash_controller, and altera_avalon_lcd_16207 drivers. This can result in certain API (HAL flash access routines) to fail. You can define a symbol provided by each driver to prevent it from being removed. If true, adds -DALT_USE_SMALL_DRIVERS to ALT_CPPFLAGS in public.mk.
none
false
common
hal.enable_lightweight_device_driver_api
ALT_USE_DIRECT_DRIVERS
Boolean
0
0
public_mk_define
Enables lightweight device driver API. This reduces code and data footprint by removing the HAL layer that maps device names (e.g. /dev/uart0) to file descriptors. Instead, driver routines are called directly. The open(), close(), and lseek() routines will always fail if called. The read(), write(), fstat(), ioctl(), and isatty() routines only work for the stdio devices. If true, adds -DALT_USE_DIRECT_DRIVERS to ALT_CPPFLAGS in public.mk.
The Altera Host and read-only ZIP file systems can't be used if hal.enable_lightweight_device_driver_api is true.
false
none
hal.enable_mul_div_emulation
ALT_NO_INSTRUCTION_EMULATION
Boolean
0
0
public_mk_define
Adds code to emulate multiply and divide instructions in case they are executed but aren't present in the CPU. Normally this isn't required because the compiler won't use multiply and divide instructions that aren't present in the CPU. If false, adds -DALT_NO_INSTRUCTION_EMULATION to ALT_CPPFLAGS in public.mk.
none
false
none
hal.enable_sim_optimize
ALT_SIM_OPTIMIZE
Boolean
0
0
public_mk_define
The BSP is compiled with optimizations to speedup HDL simulation such as initializing the cache, clearing the .bss section, and skipping long delay loops. If true, adds -DALT_SIM_OPTIMIZE to ALT_CPPFLAGS in public.mk.
When this setting is true, the BSP shouldn't be used to build applications that are expected to run real hardware.
false
common
hal.enable_sopc_sysid_check
none
Boolean
1
1
public_mk_define
Enable SOPC Builder System ID. If a System ID SOPC Builder component is connected to the CPU associated with this BSP, it will be enabled in the creation of command-line arguments to download an ELF to the target. Otherwise, system ID and timestamp values are left out of public.mk for application Makefile "download-elf" target definition. With the system ID check disabled, the Nios II EDS tools will not automatically ensure that the application .elf file (and BSP it is linked against) corresponds to the hardware design on the target. If false, adds --accept-bad-sysid to SOPC_SYSID_FLAG in public.mk.
none
false
none
hal.custom_newlib_flags
CUSTOM_NEWLIB_FLAGS
UnquotedString
none
none
public_mk_define
Build a custom version of newlib with the specified space-separated compiler flags.
The custom newlib build will be placed in the <bsp root>/newlib directory, and will be used only for applications that utilize this BSP.
false
none
hal.log_flags
ALT_LOG_FLAGS
DecimalNumber
0
0
public_mk_define
The value is assigned to ALT_LOG_FLAGS in the generated public.mk. See hal.log_port setting description. Values can be -1 through 3.
hal.log_port must be set for this to be used.
false
none
altera_avalon_jtag_uart_driver.enable_small_driver
ALTERA_AVALON_JTAG_UART_SMALL
BooleanDefineOnly
false
false
public_mk_define
Small-footprint (polled mode) driver
none
false
altera_avalon_jtag_uart_driver.enable_jtag_uart_ignore_fifo_full_error
ALTERA_AVALON_JTAG_UART_IGNORE_FIFO_FULL_ERROR
BooleanDefineOnly
true
false
public_mk_define
Enable JTAG UART driver to recover when host is inactive causing buffer to full without returning error. Printf will not fail with this recovery.
none
false
epcq_controller_0_avl_mem
0x00000000 - 0x007FFFFF
8388608
flash, memory, non-volatile
onchip_memory2_0
0x00810000 - 0x00818FFF
36864
memory
Altera_UP_SD_Card_Avalon_Interface_0
0x00821000 - 0x008213FF
1024
epcq_controller_0_avl_csr
0x00821400 - 0x0082141F
32
i2c_opencores_0
0x00821420 - 0x0082143F
32
pio_5
0x00821440 - 0x0082144F
16
pio_4
0x00821450 - 0x0082145F
16
pio_3
0x00821460 - 0x0082146F
16
pio_2
0x00821470 - 0x0082147F
16
pio_1
0x00821480 - 0x0082148F
16
pio_0
0x00821490 - 0x0082149F
16
jtag_uart_0
0x008214A0 - 0x008214A7
8
printable
.text
onchip_memory2_0
.rodata
onchip_memory2_0
.rwdata
onchip_memory2_0
.bss
onchip_memory2_0
.heap
onchip_memory2_0
.stack
onchip_memory2_0