View on GitHub

Flight Software & Embedded Systems Framework

settings.ini: Build Settings Configuration

In many circumstances it is useful to set default values for the build as well as configure external locations for F´ to use external code. The settings.ini file allows users to set various settings to control the build.

In this document:

WARNING: The changes to the settings.ini file only take effect during the fprime-util generate step, and thus builds must be regenerated after a change.

settings.ini Settings

The settings.ini file is written in the INI format as interpreted by the default settings of the Python configparser module. Should a user with to reference another key, use the %(other key)s syntax. Full format description is available here:

https://docs.python.org/3/library/configparser.html#supported-ini-file-structure

This file is expected in the directory of the an F´ deployment and affects only the deployment it is defined in. This directory is the same directory that contains the project’s base CMakeLists.txt (has a project() call).

WARNING: The changes to the settings.ini file only take effect during the fprime-util generate step, and thus builds must be regenerated after a change.

fprime Section

The [fprime] section defines settings for the F´ build.

These settings include:

Platform Sections

Some settings may be overridden for specific platforms using specific platform sections. These sections have the same name as the platform and may set the following settings:

  1. config_directory
  2. ac_constants
  3. install_destination
  4. environment_file

These settings only apply when building for the specified platform.

Example settings.ini

This settings.ini file comes from the fprime-sphinx deployment, which is a standard standalone deployment where the F´ framework and libraries are included as git submodules at the top level.

[fprime]
project_root: ..
framework_path: ../fprime
library_locations: ../fprime-vxworks:../fprime-sphinx-drivers:../fprime-jplffs
default_toolchain: gr712-vxworks6
environment_file: ../fprime-vxworks/cmake/env/VxWorks-GR712.ini
ac_constants: ./Cfg/AcConstants.ini
config_directory: Cfg

[gr712-vxworks6]
config_directory: Cfg_gr712

Example Environment Ini File

The format for the environment file option is similar to settings.ini Each key in the file will be set as environmental variable for the project build.

[environment]
WIND_BASE=/opt/WindRiver/vxworks-6.7
LINK_BIN_PRE=/opt/sparc-wrs-vxworks/bin/ccsparc
LINK_BIN_PRE_FLAGS=-r -nostdlib -Wl,-X
LINK_BIN_PRE_TO=-o