Robin Mueller
5907f8ee9d
This PR adds the packet stack for the CCSDS File Delivery Protocol. It also refactors the existing TMTC infastructure to allow sending of CFDP packets to the CCSDS handlers. This includes the whole PDU (Protocol Data Unit) stack: - File Data PDUs and all file directive PDUs - ACK PDU - NAK PDU - Metadata PDU - Finished PDU - Prompt PDU - Keep Alive PDU - EOF PDU The PR includes a full set of unittests for the packet stack with a coverage of 90+ %. The refactoring of the existing TMTC infastructure includes non-ideal solutions like diamond inheritance. Avoiding this solution would require refactoring the packet stack. This would be a good idea anyway because the existing stack is tightly coupled to the FSFW, making reuse more difficult if only the stack is planned to be used without the store functionalities etc. The PDU implementation provided here is only weakly coupled to the FSFW, only using components like returnvalues or the Serialization modules. There are dedicated serializers and deserializers, which also helps in creating small focused modules which are easy to test. Some of the modules here were provied by Matthias Tompert.
73 lines
2.5 KiB
C++
73 lines
2.5 KiB
C++
#ifndef FRAMEWORK_TCDISTRIBUTION_CCSDSDISTRIBUTOR_H_
|
|
#define FRAMEWORK_TCDISTRIBUTION_CCSDSDISTRIBUTOR_H_
|
|
|
|
#include "../objectmanager/ObjectManagerIF.h"
|
|
#include "../storagemanager/StorageManagerIF.h"
|
|
#include "../tcdistribution/CCSDSDistributorIF.h"
|
|
#include "../tcdistribution/TcDistributor.h"
|
|
#include "../tmtcservices/AcceptsTelecommandsIF.h"
|
|
|
|
/**
|
|
* @brief An instantiation of the CCSDSDistributorIF.
|
|
* @details
|
|
* It receives Space Packets, and selects a destination depending on the
|
|
* APID of the telecommands.
|
|
* The Secondary Header (with Service/Subservice) is ignored.
|
|
* @ingroup tc_distribution
|
|
*/
|
|
class CCSDSDistributor:
|
|
public TcDistributor,
|
|
public CCSDSDistributorIF,
|
|
public AcceptsTelecommandsIF {
|
|
public:
|
|
/**
|
|
* @brief The constructor sets the default APID and calls the
|
|
* TcDistributor ctor with a certain object id.
|
|
* @details
|
|
* @c tcStore is set in the @c initialize method.
|
|
* @param setDefaultApid The default APID, where packets with unknown
|
|
* destination are sent to.
|
|
*/
|
|
CCSDSDistributor(uint16_t setDefaultApid, object_id_t setObjectId);
|
|
/**
|
|
* The destructor is empty.
|
|
*/
|
|
virtual ~CCSDSDistributor();
|
|
|
|
MessageQueueId_t getRequestQueue() override;
|
|
ReturnValue_t registerApplication( uint16_t apid,
|
|
MessageQueueId_t id) override;
|
|
ReturnValue_t registerApplication(
|
|
AcceptsTelecommandsIF* application) override;
|
|
uint16_t getIdentifier() override;
|
|
ReturnValue_t initialize() override;
|
|
|
|
protected:
|
|
/**
|
|
* This implementation checks if an application with fitting APID has
|
|
* registered and forwards the packet to the according message queue.
|
|
* If the packet is not found, it returns the queue to @c defaultApid,
|
|
* where a Acceptance Failure message should be generated.
|
|
* @return Iterator to map entry of found APID or iterator to default APID.
|
|
*/
|
|
TcMqMapIter selectDestination() override;
|
|
/**
|
|
* The callback here handles the generation of acceptance
|
|
* success/failure messages.
|
|
*/
|
|
ReturnValue_t callbackAfterSending( ReturnValue_t queueStatus ) override;
|
|
|
|
/**
|
|
* The default APID, where packets with unknown APID are sent to.
|
|
*/
|
|
uint16_t defaultApid;
|
|
/**
|
|
* A reference to the TC storage must be maintained, as this class handles
|
|
* pure Space Packets and there exists no SpacePacketStored class.
|
|
*/
|
|
StorageManagerIF* tcStore = nullptr;
|
|
|
|
};
|
|
|
|
#endif /* FRAMEWORK_TCDISTRIBUTION_CCSDSDISTRIBUTOR_H_ */
|