fsfw/pus/Service5EventReporting.h

#ifndef FRAMEWORK_PUS_SERVICE5EVENTREPORTING_H_
#define FRAMEWORK_PUS_SERVICE5EVENTREPORTING_H_

#include "../tmtcservices/PusServiceBase.h"
#include "../events/EventMessage.h"

/**
 * @brief Report on-board events like information or errors
 * @details
 * Full Documentation: ECSS-E70-41A p.79
 * Implements the PusServiceBase template class.
 * Documentation: Dissertation Baetz p.135,136
 *
 * This service provides for the reporting to the service user of information of
 * operational significance.
 *   1. reporting of failures or anomalies detected on-board;
 *   2. reporting of autonomous on-board actions;
 *   3. reporting of normal progress of operations and activities, e.g.
 *   detection of events which are not anomalous (such as payload events),
 *   reaching of predefined steps in an operation. Some reports can combine
 *   more than one of these events.
 *
 * Minimum capabilities of this service:
 *
 * - TM[5,1]: Normal/Progress Report
 * - TM[5,2]: Error/Anomaly Report - Low Severity
 * - TM[5,3]: Error/Anomaly Report - Medium Severity
 * - TM[5,4]: Error/Anomaly Report - High Severity
 *
 * Events can be translated by using translator files located in
 * /config/objects/ and /config/events/. Description to events can be added by
 * adding a comment behind the event definition with [//!<] as leading string
 *
 * Additional capabilities of this service:
 *
 *  - TC[5,5]: Enable Event Report Generation (Req. 6)
 *  - TC[5,6]: Disable Event Report Generation (Req. 5)
 * @author 	R. Mueller
 * @ingroup pus_services
 */
class Service5EventReporting: public PusServiceBase {
public:

	Service5EventReporting(object_id_t objectId, uint16_t apid,
	        uint8_t serviceId, size_t maxNumberReportsPerCycle = 10);
	virtual ~Service5EventReporting();

	/***
	* Check for events and generate event reports if required.
	* @return
	*/
	ReturnValue_t performService() override;

	/***
	 * Turn event generation on or off.
	 * @return
	 */
	ReturnValue_t handleRequest(uint8_t subservice) override;

	/**
	 * The default PusServiceBase initialize has been overridden but is still
	 * executed. Registers this service as a listener for events at the
	 * EventManager.
	 * @return
	 */
	ReturnValue_t initialize() override;

	enum Subservice: uint8_t {
		NORMAL_REPORT = 1, //!< [EXPORT] : [REPLY] Generate normal report
		ERROR_LOW_SEVERITY = 2, //!< [EXPORT] : [REPLY] Generate error report with low severity
		ERROR_MED_SEVERITY = 3, //!< [EXPORT] : [REPLY] Generate error report with medium severity
		ERROR_HIGH_SEVERITY = 4, //!< [EXPORT] : [REPLY] Generate error report with high severity
		ENABLE = 5, //!< [EXPORT] : [COMMAND] Enable report generation
		DISABLE = 6 //!< [EXPORT] : [COMMAND] Disable report generation
	};

private:
	uint16_t packetSubCounter = 0;
	MessageQueueIF* eventQueue = nullptr;
	bool enableEventReport = true;
	const uint8_t maxNumberReportsPerCycle;

	ReturnValue_t generateEventReport(EventMessage message);
};

#endif /* MISSION_PUS_SERVICE5EVENTREPORTING_H_ */