Visible to Intel only — GUID: yhw1678076220082
Ixiasoft
1. Overview of Nios® V Embedded Processor Development
2. Getting Started with the Graphical User Interface
3. Getting Started from the Command Line
4. Nios® V Processor Software Development and Implementation
5. Nios® V Processor Board Support Package Editor
6. Overview of the Hardware Abstraction Layer
7. Developing Programs Using the Hardware Abstraction Layer
8. Developing Device Drivers for the Hardware Abstraction Layer
9. Exception Handling
10. Cache and Tightly-Coupled Memory
11. MicroC/OS-II Real-Time Operating System
12. MicroC/TCP-IP Protocol Stack
13. FreeRTOS* Real-Time Operating System
14. Read-Only Zip File System
15. Publishing Component Information to Embedded Software
16. Nios® V Processor Appendix
A. Nios® V Processor Software Developer Handbook Archives
17. Revision History for the Nios® V Processor Software Developer Handbook
4.3.2.1. Selecting the Operating System
4.3.2.2. Intel HAL Configuration Tips
4.3.2.3. Micrium MicroC/OS-II Configuration tips
4.3.2.4. Configuring FreeRTOS*
4.3.2.5. Adding Software Package
4.3.2.6. Using Tcl Script with BSP Editor
4.3.2.7. Exporting Tcl Scripts with BSP Editor
4.3.2.8. Importing Tcl Script to Create a New BSP
7.1. HAL BSP Settings
7.2. The Nios® V Processor Embedded Project Structure
7.3. The system.h System Description File
7.4. Data Widths and the HAL Type Definitions
7.5. UNIX-Style Interface
7.6. Using Character-Mode Devices
7.7. Using Timer Devices
7.8. Using Flash Devices
7.9. Using DMA Devices
7.10. Interrupt Controllers
7.11. Reducing Code Footprint in Embedded Systems
7.12. Boot Sequence and Entry Point
7.13. Memory Usage
7.14. Working with HAL Source Files
7.11.1. Apply Compiler Flags
7.11.2. Use Small Variant Device Drivers
7.11.3. Reduce the File Descriptor Pool
7.11.4. Use /dev/null
7.11.5. Use a Smaller File I/O Library
7.11.6. Use the Minimal Character-Mode API
7.11.7. Eliminate Unused Device Drivers
7.11.8. Use the Picolibc Library
7.11.9. Eliminate Unused alt_load()
7.11.10. Eliminate Unneeded Exit Code
8.1. Driver Integration in the HAL API
8.2. The HAL Peripheral-Specific API
8.3. Preparing for HAL Driver Development
8.4. Development Flow for Creating Device Drivers
8.5. Nios® V Processor Hardware Design Concepts
8.6. Accessing Hardware
8.7. Creating Embedded Drivers for HAL Device Classes
8.8. Integrating a Device Driver in the HAL
8.9. Creating a Custom Device Driver for the HAL
8.10. Reducing Code Footprint in HAL Embedded Drivers
8.11. HAL Namespace Allocation
8.12. Overriding the HAL Default Device Drivers
8.8.5.2.1. Creating and Naming the Driver or Package
8.8.5.2.2. Identifying the Hardware Component Class
8.8.5.2.3. Setting the BSP Type
8.8.5.2.4. Specifying an Operating System
8.8.5.2.5. Specifying Source Files
8.8.5.2.6. Specifying a Subdirectory
8.8.5.2.7. Enabling Software Initialization
8.8.5.2.8. Adding Include Paths
8.8.5.2.9. Version Compatibility
9.1. Nios® V Processor Exception Handling Overview
9.2. Nios® V Processor Hardware Interrupt Service Routines
9.3. Nios® V Processor Software Interrupt Service Routines
9.4. Nios® V Processor Timer Interrupt Service Routine
9.5. Improving Nios® V Processor ISR Performance
9.6. Debugging Nios® V Processor ISRs
9.7. HAL Exception Handling System Implementation
9.8. Nios® V Processor Instruction-Related Exception Handler
9.5.1.1. Execute Time-Intensive Algorithms in the Application Context
9.5.1.2. Implement Time-Intensive Algorithms in Hardware
9.5.1.3. Increase Buffer Size
9.5.1.4. Use Double Buffering
9.5.1.5. Keep Interrupts Enabled
9.5.1.6. Use Fast Memory
9.5.1.7. Use a Separate Exception Stack
9.5.1.8. Use Nested Hardware Interrupts
9.5.1.9. Use Compiler Optimization
12.1. Overview of the MicroC/TCP-IP Protocol Stack
12.2. Support and Licensing
12.3. Prerequisites for Understanding the MicroC/TCP-IP Protocol Stack
12.4. Introduction to the MicroC/TCP-IP Protocol Stack - Nios® V Processor Edition
12.5. The MicroC/TCP-IP Protocol Stack Files and Directories
12.6. Enabling MicroC/TCP-IP Protocol Stack
12.7. Using the MicroC/TCP-IP Protocol Stack
16.1.1.1. _exit()
16.1.1.2. _rename()
16.1.1.3. alt_dcache_flush()
16.1.1.4. alt_dcache_flush_all()
16.1.1.5. alt_icache_flush_all()
16.1.1.6. alt_dcache_flush_no_writeback()
16.1.1.7. alt_icache_flush_all()
16.1.1.8. alt_icache_flush()
16.1.1.9. alt_alarm_start()
16.1.1.10. alt_alarm_stop()
16.1.1.11. alt_dma_rxchan_depth()
16.1.1.12. alt_dma_rxchan_close()
16.1.1.13. alt_dev_reg()
16.1.1.14. alt_dma_rxchan_open()
16.1.1.15. alt_dma_rxchan_prepare()
16.1.1.16. alt_dma_rxchan_reg()
16.1.1.17. alt_dma_txchan_close()
16.1.1.18. alt_dma_txchan_ioctl()
16.1.1.19. alt_dma_txchan_open()
16.1.1.20. alt_dma_txchan_reg()
16.1.1.21. alt_flash_close_dev()
16.1.1.22. alt_exception_cause_generated_bad_addr()
16.1.1.23. alt_erase_flash_block()
16.1.1.24. alt_dma_rxchan_ioctl()
16.1.1.25. alt_dma_txchan_space()
16.1.1.26. alt_dma_txchan_send()
16.1.1.27. alt_flash_open_dev()
16.1.1.28. alt_fs_reg()
16.1.1.29. alt_get_flash_info()
16.1.1.30. alt_ic_irq_disable()
16.1.1.31. alt_ic_irq_enabled()
16.1.1.32. alt_ic_isr_register()
16.1.1.33. alt_ic_irq_enable()
16.1.1.34. alt_instruction_exception_register()
16.1.1.35. alt_irq_cpu_enable_interrupts ()
16.1.1.36. alt_irq_disable_all()
16.1.1.37. alt_irq_enable_all()
16.1.1.38. alt_irq_enabled()
16.1.1.39. alt_irq_init()
16.1.1.40. alt_irq_pending ()
16.1.1.41. alt_llist_insert()
16.1.1.42. alt_llist_remove()
16.1.1.43. alt_load_section()
16.1.1.44. alt_nticks()
16.1.1.45. alt_read_flash()
16.1.1.46. alt_tick()
16.1.1.47. alt_ticks_per_second()
16.1.1.48. alt_timestamp()
16.1.1.49. alt_timestamp_freq()
16.1.1.50. alt_timestamp_start()
16.1.1.51. alt_write_flash()
16.1.1.52. alt_write_flash_block()
16.1.1.53. close()
16.1.1.54. fstat()
16.1.1.55. fork()
16.1.1.56. fcntl()
16.1.1.57. execve()
16.1.1.58. getpid()
16.1.1.59. kill()
16.1.1.60. stat()
16.1.1.61. settimeofday()
16.1.1.62. wait()
16.1.1.63. unlink()
16.1.1.64. sbrk()
16.1.1.65. link()
16.1.1.66. lseek()
16.1.1.67. open()
16.1.1.68. alt_sysclk_init()
16.1.1.69. times()
16.1.1.70. read()
16.1.1.71. write()
16.1.1.72. usleep()
16.1.1.73. alt_lock_flash()
16.1.1.74. gettimeofday()
16.1.1.75. ioctl()
16.1.1.76. isatty()
16.1.1.77. alt_niosv_enable_msw_interrupt()
16.1.1.78. alt_niosv_disable_msw_interrupt()
16.1.1.79. alt_niosv_is_msw_interrupt_enabled()
16.1.1.80. alt_niosv_trigger_msw_interrupt()
16.1.1.81. alt_niosv_clear_msw_interrupt()
16.1.1.82. alt_niosv_register_msw_interrupt_handler()
16.4.3.1. Intel HAL BSP
hal.enable_instruction_related_exceptions_api
hal.max_file_descriptors
hal.sys_clk_timer
hal.timestamp_timer
hal.linker.allow_code_at_reset
hal.linker.enable_alt_load
hal.linker.enable_alt_load_copy_exceptions
hal.linker.enable_alt_load_copy_rodata
hal.linker.enable_alt_load_copy_rwdata
hal.linker.enable_exception_stack
hal.linker.exception_stack_memory_region_name
hal.linker.use_picolibc
hal.linker.exception_stack_size
hal.toolchain.ar
hal.toolchain.as
hal.make.asflags
hal.make.cflags_debug
hal.make.cflags_defined_symbols
hal.make.cflags_optimization
hal.make.cflags_undefined_symbols
hal.make.cflags_user_flags
hal.make.cflags_warnings
hal.make.cxx_flags
hal.make.link_flags
hal.make.objdump_flags
hal.toolchain.cc
hal.toolchain.cxx
hal.toolchain.objdump
hal.make.enable_cflag_fstack_protector_strong
hal.make.enable_cflag_wformat_security
hal.toolchain.prefix
hal.toolchain.enable_executable_overrides
hal.enable_c_plus_plus
hal.enable_clean_exit
hal.enable_exit
hal.enable_reduced_device_drivers
hal.enable_lightweight_device_driver_api
hal.enable_runtime_stack_checking
hal.enable_sim_optimize
hal.log_port
hal.log_flags
hal.stderr
hal.stdin
hal.stdout
16.4.3.2. Micrium MicroC/OS-II BSP
16.4.3.3. FreeRTOS BSP
16.4.3.4. Device Drivers BSP
16.5.2.1. add_memory_device
16.5.2.2. add_memory_region
16.5.2.3. add_section_mapping
16.5.2.4. are_same_resource
16.5.2.5. delete_memory_region
16.5.2.6. delete_section_mapping
16.5.2.7. disable_sw_package
16.5.2.8. enable_sw_package
16.5.2.9. get_addr_span
16.5.2.10. get_assignment
16.5.2.11. get_available_drivers
16.5.2.12. get_available_sw_packages
16.5.2.13. get_base_addr
16.5.2.14. get_break_offset
16.5.2.15. get_break_slave_desc
16.5.2.16. get_cpu_name
16.5.2.17. get_current_memory_regions
16.5.2.18. get_current_section_mappings
16.5.2.19. get_default_memory_regions
16.5.2.20. get_driver
16.5.2.21. get_enabled_sw_packages
16.5.2.22. get_exception_offset
16.5.2.23. get_exception_slave_desc
16.5.2.24. get_fast_tlb_miss_exception_offset
16.5.2.25. get_fast_tlb_miss_exception_slave_desc
16.5.2.26. get_interrupt_controller_id
16.5.2.27. get_irq_interrupt_controller_id
16.5.2.28. get_irq_number
16.5.2.29. get_memory_region
16.5.2.30. get_module_class_name
16.5.2.31. get_module_name
16.5.2.32. get_reset_offset
16.5.2.33. get_reset_slave_desc
16.5.2.34. get_section_mapping
16.5.2.35. get_setting
16.5.2.36. get_setting_desc
16.5.2.37. get_slave_descs
16.5.2.38. is_char_device
16.5.2.39. is_connected_interrupt_controller_device
16.5.2.40. is_connected_to_data_master
16.5.2.41. is_connected_to_instruction_master
16.5.2.42. is_ethernet_mac_device
16.5.2.43. is_flash
16.5.2.44. is_memory_device
16.5.2.45. is_non_volatile_storage
16.5.2.46. is_timer_device
16.5.2.47. log_debug
16.5.2.48. log_default
16.5.2.49. log_error
16.5.2.50. log_verbose
16.5.2.51. set_driver
16.5.2.52. set_ignore_file
16.5.2.53. set_setting
16.5.2.54. update_memory_region
16.5.2.55. update_section_mapping
16.5.2.56. add_default_memory_regions
16.5.2.57. create_bsp
16.5.2.58. generate_bsp
16.5.2.59. get_available_bsp_type_versions
16.5.2.60. get_available_bsp_types
16.5.2.61. get_available_cpu_architectures
16.5.2.62. get_available_cpu_names
16.5.2.63. get_available_software
16.5.2.64. get_available_software_setting_properties
16.5.2.65. get_available_software_settings
16.5.2.66. get_bsp_version
16.5.2.67. get_cpu_architecture
16.5.2.68. get_sopcinfo_file
16.5.2.69. get_supported_bsp_types
16.5.2.70. is_bsp_hal_extension
16.5.2.71. open_bsp
16.5.2.72. save_bsp
16.5.2.73. set_bsp_version
16.5.2.74. set_logging_mode
16.5.3.1. add_class_sw_setting
16.5.3.2. add_class_systemh_line
16.5.3.3. add_module_sw_property
16.5.3.4. add_module_sw_setting
16.5.3.5. add_module_systemh_line
16.5.3.6. add_systemh_line
16.5.3.7. get_class_peripheral
16.5.3.8. get_module_assignment
16.5.3.9. get_module_name
16.5.3.10. get_module_peripheral
16.5.3.11. get_module_sw_setting_value
16.5.3.12. get_peripheral_property
16.5.3.13. remove_class_systemh_line
16.5.3.14. remove_module_systemh_line
16.5.3.15. set_class_sw_setting_property
16.5.3.16. set_module_sw_setting_property
Visible to Intel only — GUID: yhw1678076220082
Ixiasoft
16.4.3.1. Intel HAL BSP
hal.enable_instruction_related_exceptions_api
- Identifier:ALT_INCLUDE_INSTRUCTION_RELATED_EXCEPTION_API
- Type: Boolean definition
- Default Value: false
- Destination File: system.h
- Description: Enables application program interface (API) for registering handlers to service instruction-related exceptions. These exception types can be generated if various processor options are enabled, such as the memory management unit (MMU), memory protection unit (MPU), or other advanced exception types. Enabling this setting increases the size of the exception entry code.
- Restrictions: none
hal.max_file_descriptors
- Identifier: ALT_MAX_FD
- Type: Decimal number
- Default Value: 32
- Destination File: system.h
- Description: Determines the number of file descriptors statically allocated.
- Restriction: 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. This setting defines the value of ALT_MAX_FD in system.h.
hal.sys_clk_timer
- Identifier: ALT_SYS_CLK
- Type: Unquoted string
- Default Value: none
- Destination File: system.h
- Description: 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.
- Restriction: none
hal.timestamp_timer
- Identifier: ALT_TIMESTAMP_CLK
- Type: Unquoted string
- Default Value: none
- Destination File: system.h
- Description: Slave descriptor of timestamp timer device. This device is used by Intel HAL timestamp drivers for high-resolution time measurement. This setting defines the value of ALT_TIMESTAMP_CLK in system.h.
- Restriction: none
hal.linker.allow_code_at_reset
- Identifier: none
- Type: Boolean assignment
- Default Value: 0
- Destination File: none
- Description: Indicates if initialization code is allowed at the reset address. If true, defines the macro ALT_ALLOW_CODE_AT_RESET in linker.h.
- Restriction: This setting is typically false if an external bootloader (e.g. flash bootloader) is present.
hal.linker.enable_alt_load
- Identifier: none
- Type: Boolean assignment
- Default Value: 1
- Destination File: none
- Description: 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 (virtual memory address/low memory address) of sections in linker.x to allow them to be loaded into the .text memory.
- Restriction: This setting is typically false if an external bootloader (e.g. flash bootloader) is present.
hal.linker.enable_alt_load_copy_exceptions
- Identifier: none
- Type: Boolean assignment
- Default Value: 0
- Destination File: none
- Description: Causes the alt_load() facility to copy the .exceptions section. If true, this setting defines the macro ALT_LOAD_COPY_EXCEPTIONS in linker.h.
- Restriction: none
hal.linker.enable_alt_load_copy_rodata
- Identifier: none
- Type: Boolean assignment
- Default Value: 0
- Destination File: none
- Description: Causes the alt_load() facility to copy the .rodata section. If true, this setting defines the macro ALT_LOAD_COPY_RODATA in linker.h.
- Restriction: none
hal.linker.enable_alt_load_copy_rwdata
- Identifier: none
- Type: Boolean assignment
- Default Value: 0
- Destination File: none
- Description: Causes the initialization code to copy the .rwdata section. If true, this setting defines the macro ALT_LOAD_COPY_RWDATA in linker.h.
- Restriction: none
hal.linker.enable_exception_stack
- Identifier: none
- Type: Boolean assignment
- Default Value: 0
- Destination File: none
- Description: 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.
- Restriction: 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 an EIC is not implemented.
hal.linker.exception_stack_memory_region_name
- Identifier: none
- Type: Unquoted string
- Default Value: none
- Destination File: none
- Description: Name of the existing memory region to be divided up to create the exception_stack memory region. The selected region name is adjusted automatically when the BSP is generated to create the exception_stack memory region.
- Restriction: Only used if hal.linker.enable_exception_stack is true.
hal.linker.use_picolibc
- Identifier: USE_PICOLIBC
- Type: Boolean assignment
- Default Value: false
- Destination File: toolchain.cmake
- Description: Use Picolibc in place of Newlib to provide C library support.
- Restriction: none
hal.linker.exception_stack_size
- Identifier: none
- Type: Decimal number
- Default Value: 1024
- Destination File: none
- Description: Size of the exception stack in bytes.
- Restriction: Only used if hal.linker.enable_exception_stack is true. none
hal.toolchain.ar
- Identifier: CMAKE_AR
- Type: Unquoted string
- Default Value: riscv32-unknown-elf-ar
- Destination File: toolchain.cmake
- Description: Archiver command. Creates library files.
- Restriction: none
hal.toolchain.as
- Identifier: CMAKE_ASM_COMPILER
- Type: Unquoted string
- Default Value: riscv32-unknown-elf-gcc
- Destination File: toolchain.cmake
- Description: Assembler command. Note that CC is used for Nios® V processor assembly language source files (.S).
- Restriction: none
hal.make.asflags
- Identifier: COMPILE_LANGUAGE:ASM
- Type: Unquoted string
- Default Value: -Wa,-gdwarf2
- Destination File: toolchain.cmake
- Description: Custom flags only passed to the assembler. This setting defines the value of COMPILE_LANGUAGE:ASM in toolchain.cmake.
- Restriction: none
hal.make.cflags_debug
- Identifier: CMAKE_C_FLAGS_DEBUG and CMAKE_CXX_FLAGS_DEBUG
- Type: Unquoted string
- Default Value: -g
- Destination File: toolchain.cmake
- Description: C/C++ compiler debug level when CMAKE_BUILD_TYPE=Debug. -g provides the default set of debug symbols required to debug a typical application. Omitting -g removes debug symbols from the .elf file. This setting defines the value of CMAKE_C_FLAGS_DEBUG and CMAKE_CXX_FLAGS_DEBUG in toolchain.cmake.
- Restriction: Run cmake command with the flag, CMAKE_BUILD_TYPE=Debug
hal.make.cflags_defined_symbols
- Identifier: none
- Type: Unquoted string
- Default Value: none
- Destination File: toolchain.cmake
- Description: 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 source 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 source ( .c ), and C++ files in the BSP. This setting defines the value of preprocessor macros in the toolchain.cmake.
- Restriction: none
hal.make.cflags_optimization
- Identifier: CMAKE_C_FLAGS_RELEASE and CMAKE_CXX_FLAGS_RELEASE
- Type: Unquoted string
- Default Value: -O2
- Destination File: toolchain.cmake
- Description: C/C++ compiler optimization level when CMAKE__BUILD_TYPE=Release. -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 CMAKE_C_FLAGS_RELEASE and CMAKE_CXX_FLAGS_RELEASE in toolchain.cmake.
- Restriction: Run cmake command with the flag, CMAKE_BUILD_TYPE=Release
hal.make.cflags_undefined_symbols
- Identifier: none
- Type: Unquoted string
- Default Value: none
- Destination File: toolchain.cmake
- Description: 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 undefines preprocessor macros in the toolchain.cmake.
- Restriction: none
hal.make.cflags_user_flags
- Identifier: none
- Type: Unquoted string
- Default Value: none
- Destination File: toolchain.cmake
- Description: Custom flags passed to the compiler when compiling C, C++, and . S files . This setting defines the value of custom flags in toolchain.cmake.
- Restriction: none
hal.make.cflags_warnings
- Identifier: none
- Type: Unquoted string
- Default Value: -Wall-Wformat-security
- Destination File: toolchain.cmake
- Description: C/C++ compiler warning level. -Wall is commonly used. -Wformat-security warns about calls to printf and scanf functions, where the format string is not a string and there are no format arguments. This setting defines the warning levels in toolchain.cmake.
- Restriction: none
hal.make.cxx_flags
- Identifier: COMPILE_LANGUAGE:CXX
- Type: Unquoted string
- Default Value: none
- Destination File: toolchain.cmake
- Description: Custom flags only passed to the C++ compiler. This setting defines the value of COMPILE_LANGUAGE:CXX in toolchain.cmake.
- Restriction: none
hal.make.link_flags
- Identifier: none
- Type: Unquoted string
- Default Value: none
- Destination File: toolchain.cmake
- Description: Linker flags. This setting defines the linker flags in toolchain.cmake.
- Restriction: none
hal.make.objdump_flags
- Identifier: ToolchainObjdumpFlags
- Type: Unquoted string
- Default Value: -Sdtx
- Destination File: toolchain.cmake
- Description: Objdump flags. This setting defines ToolchainObjdumpFlags in toolchain.cmake.
- Restriction: none
hal.toolchain.cc
- Identifier: CMAKE_C_COMPILER
- Type: Unquoted string
- Default Value: riscv32-unknown-elf-gcc
- Destination File: toolchain.cmake
- Description: C compiler command
- Restriction: none
hal.toolchain.cxx
- Identifier: CMAKE_CXX_COMPILER
- Type: Unquoted string
- Default Value: riscv32-unknown-elf-g++
- Destination File: toolchain.cmake
- Description: C++ compiler command
- Restriction: none
hal.toolchain.objdump
- Identifier: ToolchainObjdump
- Type: Unqouted string
- Default Value: riscv32-unknown-elf-objdump
- Destination File: toolchain.cmake
- Description: Objdump command
- Restriction: none
hal.make.enable_cflag_fstack_protector_strong
- Identifier: none
- Type: Boolean assignment
- Default Value: 1
- Destination File: toolchain.cmake
- Description: Enable the fstack-protector-strong compiler flag in toolchain.cmake. If true, add -fstack-protector-strong.
- Restriction: none
hal.make.enable_cflag_wformat_security
- Identifier: none
- Type: Boolean assignment
- Default Value: 1
- Destination File: toolchain.cmake
- Description: Enable the Wformat and Wformat-security compiler flags in toolchain.cmake to warn against security problems when using format functions. If true, add -Wformat -Wformat-security.
- Restriction: none
hal.toolchain.prefix
- Identifier: ToolchainPrefix
- Type: Unquoted string
- Default Value: riscv32-unknown-elf-
- Description: Prefix to be used for toolchain executables. The value affects the individual values of the archiver, assembler, compiler, and linker. Specifically, it affects the settings.
- hal.toolchain.ar
- hal.toolchain.as
- hal.toolchain.cc
- hal.toolchain.cxx
- hal.toolchain.objdump
However, if the override setting hal.toolchain.enable_executable_overrides is enabled, the individual settings hal.toolchain.ar, hal.toolchain.as, hal.toolchain.cc, hal.toolchain.cxx, and hal.toolchain.objdump may be set to custom values and are not derived from this setting's value.
The riscv32-unknown-elf toolchain is available with the Ashling* RiscFree* IDE for Intel FPGAs. You must install the Ashling* RiscFree* IDE for Intel FPGAs to use this toolchain.
- Restriction: none
hal.toolchain.enable_executable_overrides
- Identifier: none
- Type: Boolean assignment
- Default value: false
- Description: Enable custom values to be set for the toolchain executables. You can set the settings for hal.toolchain.ar, hal.toolchain.as, hal.toolchain.cc, hal.toolchain.cxx, and hal.toolchain.objdump to custom values.
- Restriction: none
hal.enable_c_plus_plus
- Identifier: ALT_NO_C_PLUS_PLUS
- Type: Boolean assignment
- Default Value: 1
- Destination File: toolchain.cmake
- Description: 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, add ALT_NO_C_PLUS_PLUS in toolchain.cmake, and reduce code footprint.
- Restriction: none
hal.enable_clean_exit
- Identifier: ALT_NO_CLEAN_EXIT
- Type: Boolean assignment
- Default Value: 1
- Destination File: toolchain.cmake
- Description: When your application exits, close file descriptors, call C++ destructors, etc. Code footprint can be reduced by disabling clean exit. If disabled, adds ALT_NO_CLEAN_EXIT and -Wl, --defsym, exit=_exit in toolchain.cmake.
- Restriction: none
hal.enable_exit
- Identifier: ALT_NO_EXIT
- Type: Boolean assignment
- Default Value: 1
- Destination File: toolchain.cmake
- Description: Add exit() support. This option increases code footprint if your main() routine returns or calls exit(). If false, adds ALT_NO_EXIT in toolchain.cmake, and reduces footprint.
- Restriction: none
hal.enable_reduced_device_drivers
- Identifier: ALT_USE_SMALL_DRIVERS
- Type: Boolean assignment
- Default Value: 0
- Destination File: toolchain.cmake
- Description: Certain drivers are compiled with reduced functionality to reduce code footprint. Not all drivers observe this setting. If true, adds ALT_USE_SMALL_DRIVERS in toolchain.cmake. Typically, drivers support this setting with a polled mode. For example, the altera_avalon_uart and altera_avalon_jtag_uart reduced drivers operate in polled mode.
- Restriction: none
hal.enable_lightweight_device_driver_api
- Identifier: ALT_USE_DIRECT_DRIVERS
- Type: Boolean assignment
- Default Value: 0
- Destination File: toolchain.cmake
- Description: Enable lightweight device driver API to reduces code and data footprint. If true, add ALT_USE_DIRECT_DRIVERS in toolchain.cmake.
- Restriction: none
hal.enable_runtime_stack_checking
- Identifier: ALT_STACK_CHECK
- Type: Boolean assignment
- Default Value: 0
- Destination File: toolchain.cmake
- Description: Turns on HAL runtime stack checking feature. Enabling this setting enables the HAL to check if the heap collide with the stack when allocating heap memory, such as with malloc(). If true, adds ALT_STACK_CHECK in toolchain.cmake.
- Restriction: none
hal.enable_sim_optimize
- Identifier: ALT_SIM_OPTIMIZE
- Type: Boolean assignment
- Default Value: 0
- Destination File: toolchain.cmake
- Description: 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 ALT_SIM_OPTIMIZE in toolchain.cmake.
- Restriction: When this setting is true, the BSP cannot run on hardware.
hal.log_port
- Identifier: ALT_LOG_PORT
- Type: Unquoted string
- Default Value: none
- Destination File: system.h
- Description: 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 Intel FPGA logging functions.
hal.log_flags
- Identifier: ALT_LOG_FLAGS
- Type: Decimal Number
- Default Value: 0
- Destination File: toolchain.cmake
- Description: The value is assigned to ALT_LOG_FLAGS in the generated toolchain.cmake. Refer to hal.log_port for further details. The valid range of this setting is -1 through 3.
hal.stderr
- Identifier: ALT_STDERR
- Type: Unquoted string
- Default Value: none
- Destination File: system.h
- Description: Slave descriptor of STDERR character-mode device. This setting is used by the ALT_STDERR family of defines in system.h.
hal.stdin
- Identifier:ALT_STDIN
- Type: Unquoted string
- Default Value: none
- Destination File: system.h
- Description: Slave descriptor of STDIN character-mode device. This setting is used by the ALT_STDIN family of defines in system.h.
hal.stdout
- Identifier: ALT_STDOUT
- Type: Unquoted string
- Default Value: none
- Destination File: system.h
- Description: Slave descriptor of STDOUT character-mode device. This setting is used by the ALT_STDOUT family of defines in system.h.