fsfw/monitoring/MonitorBase.h

79 lines
2.2 KiB
C
Raw Normal View History

2020-10-12 17:42:30 +02:00
#ifndef FSFW_MONITORING_MONITORBASE_H_
#define FSFW_MONITORING_MONITORBASE_H_
2020-08-28 18:33:29 +02:00
2020-09-29 18:01:55 +02:00
#include "LimitViolationReporter.h"
#include "MonitoringIF.h"
#include "MonitoringMessageContent.h"
#include "MonitorReporter.h"
2020-08-28 18:33:29 +02:00
2020-11-18 21:15:14 +01:00
#include "../datapoollocal/LocalPoolVariable.h"
2020-10-12 17:42:30 +02:00
2020-08-28 18:33:29 +02:00
/**
2020-10-12 17:42:30 +02:00
* @brief Base class for monitoring of parameters.
* @details
* Can be used anywhere, specializations need to implement checkSample and
* should override sendTransitionEvent.
* Manages state handling, enabling and disabling of events/reports and
* forwarding of transition reports via MonitorReporter.
*
* In addition, it provides default implementations for fetching the
* parameter sample from the data pool and a simple confirmation counter.
2020-08-28 18:33:29 +02:00
*/
template<typename T>
class MonitorBase: public MonitorReporter<T> {
public:
2020-11-18 21:15:14 +01:00
2020-08-28 18:33:29 +02:00
MonitorBase(object_id_t reporterId, uint8_t monitorId,
2020-11-30 15:30:56 +01:00
gp_id_t globalPoolId, uint16_t confirmationLimit):
MonitorReporter<T>(reporterId, monitorId, globalPoolId,
2020-11-18 21:15:14 +01:00
confirmationLimit),
2020-11-30 15:30:56 +01:00
poolVariable(globalPoolId) {
2020-08-28 18:33:29 +02:00
}
2020-11-18 21:15:14 +01:00
2020-08-28 18:33:29 +02:00
virtual ~MonitorBase() {
}
2020-11-18 21:15:14 +01:00
2020-08-28 18:33:29 +02:00
virtual ReturnValue_t check() {
2020-10-12 17:42:30 +02:00
// 1. Fetch sample of type T, return validity.
2020-08-28 18:33:29 +02:00
T sample = 0;
ReturnValue_t validity = fetchSample(&sample);
2020-10-12 17:42:30 +02:00
// 2. If returning from fetch != OK, parameter is invalid.
// Report (if oldState is != invalidity).
2020-08-28 18:33:29 +02:00
if (validity != HasReturnvaluesIF::RETURN_OK) {
this->monitorStateIs(validity, sample, 0);
} else {
2020-11-18 21:15:14 +01:00
//3. Otherwise, check sample.
2020-08-28 18:33:29 +02:00
this->oldState = doCheck(sample);
}
return this->oldState;
}
virtual ReturnValue_t doCheck(T sample) {
T crossedLimit = 0.0;
ReturnValue_t currentState = checkSample(sample, &crossedLimit);
return this->monitorStateIs(currentState,sample, crossedLimit);
}
2020-10-12 17:42:30 +02:00
// Abstract or default.
2020-08-28 18:33:29 +02:00
virtual ReturnValue_t checkSample(T sample, T* crossedLimit) = 0;
protected:
2020-11-18 21:15:14 +01:00
2020-08-28 18:33:29 +02:00
virtual ReturnValue_t fetchSample(T* sample) {
2020-11-18 21:15:14 +01:00
ReturnValue_t result = poolVariable.read();
if(result != HasReturnvaluesIF::RETURN_OK) {
return result;
}
if (not poolVariable.isValid()) {
return MonitoringIF::INVALID;
}
*sample = poolVariable.value;
return HasReturnvaluesIF::RETURN_OK;
2020-08-28 18:33:29 +02:00
}
2020-11-18 21:15:14 +01:00
2020-12-14 22:55:12 +01:00
LocalPoolVariable<T> poolVariable;
2020-08-28 18:33:29 +02:00
};
2020-10-12 17:42:30 +02:00
#endif /* FSFW_MONITORING_MONITORBASE_H_ */