F´ Flight Software - C/C++ Documentation
A framework for building embedded system applications to NASA flight quality standards.
EventManager.cpp
Go to the documentation of this file.
1 /*
2  * TestCommand1Impl.cpp
3  *
4  * Created on: Mar 28, 2014
5  * Author: tcanham
6  */
7 
8 #include <cstdio>
9 
10 #include <Fw/Types/Assert.hpp>
11 #include <Os/File.hpp>
13 
14 namespace Svc {
15 static_assert(std::numeric_limits<FwSizeType>::max() >= TELEM_ID_FILTER_SIZE,
16  "TELEM_ID_FILTER_SIZE must fit within range of FwSizeType");
19 
21  // set filter defaults
22  this->m_filterState[FilterSeverity::WARNING_HI].enabled =
24  this->m_filterState[FilterSeverity::WARNING_LO].enabled =
26  this->m_filterState[FilterSeverity::COMMAND].enabled =
28  this->m_filterState[FilterSeverity::ACTIVITY_HI].enabled =
30  this->m_filterState[FilterSeverity::ACTIVITY_LO].enabled =
32  this->m_filterState[FilterSeverity::DIAGNOSTIC].enabled =
34 
35  memset(m_filteredIDs, 0, sizeof(m_filteredIDs));
36 }
37 
39 
40 void EventManager::LogRecv_handler(FwIndexType portNum,
41  FwEventIdType id,
42  Fw::Time& timeTag,
43  const Fw::LogSeverity& severity,
44  Fw::LogBuffer& args) {
45  // make sure ID is not zero. Zero is reserved for ID filter.
46  FW_ASSERT(id != 0);
47 
48  switch (severity.e) {
49  case Fw::LogSeverity::FATAL: // always pass FATAL
50  break;
52  if (this->m_filterState[FilterSeverity::WARNING_HI].enabled == Enabled::DISABLED) {
53  return;
54  }
55  break;
57  if (this->m_filterState[FilterSeverity::WARNING_LO].enabled == Enabled::DISABLED) {
58  return;
59  }
60  break;
62  if (this->m_filterState[FilterSeverity::COMMAND].enabled == Enabled::DISABLED) {
63  return;
64  }
65  break;
67  if (this->m_filterState[FilterSeverity::ACTIVITY_HI].enabled == Enabled::DISABLED) {
68  return;
69  }
70  break;
72  if (this->m_filterState[FilterSeverity::ACTIVITY_LO].enabled == Enabled::DISABLED) {
73  return;
74  }
75  break;
77  if (this->m_filterState[FilterSeverity::DIAGNOSTIC].enabled == Enabled::DISABLED) {
78  return;
79  }
80  break;
81  default:
82  FW_ASSERT(0, static_cast<FwAssertArgType>(severity.e));
83  return;
84  }
85 
86  // check ID filters
87  for (FwSizeType entry = 0; entry < TELEM_ID_FILTER_SIZE; entry++) {
88  if ((m_filteredIDs[entry] == id) && (severity != Fw::LogSeverity::FATAL)) {
89  return;
90  }
91  }
92 
93  // send event to the logger thread
94  this->loqQueue_internalInterfaceInvoke(id, timeTag, severity, args);
95 
96  // if connected, announce the FATAL
97  if (Fw::LogSeverity::FATAL == severity.e) {
99  this->FatalAnnounce_out(0, id);
100  }
101  }
102 }
103 
104 void EventManager::loqQueue_internalInterfaceHandler(FwEventIdType id,
105  const Fw::Time& timeTag,
106  const Fw::LogSeverity& severity,
107  const Fw::LogBuffer& args) {
108  // Serialize event
109  this->m_logPacket.setId(id);
110  this->m_logPacket.setTimeTag(timeTag);
111  this->m_logPacket.setLogBuffer(args);
112  this->m_comBuffer.resetSer();
113  Fw::SerializeStatus stat = this->m_logPacket.serializeTo(this->m_comBuffer);
114  FW_ASSERT(Fw::FW_SERIALIZE_OK == stat, static_cast<FwAssertArgType>(stat));
115 
116  if (this->isConnected_PktSend_OutputPort(0)) {
117  this->PktSend_out(0, this->m_comBuffer, 0);
118  }
119 }
120 
121 void EventManager::SET_EVENT_FILTER_cmdHandler(FwOpcodeType opCode,
122  U32 cmdSeq,
123  FilterSeverity filterLevel,
124  Enabled filterEnable) {
125  this->m_filterState[filterLevel.e].enabled = filterEnable;
126  this->cmdResponse_out(opCode, cmdSeq, Fw::CmdResponse::OK);
127 }
128 
129 void EventManager::SET_ID_FILTER_cmdHandler(FwOpcodeType opCode,
130  U32 cmdSeq,
131  FwEventIdType ID,
132  Enabled idEnabled
133 ) {
134  if (Enabled::ENABLED == idEnabled.e) { // add ID
135  // search list for existing entry
136  for (FwSizeType entry = 0; entry < TELEM_ID_FILTER_SIZE; entry++) {
137  if (this->m_filteredIDs[entry] == ID) {
138  this->cmdResponse_out(opCode, cmdSeq, Fw::CmdResponse::OK);
140  return;
141  }
142  }
143  // if not already a match, search for an open slot
144  for (FwSizeType entry = 0; entry < TELEM_ID_FILTER_SIZE; entry++) {
145  if (this->m_filteredIDs[entry] == 0) {
146  this->m_filteredIDs[entry] = ID;
147  this->cmdResponse_out(opCode, cmdSeq, Fw::CmdResponse::OK);
149  return;
150  }
151  }
152  // if an empty slot was not found, send an error event
154  this->cmdResponse_out(opCode, cmdSeq, Fw::CmdResponse::EXECUTION_ERROR);
155  } else { // remove ID
156  // search list for existing entry
157  for (FwSizeType entry = 0; entry < TELEM_ID_FILTER_SIZE; entry++) {
158  if (this->m_filteredIDs[entry] == ID) {
159  this->m_filteredIDs[entry] = 0; // zero entry
160  this->cmdResponse_out(opCode, cmdSeq, Fw::CmdResponse::OK);
162  return;
163  }
164  }
165  // if it gets here, wasn't found
167  this->cmdResponse_out(opCode, cmdSeq, Fw::CmdResponse::EXECUTION_ERROR);
168  }
169 }
170 
171 void EventManager::DUMP_FILTER_STATE_cmdHandler(FwOpcodeType opCode,
172  U32 cmdSeq
173 ) {
174  // first, iterate through severity filters
175  for (FwEnumStoreType filter = 0; filter < FilterSeverity::NUM_CONSTANTS; filter++) {
176  FilterSeverity filterState(static_cast<FilterSeverity::t>(filter));
177  this->log_ACTIVITY_LO_SEVERITY_FILTER_STATE(filterState,
178  Enabled::ENABLED == this->m_filterState[filter].enabled.e);
179  }
180 
181  // iterate through ID filter
182  for (FwSizeType entry = 0; entry < TELEM_ID_FILTER_SIZE; entry++) {
183  if (this->m_filteredIDs[entry] != 0) {
184  this->log_ACTIVITY_HI_ID_FILTER_ENABLED(this->m_filteredIDs[entry]);
185  }
186  }
187 
188  this->cmdResponse_out(opCode, cmdSeq, Fw::CmdResponse::OK);
189 }
190 
191 void EventManager::pingIn_handler(const FwIndexType portNum, U32 key) {
192  // return key
193  this->pingOut_out(0, key);
194 }
195 
196 } // namespace Svc
Serialization/Deserialization operation was successful.
SerializeStatus serializeTo(SerializeBufferBase &buffer) const override
serialize contents
Definition: LogPacket.cpp:19
Enabled and disabled state.
FwIdType FwOpcodeType
The type of a command opcode.
PlatformSizeType FwSizeType
WARNING HI events are filtered at input.
void resetSer()
reset to beginning of buffer to reuse for serialization
I32 FwEnumStoreType
void setTimeTag(const Fw::Time &timeTag)
Definition: LogPacket.cpp:75
EventManager(const char *compName)
constructor
void pingOut_out(FwIndexType portNum, U32 key)
Invoke output port pingOut.
ACTIVITY HI events are filtered at input.
void setId(FwEventIdType id)
Definition: LogPacket.cpp:67
void PktSend_out(FwIndexType portNum, Fw::ComBuffer &data, U32 context)
Invoke output port PktSend.
T e
The raw enum value.
Software diagnostic events.
SerializeStatus
forward declaration for string
Size of telemetry ID filter.
FwIdType FwEventIdType
The type of an event identifier.
void log_ACTIVITY_HI_ID_FILTER_ENABLED(FwEventIdType ID) const
EventManager_Enabled Enabled
Less important informational events.
void log_WARNING_LO_ID_FILTER_LIST_FULL(FwEventIdType ID) const
An activity related to commanding.
A less serious but recoverable event.
bool isConnected_FatalAnnounce_OutputPort(FwIndexType portNum)
A serious but recoverable event.
Auto-generated base for EventManager component.
COMMAND events are filtered at input.
Enum representing event severity.
Command successfully executed.
virtual ~EventManager()
destructor
void setLogBuffer(const LogBuffer &buffer)
Definition: LogPacket.cpp:71
void log_WARNING_LO_ID_FILTER_NOT_FOUND(FwEventIdType ID) const
void loqQueue_internalInterfaceInvoke(FwEventIdType id, const Fw::Time &timeTag, const Fw::LogSeverity &severity, const Fw::LogBuffer &args)
Internal interface base-class function for loqQueue.
WARNING LO events are filtered at input.
Command had execution error.
Important informational events.
EventManager_FilterSeverity FilterSeverity
void cmdResponse_out(FwOpcodeType opCode, U32 cmdSeq, Fw::CmdResponse response)
Emit command response.
ACTIVITY LO events are filtered at input.
PlatformIndexType FwIndexType
A fatal non-recoverable event.
RateGroupDivider component implementation.
void log_ACTIVITY_LO_SEVERITY_FILTER_STATE(Svc::EventManager_FilterSeverity severity, bool enabled) const
void FatalAnnounce_out(FwIndexType portNum, FwEventIdType Id)
Invoke output port FatalAnnounce.
bool isConnected_PktSend_OutputPort(FwIndexType portNum)
DIAGNOSTIC events are filtered at input.
#define FW_ASSERT(...)
Definition: Assert.hpp:14
void log_ACTIVITY_HI_ID_FILTER_REMOVED(FwEventIdType ID) const