#pragma once #include "dbus_types.hpp" #include "dbus_watcher.hpp" #include #include #include #include #include namespace openpower { namespace pels { /** * @class DataInterface * * A base class for gathering data about the system for use * in PELs. Implemented this way to facilitate mocking. */ class DataInterfaceBase { public: DataInterfaceBase() = default; virtual ~DataInterfaceBase() = default; DataInterfaceBase(const DataInterfaceBase&) = default; DataInterfaceBase& operator=(const DataInterfaceBase&) = default; DataInterfaceBase(DataInterfaceBase&&) = default; DataInterfaceBase& operator=(DataInterfaceBase&&) = default; /** * @brief Returns the machine Type/Model * * @return string - The machine Type/Model string */ virtual std::string getMachineTypeModel() const = 0; /** * @brief Returns the machine serial number * * @return string - The machine serial number */ virtual std::string getMachineSerialNumber() const = 0; /** * @brief Says if the system is managed by a hardware * management console. * @return bool - If the system is HMC managed */ virtual bool isHMCManaged() const { return _hmcManaged; } /** * @brief Says if the host is up and running * * @return bool - If the host is running */ virtual bool isHostUp() const { return _hostUp; } using HostStateChangeFunc = std::function; /** * @brief Register a callback function that will get * called on all host on/off transitions. * * The void(bool) function will get passed the new * value of the host state. * * @param[in] name - The subscription name * @param[in] func - The function to run */ void subscribeToHostStateChange(const std::string& name, HostStateChangeFunc func) { _hostChangeCallbacks[name] = func; } /** * @brief Unsubscribe from host state changes. * * @param[in] name - The subscription name */ void unsubscribeFromHostStateChange(const std::string& name) { _hostChangeCallbacks.erase(name); } /** * @brief Returns the BMC firmware version * * @return std::string - The BMC version */ virtual std::string getBMCFWVersion() const { return _bmcFWVersion; } /** * @brief Returns the server firmware version * * @return std::string - The server firmware version */ virtual std::string getServerFWVersion() const { return _serverFWVersion; } /** * @brief Returns the BMC FW version ID * * @return std::string - The BMC FW version ID */ virtual std::string getBMCFWVersionID() const { return _bmcFWVersionID; } /** * @brief Returns the process name given its PID. * * @param[in] pid - The PID value as a string * * @return std::optional - The name, or std::nullopt */ std::optional getProcessName(const std::string& pid) const { namespace fs = std::filesystem; fs::path path{"/proc"}; path /= fs::path{pid} / "exe"; if (fs::exists(path)) { return fs::read_symlink(path); } return std::nullopt; } /** * @brief Returns the time the system was running. * * @return std::optional - The System uptime or std::nullopt */ std::optional getUptimeInSeconds() const { std::ifstream versionFile{"/proc/uptime"}; std::string line{}; std::getline(versionFile, line); auto pos = line.find(" "); if (pos == std::string::npos) { return std::nullopt; } uint64_t seconds = atol(line.substr(0, pos).c_str()); if (seconds == 0) { return std::nullopt; } return seconds; } /** * @brief Returns the time the system was running. * * @param[in] seconds - The number of seconds the system has been running * * @return std::string - days/hours/minutes/seconds */ std::string getBMCUptime(uint64_t seconds) const { time_t t(seconds); tm* p = gmtime(&t); std::string uptime = std::to_string(p->tm_year - 70) + "y " + std::to_string(p->tm_yday) + "d " + std::to_string(p->tm_hour) + "h " + std::to_string(p->tm_min) + "m " + std::to_string(p->tm_sec) + "s"; return uptime; } /** * @brief Returns the system load average over the past 1 minute, 5 minutes * and 15 minutes. * * @return std::string - The system load average */ std::string getBMCLoadAvg() const { std::string loadavg{}; std::ifstream loadavgFile{"/proc/loadavg"}; std::string line; std::getline(loadavgFile, line); size_t count = 3; for (size_t i = 0; i < count; i++) { auto pos = line.find(" "); if (pos == std::string::npos) { return {}; } if (i != count - 1) { loadavg.append(line.substr(0, pos + 1)); } else { loadavg.append(line.substr(0, pos)); } line = line.substr(pos + 1); } return loadavg; } /** * @brief Returns the 'send event logs to host' setting. * * @return bool - If sending PELs to the host is enabled. */ virtual bool getHostPELEnablement() const { return _sendPELsToHost; } /** * @brief Returns the BMC state * * @return std::string - The BMC state property value */ virtual std::string getBMCState() const { return _bmcState; } /** * @brief Returns the Chassis state * * @return std::string - The chassis state property value */ virtual std::string getChassisState() const { return _chassisState; } /** * @brief Returns the chassis requested power * transition value. * * @return std::string - The chassis transition property */ virtual std::string getChassisTransition() const { return _chassisTransition; } /** * @brief Returns the Host state * * @return std::string - The Host state property value */ virtual std::string getHostState() const { return _hostState; } /** * @brief Returns the Boot state * * @return std::string - The Boot state property value */ virtual std::string getBootState() const { return _bootState; } /** * @brief Returns the motherboard CCIN * * @return std::string The motherboard CCIN */ virtual std::string getMotherboardCCIN() const = 0; /** * @brief Returns the system IM * * @return std::string The system IM */ virtual std::vector getSystemIMKeyword() const = 0; /** * @brief Get the fields from the inventory necessary for doing * a callout on an inventory path. * * @param[in] inventoryPath - The item to get the data for * @param[out] fruPartNumber - Filled in with the VINI/FN keyword * @param[out] ccin - Filled in with the VINI/CC keyword * @param[out] serialNumber - Filled in with the VINI/SN keyword */ virtual void getHWCalloutFields(const std::string& inventoryPath, std::string& fruPartNumber, std::string& ccin, std::string& serialNumber) const = 0; /** * @brief Get the location code for an inventory item. * * @param[in] inventoryPath - The item to get the data for * * @return std::string - The location code */ virtual std::string getLocationCode(const std::string& inventoryPath) const = 0; /** * @brief Get the list of system type names the system is called. * * @return std::vector - The list of names */ virtual std::vector getSystemNames() const = 0; /** * @brief Fills in the placeholder 'Ufcs' in the passed in location * code with the machine feature code and serial number, which * is needed to create a valid location code. * * @param[in] locationCode - Location code value starting with Ufcs-, and * if that isn't present it will be added first. * * @param[in] node - The node number the location is on. * * @return std::string - The expanded location code */ virtual std::string expandLocationCode(const std::string& locationCode, uint16_t node) const = 0; /** * @brief Returns the inventory path for the FRU that the location * code represents. * * @param[in] locationCode - If an expanded location code, then the * full location code. * If not expanded, a location code value * starting with Ufcs-, and if that isn't * present it will be added first. * * @param[in] node - The node number the location is on. Ignored if the * expanded location code is passed in. * * @param[in] expanded - If the location code already has the relevent * VPD fields embedded in it. * * @return std::string - The inventory D-Bus object */ virtual std::string getInventoryFromLocCode(const std::string& LocationCode, uint16_t node, bool expanded) const = 0; /** * @brief Sets the Asserted property on the LED group passed in. * * @param[in] ledGroup - The LED group D-Bus path * @param[in] value - The value to set it to */ virtual void assertLEDGroup(const std::string& ledGroup, bool value) const = 0; /** * @brief Sets the Functional property on the OperationalStatus * interface on a D-Bus object. * * @param[in] objectPath - The D-Bus object path * @param[in] functional - The value */ virtual void setFunctional(const std::string& objectPath, bool functional) const = 0; /** * @brief Sets the critical association on the D-Bus object. * * @param[in] objectPath - The D-Bus object path */ virtual void setCriticalAssociation(const std::string& objectPath) const = 0; /** * @brief Returns the manufacturing QuiesceOnError property * * @return bool - Manufacturing QuiesceOnError property */ virtual bool getQuiesceOnError() const = 0; /** * @brief Split location code into base and connector segments * * A location code that ends in '-Tx', where 'x' is a number, * represents a connector, such as a USB cable connector. * * This function splits the passed in location code into a * base and connector segment. e.g.: * P0-T1 -> ['P0', '-T1'] * P0 -> ['P0', ''] * * @param[in] locationCode - location code to split * @return pair - The base and connector segments */ static std::pair extractConnectorFromLocCode(const std::string& locationCode); /** * @brief Returns the dump status * * @return bool dump status */ virtual std::vector checkDumpStatus(const std::vector& type) const = 0; /** * @brief Create guard record * * @param[in] binPath: phal devtree binary path used as key * @param[in] type: Guard type * @param[in] logPath: error log entry object path */ virtual void createGuardRecord(const std::vector& binPath, const std::string& type, const std::string& logPath) const = 0; /** * @brief Create Progress SRC property on the boot progress * interface on a D-Bus object. * * @param[in] priSRC - Primary SRC value (e.g. BD8D1001) * @param[in] srcStruct - Full SRC base structure */ virtual void createProgressSRC(const uint64_t& priSRC, const std::vector& srcStruct) const = 0; /** * @brief Get the list of unresolved OpenBMC event log ids that have an * associated hardware isolation entry. * * @return std::vector - The list of log ids */ virtual std::vector getLogIDWithHwIsolation() const = 0; /** * @brief Returns the latest raw progress SRC from the State.Boot.Raw * D-Bus interface. * * @return std::vector - The progress SRC bytes */ virtual std::vector getRawProgressSRC() const = 0; protected: /** * @brief Sets the host on/off state and runs any * callback functions (if there was a change). */ void setHostUp(bool hostUp) { if (_hostUp != hostUp) { _hostUp = hostUp; for (auto& [name, func] : _hostChangeCallbacks) { try { func(_hostUp); } catch (const std::exception& e) { using namespace phosphor::logging; log("A host state change callback threw " "an exception"); } } } } /** * @brief The hardware management console status. Always kept * up to date. */ bool _hmcManaged = false; /** * @brief The host up status. Always kept up to date. */ bool _hostUp = false; /** * @brief The map of host state change subscriber * names to callback functions. */ std::map _hostChangeCallbacks; /** * @brief The BMC firmware version string */ std::string _bmcFWVersion; /** * @brief The server firmware version string */ std::string _serverFWVersion; /** * @brief The BMC firmware version ID string */ std::string _bmcFWVersionID; /** * @brief If sending PELs is enabled. * * This is usually set to false in manufacturing test. */ bool _sendPELsToHost = true; /** * @brief The BMC state property */ std::string _bmcState; /** * @brief The Chassis current power state property */ std::string _chassisState; /** * @brief The Chassis requested power transition property */ std::string _chassisTransition; /** * @brief The host state property */ std::string _hostState; /** * @brief The boot state property */ std::string _bootState; }; /** * @class DataInterface * * Concrete implementation of DataInterfaceBase. */ class DataInterface : public DataInterfaceBase { public: DataInterface() = delete; ~DataInterface() = default; DataInterface(const DataInterface&) = default; DataInterface& operator=(const DataInterface&) = default; DataInterface(DataInterface&&) = default; DataInterface& operator=(DataInterface&&) = default; /** * @brief Constructor * * @param[in] bus - The sdbusplus bus object */ explicit DataInterface(sdbusplus::bus_t& bus); /** * @brief Finds the D-Bus service name that hosts the * passed in path and interface. * * @param[in] objectPath - The D-Bus object path * @param[in] interface - The D-Bus interface */ DBusService getService(const std::string& objectPath, const std::string& interface) const; /** * @brief Wrapper for the 'GetAll' properties method call * * @param[in] service - The D-Bus service to call it on * @param[in] objectPath - The D-Bus object path * @param[in] interface - The interface to get the props on * * @return DBusPropertyMap - The property results */ DBusPropertyMap getAllProperties(const std::string& service, const std::string& objectPath, const std::string& interface) const; /** * @brief Wrapper for the 'Get' properties method call * * @param[in] service - The D-Bus service to call it on * @param[in] objectPath - The D-Bus object path * @param[in] interface - The interface to get the property on * @param[in] property - The property name * @param[out] value - Filled in with the property value. */ void getProperty(const std::string& service, const std::string& objectPath, const std::string& interface, const std::string& property, DBusValue& value) const; /** * @brief Returns the machine Type/Model * * @return string - The machine Type/Model string */ std::string getMachineTypeModel() const override; /** * @brief Returns the machine serial number * * @return string - The machine serial number */ std::string getMachineSerialNumber() const override; /** * @brief Returns the motherboard CCIN * * @return std::string The motherboard CCIN */ std::string getMotherboardCCIN() const override; /** * @brief Returns the system IM * * @return std::vector The system IM keyword in 4 byte vector */ std::vector getSystemIMKeyword() const override; /** * @brief Get the fields from the inventory necessary for doing * a callout on an inventory path. * * @param[in] inventoryPath - The item to get the data for * @param[out] fruPartNumber - Filled in with the VINI/FN keyword * @param[out] ccin - Filled in with the VINI/CC keyword * @param[out] serialNumber - Filled in with the VINI/SN keyword */ void getHWCalloutFields(const std::string& inventoryPath, std::string& fruPartNumber, std::string& ccin, std::string& serialNumber) const override; /** * @brief Get the location code for an inventory item. * * Throws an exception if the inventory item doesn't have the * location code interface. * * @param[in] inventoryPath - The item to get the data for * * @return std::string - The location code */ std::string getLocationCode(const std::string& inventoryPath) const override; /** * @brief Get the list of system type names the system is called. * * @return std::vector - The list of names */ std::vector getSystemNames() const override; /** * @brief Fills in the placeholder 'Ufcs' in the passed in location * code with the machine feature code and serial number, which * is needed to create a valid location code. * * @param[in] locationCode - Location code value starting with Ufcs-, and * if that isn't present it will be added first. * * @param[in] node - The node number the location is one. * * @return std::string - The expanded location code */ std::string expandLocationCode(const std::string& locationCode, uint16_t node) const override; /** * @brief Returns the inventory path for the FRU that the location * code represents. * * @param[in] locationCode - If an expanded location code, then the * full location code. * If not expanded, a location code value * starting with Ufcs-, and if that isn't * present it will be added first. * * @param[in] node - The node number the location is on. Ignored if the * expanded location code is passed in. * * @param[in] expanded - If the location code already has the relevent * VPD fields embedded in it. * * @return std::string - The inventory D-Bus object */ std::string getInventoryFromLocCode(const std::string& locationCode, uint16_t node, bool expanded) const override; /** * @brief Sets the Asserted property on the LED group passed in. * * @param[in] ledGroup - The LED group D-Bus path * @param[in] value - The value to set it to */ void assertLEDGroup(const std::string& ledGroup, bool value) const override; /** * @brief Sets the Functional property on the OperationalStatus * interface on a D-Bus object. * * @param[in] objectPath - The D-Bus object path * @param[in] functional - The value */ void setFunctional(const std::string& objectPath, bool functional) const override; /** * @brief Sets the critical association on the D-Bus object. * * @param[in] objectPath - The D-Bus object path */ void setCriticalAssociation(const std::string& objectPath) const override; /** * @brief Returns the manufacturing QuiesceOnError property * * @return bool - Manufacturing QuiesceOnError property */ bool getQuiesceOnError() const override; /** * @brief Returns the dump status * * @param[in] type - The dump type to check for * * @return bool dump status */ std::vector checkDumpStatus(const std::vector& type) const override; /** * @brief Create guard record * * @param[in] binPath: phal devtree binary path used as key * @param[in] type: Guard type * @param[in] logPath: error log entry object path */ void createGuardRecord(const std::vector& binPath, const std::string& type, const std::string& logPath) const override; /** * @brief Create Progress SRC property on the boot progress * interface on a D-Bus object. * * @param[in] priSRC - Primary SRC value * @param[in] srcStruct - Full SRC base structure */ void createProgressSRC(const uint64_t& priSRC, const std::vector& srcStruct) const override; /** * @brief Get the list of unresolved OpenBMC event log ids that have an * associated hardware isolation entry. * * @return std::vector - The list of log ids */ std::vector getLogIDWithHwIsolation() const override; /** * @brief Returns the latest raw progress SRC from the State.Boot.Raw * D-Bus interface. * * @return std::vector: The progress SRC bytes */ std::vector getRawProgressSRC() const override; private: /** * @brief Reads the BMC firmware version string and puts it into * _bmcFWVersion. */ void readBMCFWVersion(); /** * @brief Reads the server firmware version string and puts it into * _serverFWVersion. */ void readServerFWVersion(); /** * @brief Reads the BMC firmware version ID and puts it into * _bmcFWVersionID. */ void readBMCFWVersionID(); /** * @brief Finds all D-Bus paths that contain any of the interfaces * passed in, by using GetSubTreePaths. * * @param[in] interfaces - The desired interfaces * * @return The D-Bus paths. */ DBusPathList getPaths(const DBusInterfaceList& interfaces) const; /** * @brief The interfacesAdded callback used on the inventory to * find the D-Bus object that has the motherboard interface. * When the motherboard is found, it then adds a PropertyWatcher * for the motherboard CCIN. */ void motherboardIfaceAdded(sdbusplus::message_t& msg); /** * @brief Adds the Ufcs- prefix to the location code passed in * if necessary. * * Needed because the location codes that come back from the * message registry and device callout JSON don't have it. * * @param[in] - The location code without a prefix, like P1-C1 * * @return std::string - The location code with the prefix */ static std::string addLocationCodePrefix(const std::string& locationCode); /** * @brief The D-Bus property or interface watchers that have callbacks * registered that will set members in this class when * they change. */ std::vector> _properties; /** * @brief The sdbusplus bus object for making D-Bus calls. */ sdbusplus::bus_t& _bus; /** * @brief The interfacesAdded match object used to wait for inventory * interfaces to show up, so that the object with the motherboard * interface can be found. After it is found, this object is * deleted. */ std::unique_ptr _inventoryIfacesAddedMatch; }; } // namespace pels } // namespace openpower