kopia lustrzana https://github.com/OpenRTX/OpenRTX
147 wiersze
4.0 KiB
C++
147 wiersze
4.0 KiB
C++
/***************************************************************************
|
|
* Copyright (C) 2021 - 2023 by Federico Amedeo Izzo IU2NUO, *
|
|
* Niccolò Izzo IU2KIN *
|
|
* Frederik Saraci IU2NRO *
|
|
* Silvano Seva IU2KWO *
|
|
* *
|
|
* This program is free software; you can redistribute it and/or modify *
|
|
* it under the terms of the GNU General Public License as published by *
|
|
* the Free Software Foundation; either version 3 of the License, or *
|
|
* (at your option) any later version. *
|
|
* *
|
|
* This program is distributed in the hope that it will be useful, *
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of *
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
|
|
* GNU General Public License for more details. *
|
|
* *
|
|
* You should have received a copy of the GNU General Public License *
|
|
* along with this program; if not, see <http://www.gnu.org/licenses/> *
|
|
***************************************************************************/
|
|
|
|
#ifndef M17_STREAM_FRAME_H
|
|
#define M17_STREAM_FRAME_H
|
|
|
|
#ifndef __cplusplus
|
|
#error This header is C++ only!
|
|
#endif
|
|
|
|
#include <cstring>
|
|
#include <string>
|
|
#include "M17Datatypes.hpp"
|
|
|
|
namespace M17
|
|
{
|
|
|
|
class M17FrameDecoder;
|
|
|
|
/**
|
|
* This class describes and handles a generic M17 data frame.
|
|
*/
|
|
class M17StreamFrame
|
|
{
|
|
public:
|
|
|
|
/**
|
|
* Constructor.
|
|
*/
|
|
M17StreamFrame()
|
|
{
|
|
clear();
|
|
}
|
|
|
|
/**
|
|
* Destructor.
|
|
*/
|
|
~M17StreamFrame(){ }
|
|
|
|
/**
|
|
* Clear the frame content, filling it with zeroes.
|
|
*/
|
|
void clear()
|
|
{
|
|
memset(&data, 0x00, sizeof(data));
|
|
}
|
|
|
|
/**
|
|
* Set frame sequence number.
|
|
*
|
|
* @param seqNum: frame number, between 0 and 0x7FFF.
|
|
*/
|
|
void setFrameNumber(const uint16_t seqNum)
|
|
{
|
|
// NOTE: M17 fields are big-endian, we need to swap bytes
|
|
data.frameNum = __builtin_bswap16(seqNum & FN_MASK);
|
|
}
|
|
|
|
/**
|
|
* Get frame sequence number.
|
|
*
|
|
* @return frame number, between 0 and 0x7FFF.
|
|
*/
|
|
uint16_t getFrameNumber()
|
|
{
|
|
// NOTE: M17 fields are big-endian, we need to swap bytes
|
|
return __builtin_bswap16(data.frameNum);
|
|
}
|
|
|
|
/**
|
|
* Mark this frame as the last one in the transmission, informing the
|
|
* receiver that transmission ends.
|
|
*/
|
|
void lastFrame()
|
|
{
|
|
data.frameNum |= EOS_BIT;
|
|
}
|
|
|
|
/**
|
|
* Check if this frame is the last one that is, get the value of the EOS
|
|
* bit.
|
|
*
|
|
* @return true if the frame has the EOS bit set.
|
|
*/
|
|
bool isLastFrame()
|
|
{
|
|
return ((data.frameNum & EOS_BIT) != 0) ? true : false;
|
|
}
|
|
|
|
/**
|
|
* Access frame payload.
|
|
*
|
|
* @return a reference to frame's paylod field, allowing for both read and
|
|
* write access.
|
|
*/
|
|
payload_t& payload()
|
|
{
|
|
return data.payload;
|
|
}
|
|
|
|
/**
|
|
* Get underlying data.
|
|
*
|
|
* @return a pointer to const uint8_t allowing direct access to frame data.
|
|
*/
|
|
const uint8_t *getData()
|
|
{
|
|
return reinterpret_cast < const uint8_t * > (&data);
|
|
}
|
|
|
|
private:
|
|
|
|
struct __attribute__((packed))
|
|
{
|
|
uint16_t frameNum; // Frame number
|
|
payload_t payload; // Payload data
|
|
}
|
|
data;
|
|
///< Frame data.
|
|
static constexpr uint16_t EOS_BIT = 0x0080; ///< End Of Stream bit.
|
|
static constexpr uint16_t FN_MASK = 0x7FFF; ///< Bitmask for frame number.
|
|
|
|
// Frame decoder class needs to access raw frame data
|
|
friend class M17FrameDecoder;
|
|
};
|
|
|
|
} // namespace M17
|
|
|
|
#endif // M17_STREAM_FRAME_H
|