fprime/Svc/RateGroupDriver/RateGroupDriver.hpp
Thomas Boyer-Chammard c69ff72110
Format Svc and add to CI (#3978)
* Format Svc and add to CI

* Fix comlogger include

* fix assert UTs

* Fix static analysis warning

* formatting
2025-08-04 16:21:47 -07:00

98 lines
2.7 KiB
C++

/**
* \author T. Canham
* \brief RateGroupDivider component implementation
*
* This component implements a divider function. A primary tick is invoked
* via the CycleIn port. The divider array then divides down the tick into
* CycleOut ports. The ports are called at the rate of
* input rate/divider[port]
*
* \copyright
* Copyright 2009-2015, by the California Institute of Technology.
* ALL RIGHTS RESERVED. United States Government Sponsorship
* acknowledged.
* <br /><br />
*/
#ifndef SVC_RATEGROUPDRIVER_HPP
#define SVC_RATEGROUPDRIVER_HPP
#include <Fw/FPrimeBasicTypes.hpp>
#include <Svc/RateGroupDriver/RateGroupDriverComponentAc.hpp>
namespace Svc {
//! \class RateGroupDriver
//! \brief Implementation class for RateGroupDriver
//!
//! Takes the input from CycleIn and divides it.
//! Output rate is CycleIn rate/divider[port]
//!
class RateGroupDriver final : public RateGroupDriverComponentBase {
friend class RateGroupDriverImplTester;
public:
//! Size of the divider table, provided as a constants to users passing the table in
static const FwIndexType DIVIDER_SIZE = NUM_CYCLEOUT_OUTPUT_PORTS;
//! \class Divider
//! \brief Struct describing a divider
struct Divider {
//! Initializes divisor and offset to 0 (unused)
Divider() : divisor(0), offset(0) {}
//! Initializes divisor and offset to passed-in pair
Divider(FwSizeType divisorIn, FwSizeType offsetIn) : divisor(divisorIn), offset(offsetIn) {}
//! Divisor
FwSizeType divisor;
//! Offset
FwSizeType offset;
};
//! \class DividerSet
//! \brief Struct containing an array of dividers
struct DividerSet {
//! Dividers
Divider dividers[Svc::RateGroupDriver::DIVIDER_SIZE];
};
//! \brief RateGroupDriver constructor
//!
//! The constructor takes the divider array and stores it
//! for use when the CycleIn port is called.
//!
//! \param compName component name
//!
RateGroupDriver(const char* compName);
//! \brief RateGroupDriver configuration function
//! \param dividersSet set of dividers used to divide down input tick
void configure(const DividerSet& dividersSet);
//! \brief RateGroupDriverImpl destructor
~RateGroupDriver();
private:
//! downcall for input port
//! NOTE: This port can execute in ISR context.
void CycleIn_handler(FwIndexType portNum, Os::RawTime& cycleStart);
//! divider array
Divider m_dividers[NUM_CYCLEOUT_OUTPUT_PORTS];
//! tick counter
FwSizeType m_ticks;
//! rollover counter
FwSizeType m_rollover;
//! has the configure method been called
bool m_configured;
};
} // namespace Svc
#endif