eive-obsw/mission/tmtc/CCSDSHandler.h

181 lines
6.2 KiB
C
Raw Normal View History

2021-09-19 12:27:48 +02:00
#ifndef CCSDSHANDLER_H_
#define CCSDSHANDLER_H_
2022-01-17 15:58:27 +01:00
#include <unordered_map>
2021-09-26 08:29:30 +02:00
#include "OBSWConfig.h"
2022-01-17 15:58:27 +01:00
#include "VirtualChannel.h"
2021-11-21 18:07:05 +01:00
#include "fsfw/action/ActionHelper.h"
#include "fsfw/action/HasActionsIF.h"
2021-11-22 18:01:16 +01:00
#include "fsfw/events/EventMessage.h"
2022-01-17 15:58:27 +01:00
#include "fsfw/objectmanager/SystemObject.h"
#include "fsfw/parameters/ParameterHelper.h"
#include "fsfw/returnvalues/HasReturnvaluesIF.h"
#include "fsfw/tasks/ExecutableObjectIF.h"
#include "fsfw/timemanager/Countdown.h"
#include "fsfw/tmtcservices/AcceptsTelecommandsIF.h"
#include "fsfw/tmtcservices/AcceptsTelemetryIF.h"
2021-11-22 18:01:16 +01:00
#include "fsfw_hal/common/gpio/GpioIF.h"
2022-01-17 15:58:27 +01:00
#include "fsfw_hal/common/gpio/gpioDefinitions.h"
#include "linux/obc/PtmeConfig.h"
2021-09-19 12:27:48 +02:00
/**
* @brief This class handles the data exchange with the CCSDS IP cores implemented in the
* programmable logic of the Q7S.
*
2022-01-24 07:43:14 +01:00
* @details After reboot default CADU bitrate is always set to 100 kbps (results in downlink rate
* of 200 kbps due to convolutional code added by syrlinks transceiver)
*
2021-09-19 12:27:48 +02:00
* @author J. Meier
*/
2022-01-17 15:58:27 +01:00
class CCSDSHandler : public SystemObject,
public ExecutableObjectIF,
public AcceptsTelemetryIF,
public AcceptsTelecommandsIF,
public HasReturnvaluesIF,
public ReceivesParameterMessagesIF,
public HasActionsIF {
public:
using VcId_t = uint8_t;
/**
* @brief Constructor
*
* @param objectId Object ID of the CCSDS handler
* @param ptmeId Object ID of the PTME object providing access to the PTME IP Core.
* @param tcDestination Object ID of object handling received TC space packets
* @param txRateSetter Object providing the functionality to switch the input bitrate of
* the S-Band transceiver.
* @param gpioIF Required to enable TX data and TX clock RS485 transceiver chips.
* @param enTxClock GPIO ID of RS485 tx clock enable
* @param enTxData GPIO ID of RS485 tx data enable
*/
CCSDSHandler(object_id_t objectId, object_id_t ptmeId, object_id_t tcDestination,
2022-03-26 13:54:05 +01:00
PtmeConfig* ptmeConfig, GpioIF* gpioIF, gpioId_t enTxClock, gpioId_t enTxData,
uint32_t transmitterTimeout = 900000);
2022-01-17 15:58:27 +01:00
~CCSDSHandler();
ReturnValue_t performOperation(uint8_t operationCode = 0) override;
ReturnValue_t initialize();
MessageQueueId_t getCommandQueue() const;
/**
* @brief Function to add a virtual channel
*
* @param virtualChannelId ID of the virtual channel to add
* @param virtualChannel Pointer to virtual channel object
*/
void addVirtualChannel(VcId_t virtualChannelId, VirtualChannel* virtualChannel);
MessageQueueId_t getReportReceptionQueue(uint8_t virtualChannel = 0);
ReturnValue_t getParameter(uint8_t domainId, uint8_t uniqueIdentifier,
ParameterWrapper* parameterWrapper, const ParameterWrapper* newValues,
uint16_t startAtIndex);
uint16_t getIdentifier() override;
MessageQueueId_t getRequestQueue() override;
virtual ReturnValue_t executeAction(ActionId_t actionId, MessageQueueId_t commandedBy,
const uint8_t* data, size_t size);
private:
static const uint8_t INTERFACE_ID = CLASS_ID::CCSDS_HANDLER;
static const uint32_t QUEUE_SIZE = common::CCSDS_HANDLER_QUEUE_SIZE;
static const ActionId_t SET_LOW_RATE = 0;
static const ActionId_t SET_HIGH_RATE = 1;
static const ActionId_t EN_TRANSMITTER = 2;
static const ActionId_t DISABLE_TRANSMITTER = 3;
static const ActionId_t ARBITRARY_RATE = 4;
static const ActionId_t ENABLE_TX_CLK_MANIPULATOR = 5;
static const ActionId_t DISABLE_TX_CLK_MANIPULATOR = 6;
// Will update data with respect to tx clock signal of cadu bitsream on rising edge
static const ActionId_t UPDATE_ON_RISING_EDGE = 7;
// Will update data with respect to tx clock signal of cadu bitsream on falling edge
static const ActionId_t UPDATE_ON_FALLING_EDGE = 8;
// Syrlinks supports two bitrates (200 kbps and 1000 kbps)
// Due to convolutional code added by the syrlinks the input frequency must be half the
// target frequency
static const uint32_t RATE_100KBPS = 100000;
static const uint32_t RATE_500KBPS = 500000;
2022-01-17 15:58:27 +01:00
//! [EXPORT] : [COMMENT] Received action message with unknown action id
static const ReturnValue_t COMMAND_NOT_IMPLEMENTED = MAKE_RETURN_CODE(0xA0);
2021-11-21 18:07:05 +01:00
2022-01-19 14:17:55 +01:00
// syrlinks must not be transmitting more than 15 minutes (according to datasheet)
2022-03-26 13:54:05 +01:00
// Value can be configured via CTOR argument to allow test setups
const uint32_t TRANSMITTER_TIMEOUT = 900000; // 900000 ms = 15 min
2021-11-22 18:01:16 +01:00
2022-01-17 15:58:27 +01:00
static const bool UP = true;
static const bool DOWN = false;
2021-11-22 18:01:16 +01:00
2022-01-17 15:58:27 +01:00
using VirtualChannelMap = std::unordered_map<VcId_t, VirtualChannel*>;
using VirtualChannelMapIter = VirtualChannelMap::iterator;
2021-09-22 16:54:55 +02:00
2022-01-17 15:58:27 +01:00
VirtualChannelMap virtualChannelMap;
2021-09-22 16:54:55 +02:00
2022-01-17 15:58:27 +01:00
// Object ID of PTME object
object_id_t ptmeId;
2021-09-26 08:29:30 +02:00
2022-01-17 15:58:27 +01:00
object_id_t tcDestination;
2021-11-01 12:41:20 +01:00
2022-01-17 15:58:27 +01:00
MessageQueueIF* commandQueue = nullptr;
MessageQueueIF* eventQueue = nullptr;
2021-09-26 08:29:30 +02:00
2022-01-17 15:58:27 +01:00
ParameterHelper parameterHelper;
2021-09-26 08:29:30 +02:00
2022-01-17 15:58:27 +01:00
ActionHelper actionHelper;
2021-11-21 18:07:05 +01:00
2022-02-19 16:42:22 +01:00
MessageQueueId_t tcDistributorQueueId = MessageQueueIF::NO_QUEUE;
2021-11-01 12:41:20 +01:00
PtmeConfig* ptmeConfig = nullptr;
2021-11-21 18:07:05 +01:00
2022-01-17 15:58:27 +01:00
GpioIF* gpioIF = nullptr;
gpioId_t enTxClock = gpio::NO_GPIO;
gpioId_t enTxData = gpio::NO_GPIO;
2021-11-22 18:01:16 +01:00
2022-01-17 15:58:27 +01:00
// Countdown to disable transmitter after 15 minutes
Countdown transmitterCountdown;
2021-11-22 18:01:16 +01:00
2022-01-17 15:58:27 +01:00
// When true transmitting is started as soon as carrier lock has been detected
bool enableTxWhenCarrierLock = false;
2021-11-22 18:01:16 +01:00
2022-01-17 15:58:27 +01:00
bool linkState = DOWN;
2021-11-22 18:01:16 +01:00
2022-01-17 15:58:27 +01:00
void readCommandQueue(void);
void handleTelemetry();
void handleTelecommands();
void checkEvents();
void handleEvent(EventMessage* eventMessage);
2021-11-22 18:01:16 +01:00
2022-01-17 15:58:27 +01:00
void handleBitLockEvent();
void handleCarrierLockEvent();
2021-11-22 18:01:16 +01:00
2022-01-17 15:58:27 +01:00
/**
* @brief Forward link state to virtual channels.
*/
void forwardLinkstate();
2021-11-22 18:01:16 +01:00
2022-01-17 15:58:27 +01:00
/**
* @brief Starts transmit timer and enables transmitter.
*/
void enableTransmit();
2021-11-22 18:01:16 +01:00
2022-01-17 15:58:27 +01:00
/**
* @brief Checks Tx timer for timeout and disables RS485 tx clock and tx data in case
* timer has expired.
*/
void checkTxTimer();
2021-11-22 18:01:16 +01:00
2022-01-17 15:58:27 +01:00
/**
* @brief Disables the transmitter by pulling the enable tx clock and tx data pin of the
* RS485 transceiver chips to high.
*/
void disableTransmit();
2021-09-19 12:27:48 +02:00
};
#endif /* CCSDSHANDLER_H_ */