fsfw/doc/README-config.md

41 lines
1.8 KiB
Markdown
Raw Normal View History

2021-05-18 15:31:04 +02:00
Configuring the FSFW
======
2020-12-22 13:23:19 +01:00
The FSFW can be configured via the `fsfwconfig` folder. A template folder has
been provided to have a starting point for this. The folder should be added
2021-05-18 15:12:48 +02:00
to the include path. The primary configuration file is the `FSFWConfig.h` folder. Some
of the available options will be explained in more detail here.
2021-05-18 15:31:04 +02:00
# Auto-Translation of Events
2020-12-22 13:23:19 +01:00
2021-05-18 15:12:48 +02:00
The FSFW allows the automatic translation of events, which allows developers to track triggered
2021-05-18 15:37:05 +02:00
events directly via console output. Using this feature requires:
2021-05-18 15:12:48 +02:00
1. `FSFW_OBJ_EVENT_TRANSLATION` set to 1 in the configuration file.
2. Special auto-generated translation files which translate event IDs and object IDs into
human readable strings. These files can be generated using the
[modgen Python scripts](https://git.ksat-stuttgart.de/source/modgen.git).
3. The generated translation files for the object IDs should be named `translatesObjects.cpp`
and `translateObjects.h` and should be copied to the `fsfwconfig/objects` folder
4. The generated translation files for the event IDs should be named `translateEvents.cpp` and
`translateEvents.h` and should be copied to the `fsfwconfig/events` folder
An example implementations of these translation file generators can be found as part
of the [SOURCE project here](https://git.ksat-stuttgart.de/source/sourceobsw/-/tree/development/generators)
or the [FSFW example](https://egit.irs.uni-stuttgart.de/fsfw/fsfw_example_public/src/branch/master/generators)
2020-12-22 13:23:19 +01:00
2021-05-18 15:31:04 +02:00
## Configuring the Event Manager
2020-12-22 13:23:19 +01:00
The number of allowed subscriptions can be modified with the following
parameters:
``` c++
namespace fsfwconfig {
//! Configure the allocated pool sizes for the event manager.
static constexpr size_t FSFW_EVENTMGMR_MATCHTREE_NODES = 240;
static constexpr size_t FSFW_EVENTMGMT_EVENTIDMATCHERS = 120;
static constexpr size_t FSFW_EVENTMGMR_RANGEMATCHERS = 120;
}
2021-05-18 15:12:48 +02:00
```