2021-01-13 11:53:34 +01:00
|
|
|
#ifndef FSFW_DATAPOOLLOCAL_PROVIDESDATAPOOLSUBSCRIPTION_H_
|
|
|
|
|
#define FSFW_DATAPOOLLOCAL_PROVIDESDATAPOOLSUBSCRIPTION_H_
|
|
|
|
|
|
2021-01-13 12:43:53 +01:00
|
|
|
#include "localPoolDefinitions.h"
|
|
|
|
|
#include "../ipc/messageQueueDefinitions.h"
|
|
|
|
|
#include "../returnvalues/HasReturnvaluesIF.h"
|
2021-01-13 11:53:34 +01:00
|
|
|
|
|
|
|
|
|
|
|
|
|
class ProvidesDataPoolSubscriptionIF {
|
|
|
|
|
public:
|
2021-01-13 12:41:24 +01:00
|
|
|
virtual ~ProvidesDataPoolSubscriptionIF(){};
|
2021-01-13 11:53:34 +01:00
|
|
|
|
2021-01-13 12:41:24 +01:00
|
|
|
/**
|
|
|
|
|
* @brief Subscribe for the generation of periodic packets.
|
|
|
|
|
* @details
|
|
|
|
|
* This subscription mechanism will generally be used by the data creator
|
|
|
|
|
* to generate housekeeping packets which are downlinked directly.
|
|
|
|
|
* @return
|
|
|
|
|
*/
|
|
|
|
|
virtual ReturnValue_t subscribeForPeriodicPacket(sid_t sid,
|
|
|
|
|
bool enableReporting,
|
|
|
|
|
float collectionInterval, bool isDiagnostics,
|
|
|
|
|
object_id_t packetDestination) = 0;
|
2021-01-13 11:53:34 +01:00
|
|
|
|
|
|
|
|
|
2021-01-13 12:41:24 +01:00
|
|
|
/**
|
|
|
|
|
* @brief Subscribe for the generation of packets if the dataset
|
|
|
|
|
* is marked as changed.
|
|
|
|
|
* @details
|
|
|
|
|
* This subscription mechanism will generally be used by the data creator.
|
|
|
|
|
* @param sid
|
|
|
|
|
* @param isDiagnostics
|
|
|
|
|
* @param packetDestination
|
|
|
|
|
* @return
|
|
|
|
|
*/
|
|
|
|
|
virtual ReturnValue_t subscribeForUpdatePackets(sid_t sid,
|
|
|
|
|
bool reportingEnabled,
|
|
|
|
|
bool isDiagnostics,
|
|
|
|
|
object_id_t packetDestination) = 0;
|
2021-01-13 11:53:34 +01:00
|
|
|
|
2021-01-13 12:41:24 +01:00
|
|
|
/**
|
|
|
|
|
* @brief Subscribe for a notification message which will be sent
|
|
|
|
|
* if a dataset has changed.
|
|
|
|
|
* @details
|
|
|
|
|
* This subscription mechanism will generally be used internally by
|
|
|
|
|
* other software components.
|
|
|
|
|
* @param setId Set ID of the set to receive update messages from.
|
|
|
|
|
* @param destinationObject
|
|
|
|
|
* @param targetQueueId
|
|
|
|
|
* @param generateSnapshot If this is set to true, a copy of the current
|
|
|
|
|
* data with a timestamp will be generated and sent via message.
|
|
|
|
|
* Otherwise, only an notification message is sent.
|
|
|
|
|
* @return
|
|
|
|
|
*/
|
|
|
|
|
virtual ReturnValue_t subscribeForSetUpdateMessages(const uint32_t setId,
|
2021-02-04 01:31:46 +01:00
|
|
|
object_id_t destinationObject, MessageQueueId_t targetQueueId,
|
2021-01-13 12:41:24 +01:00
|
|
|
bool generateSnapshot) = 0;
|
2021-01-13 11:53:34 +01:00
|
|
|
|
2021-01-13 12:41:24 +01:00
|
|
|
/**
|
|
|
|
|
* @brief Subscribe for an notification message which will be sent if a
|
|
|
|
|
* pool variable has changed.
|
|
|
|
|
* @details
|
|
|
|
|
* This subscription mechanism will generally be used internally by
|
|
|
|
|
* other software components.
|
|
|
|
|
* @param localPoolId Pool ID of the pool variable
|
|
|
|
|
* @param destinationObject
|
|
|
|
|
* @param targetQueueId
|
|
|
|
|
* @param generateSnapshot If this is set to true, a copy of the current
|
|
|
|
|
* data with a timestamp will be generated and sent via message.
|
|
|
|
|
* Otherwise, only an notification message is sent.
|
|
|
|
|
* @return
|
|
|
|
|
*/
|
|
|
|
|
virtual ReturnValue_t subscribeForVariableUpdateMessages(
|
|
|
|
|
const lp_id_t localPoolId,
|
|
|
|
|
object_id_t destinationObject,
|
|
|
|
|
MessageQueueId_t targetQueueId,
|
|
|
|
|
bool generateSnapshot) = 0;
|
2021-01-13 11:53:34 +01:00
|
|
|
|
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
#endif /* FSFW_DATAPOOLLOCAL_PROVIDESDATAPOOLSUBSCRIPTION_H_ */
|
