98 lines
2.7 KiB
C++
98 lines
2.7 KiB
C++
#ifndef FSFW_CONTROLLER_CONTROLLERBASE_H_
|
|
#define FSFW_CONTROLLER_CONTROLLERBASE_H_
|
|
|
|
#include "../health/HasHealthIF.h"
|
|
#include "../health/HealthHelper.h"
|
|
#include "../modes/HasModesIF.h"
|
|
#include "../modes/ModeHelper.h"
|
|
#include "../objectmanager/SystemObject.h"
|
|
#include "../tasks/ExecutableObjectIF.h"
|
|
#include "../tasks/PeriodicTaskIF.h"
|
|
#include "../datapool/HkSwitchHelper.h"
|
|
|
|
/**
|
|
* @brief Generic base class for controller classes
|
|
* @details
|
|
* Implements common interfaces for controllers, which generally have
|
|
* a mode and a health state. This avoids boilerplate code.
|
|
*/
|
|
class ControllerBase: public HasModesIF,
|
|
public HasHealthIF,
|
|
public ExecutableObjectIF,
|
|
public SystemObject,
|
|
public HasReturnvaluesIF {
|
|
public:
|
|
static const Mode_t MODE_NORMAL = 2;
|
|
|
|
ControllerBase(object_id_t setObjectId, object_id_t parentId,
|
|
size_t commandQueueDepth = 3);
|
|
virtual ~ControllerBase();
|
|
|
|
/** SystemObject override */
|
|
virtual ReturnValue_t initialize() override;
|
|
|
|
virtual MessageQueueId_t getCommandQueue() const override;
|
|
|
|
/** HasHealthIF overrides */
|
|
virtual ReturnValue_t setHealth(HealthState health) override;
|
|
virtual HasHealthIF::HealthState getHealth() override;
|
|
|
|
/** ExecutableObjectIF overrides */
|
|
virtual ReturnValue_t performOperation(uint8_t opCode) override;
|
|
virtual void setTaskIF(PeriodicTaskIF* task) override;
|
|
virtual ReturnValue_t initializeAfterTaskCreation() override;
|
|
|
|
protected:
|
|
|
|
/**
|
|
* Implemented by child class. Handle command messages which are not
|
|
* mode or health messages.
|
|
* @param message
|
|
* @return
|
|
*/
|
|
virtual ReturnValue_t handleCommandMessage(CommandMessage *message) = 0;
|
|
|
|
/**
|
|
* Periodic helper, implemented by child class.
|
|
*/
|
|
virtual void performControlOperation() = 0;
|
|
|
|
virtual ReturnValue_t checkModeCommand(Mode_t mode, Submode_t submode,
|
|
uint32_t *msToReachTheMode) = 0;
|
|
|
|
const object_id_t parentId;
|
|
|
|
Mode_t mode;
|
|
|
|
Submode_t submode;
|
|
|
|
MessageQueueIF* commandQueue = nullptr;
|
|
|
|
ModeHelper modeHelper;
|
|
|
|
HealthHelper healthHelper;
|
|
|
|
// Is this still needed?
|
|
HkSwitchHelper hkSwitcher;
|
|
|
|
/**
|
|
* Pointer to the task which executes this component,
|
|
* is invalid before setTaskIF was called.
|
|
*/
|
|
PeriodicTaskIF* executingTask = nullptr;
|
|
|
|
/** Handle mode and health messages */
|
|
virtual void handleQueue();
|
|
|
|
/** Mode helpers */
|
|
virtual void modeChanged(Mode_t mode, Submode_t submode);
|
|
virtual void startTransition(Mode_t mode, Submode_t submode);
|
|
virtual void getMode(Mode_t *mode, Submode_t *submode);
|
|
virtual void setToExternalControl();
|
|
virtual void announceMode(bool recursive);
|
|
/** HK helpers */
|
|
virtual void changeHK(Mode_t mode, Submode_t submode, bool enable);
|
|
};
|
|
|
|
#endif /* FSFW_CONTROLLER_CONTROLLERBASE_H_ */
|