eive-obsw/mission/devices/devicedefinitions/PlocDefinitions.h

173 lines
7.0 KiB
C
Raw Normal View History

2021-04-11 12:04:13 +02:00
#ifndef MISSION_DEVICES_DEVICEDEFINITIONS_PLOCDEFINITIONS_H_
#define MISSION_DEVICES_DEVICEDEFINITIONS_PLOCDEFINITIONS_H_
#include <fsfw/tmtcpacket/SpacePacket.h>
#include <fsfw/globalfunctions/CRC.h>
2021-04-15 13:17:15 +02:00
#include <fsfw/serialize/SerializeAdapter.h>
2021-04-11 12:04:13 +02:00
namespace PLOC {
static const DeviceCommandId_t NONE = 0x0;
static const DeviceCommandId_t TC_MEM_WRITE = 0x714;
static const DeviceCommandId_t TC_MEM_READ = 0x715;
<<<<<<< Updated upstream
=======
static const DeviceCommandId_t ACK_SUCCESS = 0x400;
static const DeviceCommandId_t ACK_FAILURE = 0x401;
static const DeviceCommandId_t EXE_SUCCESS = 0x402;
static const DeviceCommandId_t EXE_FAILURE = 0x403;
static const DeviceCommandId_t TM_READ_REPORT = 0x404;
>>>>>>> Stashed changes
2021-04-11 12:04:13 +02:00
static const uint16_t SIZE_ACK_REPORT = 14;
static const uint16_t SIZE_EXE_REPORT = 14;
static const uint16_t SIZE_TM_MEM_READ_REPORT = 18;
2021-04-16 18:59:48 +02:00
/** Reply comprises one ack report, the telemetry packet and the execution report */
static const uint16_t SIZE_TC_MEM_READ_REPLY = 49;
2021-04-11 12:04:13 +02:00
/**
* SpacePacket apids of PLOC telecommands and telemetry.
*/
static const uint16_t APID_TC_MEM_WRITE = 0x714;
2021-04-12 10:16:59 +02:00
static const uint16_t APID_TC_MEM_READ = 0x715;
2021-04-11 12:04:13 +02:00
static const uint16_t APID_TM_READ_REPORT = 0x404;
2021-04-15 13:17:15 +02:00
static const uint16_t APID_ACK_SUCCESS = 0x400;
static const uint16_t APID_ACK_FAILURE = 0x401;
2021-04-11 12:04:13 +02:00
static const uint16_t APID_EXE_SUCCESS = 0x402;
static const uint16_t APID_EXE_FAILURE = 0x403;
/**
* PLOC space packet length for fixed size packets. This is the size of the whole packet data
* field. For the length field in the space packet this size will be substracted by one.
*/
static const uint16_t LENGTH_TC_MEM_WRITE = 12;
static const uint16_t LENGTH_TC_MEM_READ = 8;
2021-04-16 18:59:48 +02:00
static const size_t MAX_REPLY_SIZE = SIZE_TC_MEM_READ_REPLY;
2021-04-15 13:17:15 +02:00
static const size_t MAX_COMMAND_SIZE = 18;
2021-04-11 12:04:13 +02:00
/**
* @brief This class helps to build the memory read command for the PLOC.
*
* @details The last two bytes of the packet data field contain a CRC calculated over the whole
* space packet. This is the CRC-16-CCITT as specified in
* ECSS-E-ST-70-41C <EFBFBD> Telemetry and telecommand packet utilization.
*/
class TcMemRead : public SpacePacket {
public:
2021-04-15 13:17:15 +02:00
2021-04-11 12:04:13 +02:00
/**
* @brief Constructor
*
* @param memAddr The memory address to read from.
*/
TcMemRead(const uint32_t memAddr) :
SpacePacket(LENGTH_TC_MEM_READ - 1, true, APID_TC_MEM_READ) {
fillPacketDataField(&memAddr);
}
private:
/**
* @brief This function builds the packet data field for the mem read command.
*
* @param memAddrPtr Pointer to the memory address to read from.
*/
void fillPacketDataField(const uint32_t* memAddrPtr) {
/* Add memAddr to packet data field */
2021-04-15 13:17:15 +02:00
size_t serializedSize = 0;
uint8_t* memoryAddressPos = this->localData.fields.buffer;
SerializeAdapter::serialize<uint32_t>(memAddrPtr, &memoryAddressPos, &serializedSize,
sizeof(*memAddrPtr), SerializeIF::Endianness::BIG);
2021-04-11 12:04:13 +02:00
/* Add memLen to packet data field */
this->localData.fields.buffer[OFFSET_MEM_LEN_FIELD] = 0;
this->localData.fields.buffer[OFFSET_MEM_LEN_FIELD + 1] = 1;
2021-04-15 13:17:15 +02:00
/* Calculate crc */
2021-04-11 12:04:13 +02:00
uint16_t crc = CRC::crc16ccitt(this->localData.byteStream,
sizeof(CCSDSPrimaryHeader) + LENGTH_TC_MEM_READ - CRC_SIZE, 0);
2021-04-15 13:17:15 +02:00
2021-04-11 12:04:13 +02:00
/* Add crc to packet data field of space packet */
2021-04-15 13:17:15 +02:00
serializedSize = 0;
uint8_t* crcPos = this->localData.fields.buffer + CRC_OFFSET;
SerializeAdapter::serialize<uint16_t>(&crc, &crcPos, &serializedSize,
sizeof(crc), SerializeIF::Endianness::BIG);
2021-04-11 12:04:13 +02:00
memcpy(this->localData.fields.buffer + CRC_OFFSET, &crc, sizeof(crc));
}
2021-04-15 13:17:15 +02:00
static const uint8_t OFFSET_MEM_LEN_FIELD = 4;
static const uint8_t CRC_OFFSET = 6;
2021-04-11 12:04:13 +02:00
};
/**
* @brief This class helps to generate the space packet to write to a memory address within
* the PLOC.
* @details The last two bytes of the packet data field contain a CRC calculated over the whole
* space packet. This is the CRC-16-CCITT as specified in
* ECSS-E-ST-70-41C <EFBFBD> Telemetry and telecommand packet utilization.
*/
class TcMemWrite : public SpacePacket {
public:
/**
* @brief Constructor
*
* @param memAddr The PLOC memory address where to write to.
* @param memoryData The data to write to the specified memory address.
*/
TcMemWrite(const uint32_t memAddr, const uint32_t memoryData) :
SpacePacket(LENGTH_TC_MEM_WRITE - 1, true, APID_TC_MEM_WRITE) {
fillPacketDataField(&memAddr, &memoryData);
}
private:
/**
* @brief This function builds the packet data field for the mem write command.
*
* @param memAddrPtr Pointer to the PLOC memory address where to write to.
* @param memoryDataPtr Pointer to the memoryData to write
*/
void fillPacketDataField(const uint32_t* memAddrPtr, const uint32_t* memoryDataPtr) {
2021-04-15 13:17:15 +02:00
2021-04-11 12:04:13 +02:00
/* Add memAddr to packet data field */
2021-04-15 13:17:15 +02:00
size_t serializedSize = 0;
uint8_t* memoryAddressPos = this->localData.fields.buffer;
SerializeAdapter::serialize<uint32_t>(memAddrPtr, &memoryAddressPos, &serializedSize,
sizeof(*memAddrPtr), SerializeIF::Endianness::BIG);
2021-04-11 12:04:13 +02:00
/* Add memLen to packet data field */
this->localData.fields.buffer[OFFSET_MEM_LEN_FIELD] = 0;
this->localData.fields.buffer[OFFSET_MEM_LEN_FIELD + 1] = 1;
2021-04-15 13:17:15 +02:00
2021-04-11 12:04:13 +02:00
/* Add memData to packet data field */
2021-04-15 13:17:15 +02:00
serializedSize = 0;
uint8_t* memoryDataPos = this->localData.fields.buffer + OFFSET_MEM_DATA_FIELD;
SerializeAdapter::serialize<uint32_t>(memoryDataPtr, &memoryDataPos, &serializedSize,
sizeof(*memoryDataPtr), SerializeIF::Endianness::BIG);
/* Calculate crc */
2021-04-11 12:04:13 +02:00
uint16_t crc = CRC::crc16ccitt(this->localData.byteStream,
sizeof(CCSDSPrimaryHeader) + LENGTH_TC_MEM_WRITE - CRC_SIZE, 0);
2021-04-15 13:17:15 +02:00
serializedSize = 0;
uint8_t* crcPos = this->localData.fields.buffer + CRC_OFFSET;
2021-04-11 12:04:13 +02:00
/* Add crc to packet data field of space packet */
2021-04-15 13:17:15 +02:00
SerializeAdapter::serialize<uint16_t>(&crc, &crcPos, &serializedSize,
sizeof(crc), SerializeIF::Endianness::BIG);
2021-04-11 12:04:13 +02:00
memcpy(this->localData.fields.buffer + CRC_OFFSET, &crc, sizeof(crc));
}
2021-04-15 13:17:15 +02:00
/** Offsets from base address of packet data field */
static const uint8_t OFFSET_MEM_LEN_FIELD = 4;
static const uint8_t OFFSET_MEM_DATA_FIELD = 6;
static const uint8_t CRC_OFFSET = 10;
2021-04-11 12:04:13 +02:00
};
}
#endif /* MISSION_DEVICES_DEVICEDEFINITIONS_PLOCDEFINITIONS_H_ */