#ifndef FRAMEWORK_HK_HOUSEKEEPINGHELPER_H_ #define FRAMEWORK_HK_HOUSEKEEPINGHELPER_H_ #include #include #include #include #include #include #include #include #include #include class HousekeepingManager { template friend class LocalPoolVar; template friend class LocalPoolVector; friend class LocalDataSet; public: static constexpr float MINIMAL_SAMPLING_FREQUENCY = 0.2; HousekeepingManager(HasHkPoolParametersIF* owner); virtual~ HousekeepingManager(); // propably will just call respective local data set functions. void generateHousekeepingPacket(sid_t sid); ReturnValue_t handleHousekeepingMessage(CommandMessage* message); /** * This function is used to fill the local data pool map with pool * entries. It should only be called once by the pool owner. * @param localDataPoolMap * @return */ ReturnValue_t initializeHousekeepingPoolEntriesOnce(); void setHkPacketQueue(MessageQueueIF* msgQueue); const HasHkPoolParametersIF* getOwner() const; ReturnValue_t printPoolEntry(lp_id_t localPoolId); private: //! This is the map holding the actual data. Should only be initialized //! once ! bool mapInitialized = false; LocalDataPoolMap localDpMap; //! Every housekeeping data manager has a mutex to protect access //! to it's data pool. MutexIF * mutex = nullptr; //! The class which actually owns the manager (and its datapool). HasHkPoolParametersIF* owner = nullptr; //! Used for replies. //! (maybe we dont need this, the sender can be retrieved from command //! message..) MessageQueueIF* hkReplyQueue = nullptr; //! Used for HK packets, which are generated without requests. //! Maybe this will just be the TM funnel. MessageQueueIF* hkPacketQueue = nullptr; /** * Get the pointer to the mutex. Can be used to lock the data pool * eternally. Use with care and don't forget to unlock locked mutexes! * For now, only friend classes can accss this function. * @return */ MutexIF* getMutexHandle(); /** * Read a variable by supplying its local pool ID and assign the pool * entry to the supplied PoolEntry pointer. The type of the pool entry * is deduced automatically. This call is not thread-safe! * For now, only friend classes like LocalPoolVar may access this * function. * @tparam T Type of the pool entry * @param localPoolId Pool ID of the variable to read * @param poolVar [out] Corresponding pool entry will be assigned to the * supplied pointer. * @return */ template ReturnValue_t fetchPoolEntry(lp_id_t localPoolId, PoolEntry **poolEntry); void setMinimalSamplingFrequency(float frequencySeconds); }; template inline ReturnValue_t HousekeepingManager::fetchPoolEntry(lp_id_t localPoolId, PoolEntry **poolEntry) { auto poolIter = localDpMap.find(localPoolId); if (poolIter == localDpMap.end()) { sif::debug << "HousekeepingManager::fechPoolEntry:" " Pool entry not found." << std::endl; return HasHkPoolParametersIF::POOL_ENTRY_NOT_FOUND; } *poolEntry = dynamic_cast< PoolEntry* >(poolIter->second); if(*poolEntry == nullptr) { sif::debug << "HousekeepingManager::fetchPoolEntry:" " Pool entry not found." << std::endl; return HasHkPoolParametersIF::POOL_ENTRY_TYPE_CONFLICT; } return HasReturnvaluesIF::RETURN_OK; } #endif /* FRAMEWORK_HK_HOUSEKEEPINGHELPER_H_ */