Nios® V Processor Software Developer Handbook

ID 743810
Date 7/20/2023
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

4.3.2.2. BSP Files

The BSP Editor places generated files in the top-level BSP directory, and copied files in the HAL and drivers directories.
  • If you select the MicroC/OS-II operating system, the BSP Editor creates an additional UCOSII directory.
  • If you select the FreeRTOS operating system, the BSP Editor creates additional FREERTOS and FreeRTOS-Kernel directories.
Table 17.  BSP Files After Generating Files
File Name File Type Function
drivers Directory Copied File
  • Contains all driver source code.
  • The src directory contains the C-language and assembly-language source files.
  • The inc directory contains the header files.
HAL Directory Copied File
  • Contains HAL source code files.
  • The HAL directory has src and inc subdirectories like the drivers directory.
  • The crt0.S source file, containing HAL C run-time start-up code, resides in the HAL/src directory.
UCOSII Directory Copied File
  • Contains MicroC/OS-II source code files.
  • Only available when you select MicroC/OS-II operating system.
  • The UCOSII directory has src and inc subdirectories such as the drivers directory.
FREERTOS Directory Copied File
  • Contains FreeRTOS OS-HAL contribution-related source code files.
  • Only available when you select FreeRTOS operating system.
  • The FREERTOS directory has src and inc subdirectories such as the drivers directory.
FreeRTOS-Kernel Directory Copied File
  • Contains FreeRTOS OS services-related and RISC-V port support source code files.
  • Only available when you select FreeRTOS operating system.
alt_sys_init.c Generated File

Used to initialize device driver instances and software packages.

CMakeLists.txt Generated File

Used to build the BSP by listing the files and directories targeted by the build and other build settings.

linker.h Generated File

Contains information about the linker memory layout. system.h includes the linker.h file.

linker.x Generated File Contains a linker script for the GNU linker.
memory.gdb Generated File Contains memory region declarations for the GNU debugger.
settings.bsp Generated File Contains all BSP settings. This file is coded in XML.
summary.html Generated File
  • Provides summary documentation of the BSP.
  • You can view summary.html with a hypertext viewer or browser.
  • If you change the settings.bsp file, the BSP Editor updates the summary.html file the next time you regenerate the BSP.
system.h Generated File

Contains the C declarations describing the BSP memory map and other system information needed by software applications.

toolchain.cmake Generated File Lists the compiler configurations for the build.