Project structure

The following table describes the standard set of folders and files generated for an application project and displayed in the Project Explorer view. All folders and files are located inside the project's root folder.

Table 1. S32DS Application Project: Folders and files
Folder/file Description
Binaries This virtual folder appears after the project build and references the generated executable file (<project_name>.elf).
Includes This virtual source folder contains the list of all discovered header files, including the header files used in the project directly.
Project_Settings This folder includes the lower-level folders:
  • Startup_Code: Includes the initialization scripts generated by the project creation wizard.
  • Debugger: Includes the launch configurations (LAUNCH files) generated by the wizard.
  • Linker_Files: Includes the linker files generated by the wizard.
SDK (Optional) This folder is available if the SDK is attached to project. The SDK descriptor specifies which files will be copied to this project folder.
board (Optional) This folder is available if the project uses the device configuration feature. The folder has no content when created. When the user configures MCU pins and clocks, the source files with code are generated and placed in this folder.
include This folder includes the toolchain header files.
src This folder includes the source files. The main.c or main.cpp file is included by default, other files can be added by the user.
<build_configuration_name> This folder appears after the project build. The name of the folder matches the name of the build configuration used for the build (Debug or Release, or a custom configuration).
The following lower-level folders are generated inside:
  • board: Includes the O, D, ARG files and the makefile generated from the source files located in the <project_root_folder>/board folder.
  • Project_Settings/Startup_Code: Includes the O, D, ARG files and the makefile generated from the initialization scripts located in the <project_root_folder>/Project_Settings/Startup_Code folder.
  • SDK: Includes the O, D, ARG files and the makefile generated from the source files located in the <project_root_folder>/SDK folder.
  • src: Includes the O, D, ARG files and the makefile generated from the source files located in the <project_root_folder>/src folder.

The folder also includes files <project_name>.elf (executable), <project_name>.arg, <project_name>.map and makefiles generated for the project.

description.txt This file includes a brief description of the project. The text is entered by the user in the project creation wizard.
<processor_family>.mex (Optional) This file stores the device configuration in the XML format. The file is available if the project supports the device configuration feature.

The following table describes the standard set of folders and files generated for a library project and displayed in the Project Explorer view. All folders and files are located inside the project's root folder.

Table 2. S32DS Library Project: Folders and files
Folder/file Description
Archives This virtual folder appears after the project build and references the generated archive file (lib<project_name>.a) with the project's object file inside.
Includes This virtual source folder contains the list of all discovered header files, including the header files used in the project directly.
SDK (Optional) This folder is available if the SDK is attached to project. The SDK descriptor specifies which files will be copied to this project folder.
include This folder includes the toolchain header files.
src This folder includes the source files. The mylibrary.c or mylibrary.cpp file is included by default, other files can be added by the user.
<build_configuration_name> This folder appears after the project build. The name of the folder matches the name of the build configuration used for the build (Debug or Release, or a custom configuration).
The following lower-level folders are generated inside:
  • board: Includes the O, D, ARG files and the makefile generated from the source files located in the <project_root_folder>/board folder.
  • SDK: Includes the O, D, ARG files and the makefile generated from the source files located in the <project_root_folder>/SDK folder.
  • src: Includes the O, D, ARG files and the makefile generated from the source files located in the <project_root_folder>/src folder.

The folder also includes the lib<project_name>.a archive file (containing the project's object file) and makefiles generated for the project.