Update/passive rg

Svc/CMakeLists.txt

@@ -54,3 +54,4 @@ if(${CMAKE_SYSTEM_NAME} STREQUAL "Linux" OR ${CMAKE_SYSTEM_NAME} STREQUAL "Darwi
 	add_fprime_subdirectory("${CMAKE_CURRENT_LIST_DIR}/LinuxTime/")
 	add_fprime_subdirectory("${CMAKE_CURRENT_LIST_DIR}/LinuxTimer/")
 endif()
+add_fprime_subdirectory("${CMAKE_CURRENT_LIST_DIR}/PassiveRateGroup")

Svc/PassiveRateGroup/CMakeLists.txt

@@ -0,0 +1,29 @@
+#### CMakeLists.txt PassiveRateGroup ####
+
+# Specifies the sources for this module with optional sources included by platform
+set(SOURCE_FILES
+    "${CMAKE_CURRENT_LIST_DIR}/PassiveRateGroup.cpp"
+    "${CMAKE_CURRENT_LIST_DIR}/PassiveRateGroup.hpp"
+    "${CMAKE_CURRENT_LIST_DIR}/PassiveRateGroup.fpp"
+)
+
+
+# Specifies any module dependencies not detectable via the model file dependency detection
+#set(MOD_DEPS ...)
+
+# Registers this module with the fprime build system
+register_fprime_module()
+
+# Specifies the sources specifically associated with unit tests in this module
+set(UT_SOURCE_FILES
+    "${CMAKE_CURRENT_LIST_DIR}/test/ut/PassiveRateGroupTester.cpp"
+    "${CMAKE_CURRENT_LIST_DIR}/test/ut/PassiveRateGroupImplTester.cpp"
+    "${CMAKE_CURRENT_LIST_DIR}/PassiveRateGroup.fpp"
+)
+
+
+# Specifies any unit test modules
+#set(UT_MOD_DEPS ...)
+
+# Registers this module with the fprime build system
+register_fprime_ut()

Svc/PassiveRateGroup/PassiveRateGroup.cpp

@@ -0,0 +1,68 @@
+/*
+ * \author: Tim Canham
+ * \file:
+ * \brief
+ *
+ * This file implements the PassiveRateGroup component,
+ * which invokes a set of components the comprise the rate group.
+ *
+ *   Copyright 2014-2015, by the California Institute of Technology.
+ *   ALL RIGHTS RESERVED. United States Government Sponsorship
+ *   acknowledged. Any commercial use must be negotiated with the Office
+ *   of Technology Transfer at the California Institute of Technology.
+ */
+
+#include <FpConfig.hpp>
+#include <Fw/Types/Assert.hpp>
+#include <Os/Log.hpp>
+#include <Svc/PassiveRateGroup/PassiveRateGroup.hpp>
+
+namespace Svc {
+PassiveRateGroup::PassiveRateGroup(const char* compName)
+    : PassiveRateGroupComponentBase(compName), m_cycles(0), m_maxTime(0), m_numContexts(0) {
+}
+
+PassiveRateGroup::~PassiveRateGroup(void) {}
+
+void PassiveRateGroup::configure(NATIVE_INT_TYPE contexts[], NATIVE_INT_TYPE numContexts) {
+    FW_ASSERT(contexts);
+    FW_ASSERT(numContexts == this->getNum_RateGroupMemberOut_OutputPorts(),numContexts,this->getNum_RateGroupMemberOut_OutputPorts());
+    FW_ASSERT(FW_NUM_ARRAY_ELEMENTS(this->m_contexts) == this->getNum_RateGroupMemberOut_OutputPorts(),
+              FW_NUM_ARRAY_ELEMENTS(this->m_contexts),
+              this->getNum_RateGroupMemberOut_OutputPorts());
+
+    this->m_numContexts = numContexts;
+    // copy context values
+    for (NATIVE_INT_TYPE entry = 0; entry < this->m_numContexts; entry++) {
+        this->m_contexts[entry] = contexts[entry];
+    }
+}
+
+
+void PassiveRateGroup::CycleIn_handler(NATIVE_INT_TYPE portNum, Svc::TimerVal& cycleStart) {
+    TimerVal end;
+    FW_ASSERT(this->m_numContexts);
+
+    // invoke any members of the rate group
+    for (NATIVE_INT_TYPE port = 0; port < this->getNum_RateGroupMemberOut_OutputPorts(); port++) {
+        if (this->isConnected_RateGroupMemberOut_OutputPort(port)) {
+            this->RateGroupMemberOut_out(port, this->m_contexts[port]);
+        }
+    }
+
+    // grab timer for end of cycle
+    end.take();
+
+    // get rate group execution time
+    U32 cycle_time = end.diffUSec(cycleStart);
+
+    // check to see if the time has exceeded the previous maximum
+    if (cycle_time > this->m_maxTime) {
+        this->m_maxTime = cycle_time;
+    }
+    this->tlmWrite_MaxCycleTime(this->m_maxTime);
+    this->tlmWrite_CycleTime(cycle_time);
+    this->tlmWrite_CycleCount(this->m_cycles++);
+}
+
+}  // namespace Svc

Svc/PassiveRateGroup/PassiveRateGroup.fpp

@@ -0,0 +1,30 @@
+module Svc {
+
+  @ A rate group passive component with input and output scheduler ports
+  passive component PassiveRateGroup {
+
+    @ The rate group cycle input
+    sync input port CycleIn: Cycle
+
+    @ Scheduler output port to rate group members
+    output port RateGroupMemberOut: [PassiveRateGroupOutputPorts] Sched
+
+    @ Max execution time of rate group cycle
+    telemetry MaxCycleTime: U32 update on change format "{} us"
+
+    @ Execution time of current cycle
+    telemetry CycleTime: U32 format "{} us"
+
+    @ Count of number of cycles
+    telemetry CycleCount: U32
+
+    # Standard ports
+    @ A port for getting the time
+    time get port Time
+
+    @ A port for emitting telemetry
+    telemetry port Tlm
+
+  }
+
+}

Svc/PassiveRateGroup/PassiveRateGroup.hpp

@@ -0,0 +1,78 @@
+/*
+ * \author: Tim Canham
+ * \file:
+ * \brief
+ *
+ * This file implements the PassiveRateGroup component,
+ * which invokes a set of components the comprise the rate group.
+ *
+ *   Copyright 2014-2015, by the California Institute of Technology.
+ *   ALL RIGHTS RESERVED. United States Government Sponsorship
+ *   acknowledged. Any commercial use must be negotiated with the Office
+ *   of Technology Transfer at the California Institute of Technology.
+ */
+
+#ifndef SVC_PASSIVERATEGROUP_IMPL_HPP
+#define SVC_PASSIVERATEGROUP_IMPL_HPP
+
+#include <Svc/PassiveRateGroup/PassiveRateGroupComponentAc.hpp>
+
+namespace Svc {
+
+//! \class PassiveRateGroupImpl
+//! \brief Executes a set of components as part of a rate group
+//!
+//! PassiveRateGroup takes an input cycle call to begin the rate group cycle.
+//! It calls each output port in succession and passes the value in the context
+//! array at the index corresponding to the output port number. It keeps track of the execution
+//! time of the rate group and detects overruns.
+//!
+
+class PassiveRateGroup : public PassiveRateGroupComponentBase {
+  public:
+    //!  \brief PassiveRateGroupImpl constructor
+    //!
+    //!  The constructor of the class clears all the flags and copies the
+    //!  contents of the context array to private storage.
+    //!
+    //!  \param compName Name of the component
+    PassiveRateGroup(const char* compName);  //!  \brief PassiveRateGroupImpl initialization function
+
+    //!  \brief PassiveRateGroup configuration function
+    //!
+    //!  The configuration function takes an array of context values to pass to
+    //!  members of the rate group.
+    //!
+    //!  \param contexts Array of integers that contain the context values that will be sent
+    //!         to each member component. The index of the array corresponds to the
+    //!         output port number.
+    //!  \param numContexts The number of elements in the context array.
+
+    void configure(NATIVE_INT_TYPE contexts[], NATIVE_INT_TYPE numContexts);
+
+    //!  \brief PassiveRateGroupImpl destructor
+    //!
+    //!  The destructor of the class is empty
+
+    ~PassiveRateGroup(void);
+
+  PRIVATE:
+    //!  \brief Input cycle port handler
+    //!
+    //!  The cycle port handler calls each component in the rate group in turn,
+    //!  passing the context value. It computes the execution time each cycle,
+    //!  and writes it to a telemetry value if it reaches a maximum time
+    //!
+    //!  \param portNum incoming port call. For this class, should always be zero
+    //!  \param cycleStart value stored by the cycle driver, used to compute execution time.
+    void CycleIn_handler(NATIVE_INT_TYPE portNum, Svc::TimerVal& cycleStart);
+
+    U32 m_cycles;                                                      //!< cycles executed
+    U32 m_maxTime;                                                     //!< maximum execution time in microseconds
+    U32 m_numContexts;                                                 //!< number of contexts
+    NATIVE_UINT_TYPE m_contexts[NUM_RATEGROUPMEMBEROUT_OUTPUT_PORTS];  //!< Must match number of output ports
+};
+
+}  // namespace Svc
+
+#endif

Svc/PassiveRateGroup/docs/PassiveRateGroup.md

@@ -0,0 +1,5 @@
+<title>PassiveRateGroup Component Dictionary</title>
+# PassiveRateGroup Component Dictionary
+
+
+

Svc/PassiveRateGroup/docs/sdd.md

@@ -0,0 +1,82 @@
+<title>PassiveRateGroup Component SDD</title>
+# RateGroupDriver Component
+
+## 1. Introduction
+
+`Svc::PassiveRateGroup` is an passive component that drives a set of components connected to `Svc::Sched` output ports. It contains an synchronous input `Svc::Cycle` port that drives all the operations.  The component invokes each output port in order, passing an argument indicating the order. It tracks execution time of the cycle.
+
+## 2. Requirements
+
+The requirements for `Svc::PassiveRateGroup` are as follows:
+
+Requirement | Description | Verification Method
+----------- | ----------- | -------------------
+ISF-PRG-001 | The `Svc::PassiveRateGroup` component shall be passive and will be driven by an input synchronous port call | Inspection, Unit test
+ISF-PRG-002 | The `Svc::PassiveRateGroup` component shall invoke its output ports in order, passing the value contained in a table based on port number | Unit Test
+ISF-PRG-003 | The `Svc::PassiveRateGroup` component shall track the time required to execute the rate group and report it as telemetry | Unit Test
+
+
+## 3. Design
+
+### 3.1 Context
+
+#### 3.1.1 Component Diagram
+
+The `Svc::PassiveRateGroup` component has the following component diagram:
+
+![PassiveRateGroup Diagram](img/PassiveRateGroupBDD.png "PassiveRateGroup")
+
+#### 3.1.2 Ports
+
+The `Svc::PassiveRateGroup` component uses the following port types:
+
+Port Data Type | Name | Direction | Kind | Usage
+-------------- | ---- | --------- | ---- | -----
+[`Svc::Cycle`](../../Cycle/docs/sdd.html) | CycleIn | Input | synchronous | Receive a call to run one cycle of the rate group
+[`Svc::Sched`](../../Sched/docs/sdd.html) | RateGroupMemberOut | Output | n/a | Rate group ports
+
+#### 3.2 Functional Description
+
+The `Svc::PassiveRateGroup` component has one input port that is used to drive all of the processing.  The component calls the output ports in order, passing the context from the context list as the port argument.   
+
+### 3.3 Scenarios
+
+#### 3.3.1 Rate Group Port Call
+
+As described in the Functional Description section, the `Svc::PassiveRateGroup` component accepts calls to the CycleIn and invokes the RateGroupMemberOut ports:
+
+![System Tick Port Call](img/RateGroupCall.jpg) 
+
+### 3.4 State
+
+`Svc::PassiveRateGroup` has no state machines.
+
+### 3.5 Algorithms
+
+`Svc::PassiveRateGroup` has no significant algorithms.
+
+## 4. Module Checklists
+
+Document | Link
+-------- | ----
+Design Checklist | [Link](Checklist_Design.xlsx)
+Code Checklist | [Link](Checklist_Code.xlsx)
+Unit Test Checklist | [Link](Checklist_Unit_Test.xlsx)
+
+## 5. Unit Testing
+
+The unit test results are as follows:
+
+Log|Link
+---|----
+Test Output|[Link](../test/ut/output/test_out.txt)
+Coverage Output|[Link](../test/ut/output/SvcPassiveRateGroup_gcov.txt)
+
+## 6. Change Log
+
+Date | Description
+---- | -----------
+2/9/2017 | First Draft
+
+
+

Svc/PassiveRateGroup/test/mod.mk

@@ -0,0 +1,35 @@
+#
+#   Copyright 2004-2008, by the California Institute of Technology.
+#   ALL RIGHTS RESERVED. United States Government Sponsorship
+#   acknowledged. Any commercial use must be negotiated with the Office
+#   of Technology Transfer at the California Institute of Technology.
+#
+#   Information included herein is controlled under the International
+#   Traffic in Arms Regulations ("ITAR") by the U.S. Department of State.
+#   Export or transfer of this information to a Foreign Person or foreign
+#   entity requires an export license issued by the U.S. State Department
+#   or an ITAR exemption prior to the export or transfer.
+#
+
+# This is a template for the mod.mk file that goes in each module
+# and each module's subdirectories.
+# With a fresh checkout, "make gen_make" should be invoked. It should also be
+# run if any of the variables are updated. Any unused variables can 
+# be deleted from the file.
+
+# There are some standard files that are included for reference
+
+TEST_SRC = 	TesterBase.cpp GTestBase.cpp PassiveRateGroupTester.cpp PassiveRateGroupImplTester.cpp
+
+TEST_MODS = Svc/PassiveRateGroup \
+			Svc/Cycle \
+			Svc/Sched \
+			Fw/Log \
+			Fw/Tlm \
+			Fw/Port \
+			Fw/Comp \
+			Fw/Obj \
+			Fw/Time \
+			Fw/Types \
+			Os \
+			gtest