#pragma once #include "common/instance_id.hpp" #include "common/types.hpp" #include "common/utils.hpp" #include "libpldmresponder/event_parser.hpp" #include "libpldmresponder/oem_handler.hpp" #include "libpldmresponder/pdr_utils.hpp" #include "requester/handler.hpp" #include "utils.hpp" #include #include #include #include #include #include #include #include #include namespace pldm { using EntityType = uint16_t; // vector which would hold the PDR record handle data returned by // pldmPDRRepositoryChgEvent event data using ChangeEntry = uint32_t; using PDRRecordHandles = std::deque; /** @struct SensorEntry * * SensorEntry is a unique key which maps a sensorEventType request in the * PlatformEventMessage command to a host sensor PDR. This struct is a key * in a std::map, so implemented operator==and operator<. */ struct SensorEntry { pdr::TerminusID terminusID; pdr::SensorID sensorID; bool operator==(const SensorEntry& e) const { return ((terminusID == e.terminusID) && (sensorID == e.sensorID)); } bool operator<(const SensorEntry& e) const { return ((terminusID < e.terminusID) || ((terminusID == e.terminusID) && (sensorID < e.sensorID))); } }; using HostStateSensorMap = std::map; using PDRList = std::vector>; /** @class HostPDRHandler * @brief This class can fetch and process PDRs from host firmware * @details Provides an API to fetch PDRs from the host firmware. Upon * receiving the PDRs, they are stored into the BMC's primary PDR repo. * Adjustments are made to entity association PDRs received from the host, * because they need to be assimilated into the BMC's entity association * tree. A PLDM event containing the record handles of the updated entity * association PDRs is sent to the host. */ class HostPDRHandler { public: HostPDRHandler() = delete; HostPDRHandler(const HostPDRHandler&) = delete; HostPDRHandler(HostPDRHandler&&) = delete; HostPDRHandler& operator=(const HostPDRHandler&) = delete; HostPDRHandler& operator=(HostPDRHandler&&) = delete; ~HostPDRHandler() = default; using TerminusInfo = std::tuple; using TLPDRMap = std::map; /** @brief Constructor * @param[in] mctp_fd - fd of MCTP communications socket * @param[in] mctp_eid - MCTP EID of host firmware * @param[in] event - reference of main event loop of pldmd * @param[in] repo - pointer to BMC's primary PDR repo * @param[in] eventsJsonDir - directory path which has the config JSONs * @param[in] entityTree - Pointer to BMC and Host entity association tree * @param[in] bmcEntityTree - pointer to BMC's entity association tree * @param[in] instanceIdDb - reference to an InstanceIdDb object * @param[in] handler - PLDM request handler */ explicit HostPDRHandler( int mctp_fd, uint8_t mctp_eid, sdeventplus::Event& event, pldm_pdr* repo, const std::string& eventsJsonsDir, pldm_entity_association_tree* entityTree, pldm_entity_association_tree* bmcEntityTree, pldm::InstanceIdDb& instanceIdDb, pldm::requester::Handler* handler, pldm::responder::oem_platform::Handler* oemPlatformHandler); /** @brief fetch PDRs from host firmware. See @class. * @param[in] recordHandles - list of record handles pointing to host's * PDRs that need to be fetched. */ void fetchPDR(PDRRecordHandles&& recordHandles); /** @brief Send a PLDM event to host firmware containing a list of record * handles of PDRs that the host firmware has to fetch. * @param[in] pdrTypes - list of PDR types that need to be looked up in the * BMC repo * @param[in] eventDataFormat - format for PDRRepositoryChgEvent in DSP0248 */ void sendPDRRepositoryChgEvent(std::vector&& pdrTypes, uint8_t eventDataFormat); /** @brief Lookup host sensor info corresponding to requested SensorEntry * * @param[in] entry - TerminusID and SensorID * * @return SensorInfo corresponding to the input paramter SensorEntry * throw std::out_of_range exception if not found */ const pdr::SensorInfo& lookupSensorInfo(const SensorEntry& entry) const { return sensorMap.at(entry); } /** @brief Handles state sensor event * * @param[in] entry - state sensor entry * @param[in] state - event state * * @return PLDM completion code */ int handleStateSensorEvent( const pldm::responder::events::StateSensorEntry& entry, pdr::EventState state); /** @brief Parse state sensor PDRs and populate the sensorMap lookup data * structure * * @param[in] stateSensorPDRs - host state sensor PDRs * */ void parseStateSensorPDRs(const PDRList& stateSensorPDRs); /** @brief this function sends a GetPDR request to Host firmware. * And processes the PDRs based on type * * @param[in] - nextRecordHandle - the next record handle to ask for */ void getHostPDR(uint32_t nextRecordHandle = 0); /** @brief set the Host firmware condition when pldmd starts */ void setHostFirmwareCondition(); /** @brief set HostSensorStates when pldmd starts or restarts * and updates the D-Bus property * @param[in] stateSensorPDRs - host state sensor PDRs */ void setHostSensorState(const PDRList& stateSensorPDRs); /** @brief whether we received PLDM_RECORDS_MODIFIED event data operation * from host */ bool isHostPdrModified = false; /** @brief check whether Host is running when pldmd starts */ bool isHostUp(); /** @brief map that captures various terminus information **/ TLPDRMap tlPDRInfo; private: /** @brief deferred function to fetch PDR from Host, scheduled to work on * the event loop. The PDR exchg with the host is async. * @param[in] source - sdeventplus event source */ void _fetchPDR(sdeventplus::source::EventBase& source); /** @brief Merge host firmware's entity association PDRs into BMC's * @details A merge operation involves adding a pldm_entity under the * appropriate parent, and updating container ids. * @param[in] pdr - entity association pdr * @param[in] size - size of input PDR record in bytes * @param[in] record_handle - record handle of the PDR */ void mergeEntityAssociations(const std::vector& pdr, [[maybe_unused]] const uint32_t& size, [[maybe_unused]] const uint32_t& record_handle); /** @brief process the Host's PDR and add to BMC's PDR repo * @param[in] eid - MCTP id of Host * @param[in] response - response from Host for GetPDR * @param[in] respMsgLen - response message length */ void processHostPDRs(mctp_eid_t eid, const pldm_msg* response, size_t respMsgLen); /** @brief send PDR Repo change after merging Host's PDR to BMC PDR repo * @param[in] source - sdeventplus event source */ void _processPDRRepoChgEvent(sdeventplus::source::EventBase& source); /** @brief fetch the next PDR based on the record handle sent by Host * @param[in] nextRecordHandle - next record handle * @param[in] source - sdeventplus event source */ void _processFetchPDREvent(uint32_t nextRecordHandle, sdeventplus::source::EventBase& source); /** @brief Get FRU record table metadata by remote PLDM terminus * * @param[out] uint16_t - total table records */ void getFRURecordTableMetadataByRemote(const PDRList& fruRecordSetPDRs); /** @brief Set Location Code in the dbus objects * * @param[in] fruRecordSetPDRs - the Fru Record set PDR's * @param[in] fruRecordData - the Fru Record Data */ void setFRUDataOnDBus( const PDRList& fruRecordSetPDRs, const std::vector& fruRecordData); /** @brief Get FRU record table by remote PLDM terminus * * @param[in] fruRecordSetPDRs - the Fru Record set PDR's * @param[in] totalTableRecords - the Number of total table records * @return */ void getFRURecordTableByRemote(const PDRList& fruRecordSetPDRs, uint16_t totalTableRecords); /** @brief Create Dbus objects by remote PLDM entity Fru PDRs * * @param[in] fruRecordSetPDRs - fru record set pdr * * @ return */ void createDbusObjects(const PDRList& fruRecordSetPDRs); /** @brief Get FRU Record Set Identifier from FRU Record data Format * @param[in] fruRecordSetPDRs - fru record set pdr * @param[in] entity - PLDM entity information * @return */ std::optional getRSI(const PDRList& fruRecordSetPDRs, const pldm_entity& entity); /** @brief fd of MCTP communications socket */ int mctp_fd; /** @brief MCTP EID of host firmware */ uint8_t mctp_eid; /** @brief reference of main event loop of pldmd, primarily used to schedule * work. */ sdeventplus::Event& event; /** @brief pointer to BMC's primary PDR repo, host PDRs are added here */ pldm_pdr* repo; pldm::responder::events::StateSensorHandler stateSensorHandler; /** @brief Pointer to BMC's and Host's entity association tree */ pldm_entity_association_tree* entityTree; /** @brief Pointer to BMC's entity association tree */ pldm_entity_association_tree* bmcEntityTree; /** @brief reference to Instance ID database object, used to obtain PLDM * instance IDs */ pldm::InstanceIdDb& instanceIdDb; /** @brief PLDM request handler */ pldm::requester::Handler* handler; /** @brief sdeventplus event source */ std::unique_ptr pdrFetchEvent; std::unique_ptr deferredFetchPDREvent; std::unique_ptr deferredPDRRepoChgEvent; /** @brief list of PDR record handles pointing to host's PDRs */ PDRRecordHandles pdrRecordHandles; /** @brief maps an entity type to parent pldm_entity from the BMC's entity * association tree */ /** @brief list of PDR record handles modified pointing to host PDRs */ PDRRecordHandles modifiedPDRRecordHandles; /** @brief D-Bus property changed signal match */ std::unique_ptr hostOffMatch; /** @brief sensorMap is a lookup data structure that is build from the * hostPDR that speeds up the lookup of in * PlatformEventMessage command request. */ HostStateSensorMap sensorMap; /** @brief whether response received from Host */ bool responseReceived; /** @brief variable that captures if the first entity association PDR * from host is merged into the BMC tree */ bool mergedHostParents; /** @brief maps an object path to pldm_entity from the BMC's entity * association tree */ ObjectPathMaps objPathMap; /** @brief maps an entity name to map, maps to entity name to pldm_entity */ EntityAssociations entityAssociations; /** @brief the vector of FRU Record Data Format */ std::vector fruRecordData; /** @OEM platform handler */ pldm::responder::oem_platform::Handler* oemPlatformHandler; /** @brief entityID and entity name is only loaded once */ EntityMaps entityMaps; }; } // namespace pldm