hal default Oct 5, 2018 8:21:01 PM 1538758741996 ./ 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 timer_0 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 data sections (.rodata, .rwdata, or .exceptions) from boot memory to 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.cflags_mgpopt CFLAGS_MGPOPT UnquotedString -mgpopt=global -mgpopt=global public_mk_define C/C++ compiler to generate (do not generate) GP-relative accesses. 'none' tells the compilter not to generate GP-relative accesses. 'local' will generate GP-relative accesses for small data objects that are not external, weak, or uninitialized common symbols. Also use GP-relative addressing for objects that have been explicitly placed in a small data section via a section attribute. provides the default set of debug symbols typically required to debug a typical application. 'global' is same as 'local' but also generate GP-relative accesses for small data objects that are external, weak, or common. none false common 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 1 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 onchip_memory2_0 0x00010000 - 0x00019FFF 40960 memory timer_0 0x00020000 - 0x0002001F 32 timer jtag_uart_0 0x00020020 - 0x00020027 8 printable epcq_controller_0_avl_csr 0x00020100 - 0x0002011F 32 i2c_opencores_1 0x00021020 - 0x0002103F 32 i2c_opencores_0 0x00021040 - 0x0002105F 32 pio_8 0x00021060 - 0x0002106F 16 pio_7 0x00021070 - 0x0002107F 16 pio_6 0x00021080 - 0x0002108F 16 pio_5 0x00021090 - 0x0002109F 16 pio_4 0x000210A0 - 0x000210AF 16 pio_3 0x000210B0 - 0x000210BF 16 pio_2 0x000210C0 - 0x000210CF 16 pio_1 0x000210D0 - 0x000210DF 16 pio_0 0x000210E0 - 0x000210EF 16 epcq_controller_0_avl_mem 0x00800000 - 0x00FFFFFF 8388608 flash, memory, non-volatile .text onchip_memory2_0 .rodata onchip_memory2_0 .rwdata onchip_memory2_0 .bss onchip_memory2_0 .heap onchip_memory2_0 .stack onchip_memory2_0