fsfw/doc/README-core.md

2.4 KiB

FSFW Core Modules

These core modules provide the most important functionalities of the Flight Software Framework

Clock

  • This is a class of static functions that can be used at anytime
  • Leap Seconds must be set if any time conversions from UTC to other times is used

ObjectManager

  • Must be created during program startup
  • The component which handles all references. All SystemObjects register at this component.
  • Any SystemObject needs to have a unique ObjectId. Those can be managed like objects::framework_objects.
  • A reference to an object can be get by calling the following function. T must be the specific Interface you want to call. A nullptr check of the returning Pointer must be done. This function is based on Run-time type information.
template <typename T> T* ObjectManagerIF::get( object_id_t id )
  • A typical way to create all objects on startup is a handing a static produce function to the ObjectManager on creation. By calling objectManager->initialize() the produce function will be called and all SystemObjects will be initialized afterwards.

Event Manager

  • Component which allows routing of events
  • Other objects can subscribe to specific events, ranges of events or all events of an object.
  • Subscriptions can be done during runtime but should be done during initialization
  • Amounts of allowed subscriptions can be configured in FSFWConfig.h

Health Table

  • A component which holds every health state
  • Provides a thread safe way to access all health states without the need of message exchanges

Stores

  • The message based communication can only exchange a few bytes of information inside the message itself. Therefore, additional information can be exchanged with Stores. With this, only the store address must be exchanged in the message.
  • Internally, the FSFW uses an IPC Store to exchange data between processes. For incoming TCs a TC Store is used. For outgoing TM a TM store is used.
  • All of them should use the Thread Safe Class storagemanager/PoolManager

Tasks

There are two different types of tasks:

  • The PeriodicTask just executes objects that are of type ExecutableObjectIF in the order of the insertion to the Tasks.
  • FixedTimeslotTask executes a list of calls in the order of the given list. This is intended for DeviceHandlers, where polling should be in a defined order. An example can be found in defaultcfg/fsfwconfig/pollingSequence