phosphor-power-supply/power_supply.hpp - openbmc/phosphor-power - Gitiles

 #pragma once

 #include "pmbus.hpp"
 #include "types.hpp"
 #include "util.hpp"
 #include "utility.hpp"

 #include <gpiod.hpp>
 #include <sdbusplus/bus/match.hpp>

 #include <filesystem>
 #include <stdexcept>

 namespace phosphor::power::psu
 {

 #if IBM_VPD
 // PMBus device driver "file name" to read for CCIN value.
 constexpr auto CCIN = "ccin";
 constexpr auto PART_NUMBER = "part_number";
 constexpr auto FRU_NUMBER = "fru";
 constexpr auto SERIAL_HEADER = "header";
 constexpr auto SERIAL_NUMBER = "serial_number";
 constexpr auto FW_VERSION = "fw_version";

 // The D-Bus property name to update with the CCIN value.
 constexpr auto MODEL_PROP = "Model";
 constexpr auto PN_PROP = "PartNumber";
 constexpr auto SN_PROP = "SerialNumber";
 constexpr auto VERSION_PROP = "Version";

 // ipzVPD Keyword sizes
 static constexpr auto FL_KW_SIZE = 20;
 #endif

 constexpr auto LOG_LIMIT = 3;

 /**
  * @class PowerSupply
  * Represents a PMBus power supply device.
  */
 class PowerSupply
 {
   public:
     PowerSupply() = delete;
     PowerSupply(const PowerSupply&) = delete;
     PowerSupply(PowerSupply&&) = delete;
     PowerSupply& operator=(const PowerSupply&) = delete;
     PowerSupply& operator=(PowerSupply&&) = delete;
     ~PowerSupply() = default;

     /**
      * @param[in] invpath - String for inventory path to use
      * @param[in] i2cbus - The bus number this power supply is on
      * @param[in] i2caddr - The 16-bit I2C address of the power supply
      * @param[in] gpioLineName - The gpio-line-name to read for presence. See
      * https://github.com/openbmc/docs/blob/master/designs/device-tree-gpio-naming.md
      */
     PowerSupply(sdbusplus::bus::bus& bus, const std::string& invpath,
                 std::uint8_t i2cbus, const std::uint16_t i2caddr,
                 const std::string& gpioLineName);

     phosphor::pmbus::PMBusBase& getPMBus()
     {
         return *pmbusIntf;
     }

     GPIOInterface* getPresenceGPIO()
     {
         return presenceGPIO.get();
     }

     /**
      * Power supply specific function to analyze for faults/errors.
      *
      * Various PMBus status bits will be checked for fault conditions.
      * If a certain fault bits are on, the appropriate error will be
      * committed.
      */
     void analyze();

     /**
      * Write PMBus ON_OFF_CONFIG
      *
      * This function will be called to cause the PMBus device driver to send the
      * ON_OFF_CONFIG command. Takes one byte of data.
      *
      * @param[in] data - The ON_OFF_CONFIG data byte mask.
      */
     void onOffConfig(uint8_t data);

     /**
      * Write PMBus CLEAR_FAULTS
      *
      * This function will be called in various situations in order to clear
      * any fault status bits that may have been set, in order to start over
      * with a clean state. Presence changes and power state changes will
      * want to clear any faults logged.
      */
     void clearFaults();

     /**
      * @brief Adds properties to the inventory.
      *
      * Reads the values from the device and writes them to the
      * associated power supply D-Bus inventory object.
      *
      * This needs to be done on startup, and each time the presence
      * state changes.
      *
      * Properties added:
      * - Serial Number
      * - Part Number
      * - CCIN (Customer Card Identification Number) - added as the Model
      * - Firmware version
      */
     void updateInventory();

     /**
      * @brief Accessor function to indicate present status
      */
     bool isPresent() const
     {
         return present;
     }

     /**
      * @brief Returns the last read value from STATUS_WORD.
      */
     uint64_t getStatusWord() const
     {
         return statusWord;
     }

     /**
      * @brief Returns the last read value from STATUS_MFR.
      */
     uint64_t getMFRFault() const
     {
         return statusMFR;
     }

     /**
      * @brief Returns true if a fault was found.
      */
     bool isFaulted() const
     {
         return (faultFound || hasCommFault());
     }

     /**
      * @brief Return whether a fault has been logged for this power supply
      */
     bool isFaultLogged() const
     {
         return faultLogged;
     }

     /**
      * @brief Called when a fault for this power supply has been logged.
      */
     void setFaultLogged()
     {
         faultLogged = true;
     }

     /**
      * @brief Returns true if INPUT fault occurred.
      */
     bool hasInputFault() const
     {
         return inputFault;
     }

     /**
      * @brief Returns true if MFRSPECIFIC occurred.
      */
     bool hasMFRFault() const
     {
         return mfrFault;
     }

     /**
      * @brief Returns true if VIN_UV_FAULT occurred.
      */
     bool hasVINUVFault() const
     {
         return vinUVFault;
     }

     /**
      * @brief Returns the device path
      *
      * This can be used for error call outs.
      * Example: /sys/bus/i2c/devices/3-0068
      */
     const std::string getDevicePath() const
     {
         return pmbusIntf->path();
     }

     /**
      * @brief Returns this power supplies inventory path.
      *
      * This can be used for error call outs.
      * Example:
      * /xyz/openbmc_project/inventory/system/chassis/motherboard/powersupply1
      */
     const std::string& getInventoryPath() const
     {
         return inventoryPath;
     }

     /**
      * @brief Returns the firmware revision version read from the power supply
      */
     const std::string& getFWVersion() const
     {
         return fwVersion;
     }

     /**
      * @brief Returns the model name of the power supply
      */
     const std::string& getModelName() const
     {
         return modelName;
     }

     /** @brief Returns true if the number of failed reads exceeds limit
      * TODO: or CML bit on.
      */
     bool hasCommFault() const
     {
         return readFail >= LOG_LIMIT;
     }

   private:
     /** @brief systemd bus member */
     sdbusplus::bus::bus& bus;

     /** @brief Will be updated to the latest/lastvalue read from STATUS_WORD.*/
     uint64_t statusWord = 0;

     /** @brief Will be updated to the latest/lastvalue read from STATUS_MFR.*/
     uint64_t statusMFR = 0;

     /** @brief True if a fault has already been found and not cleared */
     bool faultFound = false;

     /** @brief True if an error for a fault has already been logged. */
     bool faultLogged = false;

     /** @brief True if bit 5 of STATUS_WORD high byte is on. */
     bool inputFault = false;

     /** @brief True if bit 4 of STATUS_WORD high byte is on. */
     bool mfrFault = false;

     /** @brief True if bit 3 of STATUS_WORD low byte is on. */
     bool vinUVFault = false;

     /** @brief Count of the number of read failures. */
     size_t readFail = 0;

     /**
      * @brief D-Bus path to use for this power supply's inventory status.
      **/
     std::string inventoryPath;

     /**
      * @brief The libgpiod object for monitoring PSU presence
      */
     std::unique_ptr<GPIOInterface> presenceGPIO = nullptr;

     /** @brief True if the power supply is present. */
     bool present = false;

     /** @brief Power supply model name. */
     std::string modelName;

     /** @brief D-Bus match variable used to subscribe to Present property
      * changes.
      **/
     std::unique_ptr<sdbusplus::bus::match_t> presentMatch;

     /** @brief D-Bus match variable used to subscribe for Present property
      * interface added.
      */
     std::unique_ptr<sdbusplus::bus::match_t> presentAddedMatch;

     /**
      * @brief Pointer to the PMBus interface
      *
      * Used to read or write to/from PMBus power supply devices.
      */
     std::unique_ptr<phosphor::pmbus::PMBusBase> pmbusIntf = nullptr;

     /** @brief Stored copy of the firmware version/revision string */
     std::string fwVersion;

     /**
      * @brief The file system path used for binding the device driver.
      */
     const std::filesystem::path bindPath;

     /* @brief The string to pass in for binding the device driver. */
     std::string bindDevice;

     /**
      * @brief Binds or unbinds the power supply device driver
      *
      * Called when a presence change is detected to either bind the device
      * driver for the power supply when it is installed, or unbind the device
      * driver when the power supply is removed.
      *
      * Writes <device> to <path>/bind (or unbind)
      *
      * @param present - when true, will bind the device driver
      *                  when false, will unbind the device driver
      */
     void bindOrUnbindDriver(bool present);

     /**
      *  @brief Updates the presence status by querying D-Bus
      *
      * The D-Bus inventory properties for this power supply will be read to
      * determine if the power supply is present or not and update this
      * object's present member variable to reflect current status.
      **/
     void updatePresence();

     /**
      * @brief Updates the power supply presence by reading the GPIO line.
      */
     void updatePresenceGPIO();

     /**
      * @brief Callback for inventory property changes
      *
      * Process change of Present property for power supply.
      *
      * This is used if we are watching the D-Bus properties instead of reading
      * the GPIO presence line ourselves.
      *
      * @param[in]  msg - Data associated with Present change signal
      **/
     void inventoryChanged(sdbusplus::message::message& msg);

     /**
      * @brief Callback for inventory property added.
      *
      * Process add of the interface with the Present property for power supply.
      *
      * This is used if we are watching the D-Bus properties instead of reading
      * the GPIO presence line ourselves.
      *
      * @param[in]  msg - Data associated with Present add signal
      **/
     void inventoryAdded(sdbusplus::message::message& msg);
 };

 } // namespace phosphor::power::psu
	#pragma once

	#include "pmbus.hpp"
	#include "types.hpp"
	#include "util.hpp"
	#include "utility.hpp"

	#include <gpiod.hpp>
	#include <sdbusplus/bus/match.hpp>

	#include <filesystem>
	#include <stdexcept>

	namespace phosphor::power::psu
	{

	#if IBM_VPD
	// PMBus device driver "file name" to read for CCIN value.
	constexpr auto CCIN = "ccin";
	constexpr auto PART_NUMBER = "part_number";
	constexpr auto FRU_NUMBER = "fru";
	constexpr auto SERIAL_HEADER = "header";
	constexpr auto SERIAL_NUMBER = "serial_number";
	constexpr auto FW_VERSION = "fw_version";

	// The D-Bus property name to update with the CCIN value.
	constexpr auto MODEL_PROP = "Model";
	constexpr auto PN_PROP = "PartNumber";
	constexpr auto SN_PROP = "SerialNumber";
	constexpr auto VERSION_PROP = "Version";

	// ipzVPD Keyword sizes
	static constexpr auto FL_KW_SIZE = 20;
	#endif

	constexpr auto LOG_LIMIT = 3;

	/**
	* @class PowerSupply
	* Represents a PMBus power supply device.
	*/
	class PowerSupply
	{
	public:
	PowerSupply() = delete;
	PowerSupply(const PowerSupply&) = delete;
	PowerSupply(PowerSupply&&) = delete;
	PowerSupply& operator=(const PowerSupply&) = delete;
	PowerSupply& operator=(PowerSupply&&) = delete;
	~PowerSupply() = default;

	/**
	* @param[in] invpath - String for inventory path to use
	* @param[in] i2cbus - The bus number this power supply is on
	* @param[in] i2caddr - The 16-bit I2C address of the power supply
	* @param[in] gpioLineName - The gpio-line-name to read for presence. See
	* https://github.com/openbmc/docs/blob/master/designs/device-tree-gpio-naming.md
	*/
	PowerSupply(sdbusplus::bus::bus& bus, const std::string& invpath,
	std::uint8_t i2cbus, const std::uint16_t i2caddr,
	const std::string& gpioLineName);

	phosphor::pmbus::PMBusBase& getPMBus()
	{
	return *pmbusIntf;
	}

	GPIOInterface* getPresenceGPIO()
	{
	return presenceGPIO.get();
	}

	/**
	* Power supply specific function to analyze for faults/errors.
	*
	* Various PMBus status bits will be checked for fault conditions.
	* If a certain fault bits are on, the appropriate error will be
	* committed.
	*/
	void analyze();

	/**
	* Write PMBus ON_OFF_CONFIG
	*
	* This function will be called to cause the PMBus device driver to send the
	* ON_OFF_CONFIG command. Takes one byte of data.
	*
	* @param[in] data - The ON_OFF_CONFIG data byte mask.
	*/
	void onOffConfig(uint8_t data);

	/**
	* Write PMBus CLEAR_FAULTS
	*
	* This function will be called in various situations in order to clear
	* any fault status bits that may have been set, in order to start over
	* with a clean state. Presence changes and power state changes will
	* want to clear any faults logged.
	*/
	void clearFaults();

	/**
	* @brief Adds properties to the inventory.
	*
	* Reads the values from the device and writes them to the
	* associated power supply D-Bus inventory object.
	*
	* This needs to be done on startup, and each time the presence
	* state changes.
	*
	* Properties added:
	* - Serial Number
	* - Part Number
	* - CCIN (Customer Card Identification Number) - added as the Model
	* - Firmware version
	*/
	void updateInventory();

	/**
	* @brief Accessor function to indicate present status
	*/
	bool isPresent() const
	{
	return present;
	}

	/**
	* @brief Returns the last read value from STATUS_WORD.
	*/
	uint64_t getStatusWord() const
	{
	return statusWord;
	}

	/**
	* @brief Returns the last read value from STATUS_MFR.
	*/
	uint64_t getMFRFault() const
	{
	return statusMFR;
	}

	/**
	* @brief Returns true if a fault was found.
	*/
	bool isFaulted() const
	{
	return (faultFound \|\| hasCommFault());
	}

	/**
	* @brief Return whether a fault has been logged for this power supply
	*/
	bool isFaultLogged() const
	{
	return faultLogged;
	}

	/**
	* @brief Called when a fault for this power supply has been logged.
	*/
	void setFaultLogged()
	{
	faultLogged = true;
	}

	/**
	* @brief Returns true if INPUT fault occurred.
	*/
	bool hasInputFault() const
	{
	return inputFault;
	}

	/**
	* @brief Returns true if MFRSPECIFIC occurred.
	*/
	bool hasMFRFault() const
	{
	return mfrFault;
	}

	/**
	* @brief Returns true if VIN_UV_FAULT occurred.
	*/
	bool hasVINUVFault() const
	{
	return vinUVFault;
	}

	/**
	* @brief Returns the device path
	*
	* This can be used for error call outs.
	* Example: /sys/bus/i2c/devices/3-0068
	*/
	const std::string getDevicePath() const
	{
	return pmbusIntf->path();
	}

	/**
	* @brief Returns this power supplies inventory path.
	*
	* This can be used for error call outs.
	* Example:
	* /xyz/openbmc_project/inventory/system/chassis/motherboard/powersupply1
	*/
	const std::string& getInventoryPath() const
	{
	return inventoryPath;
	}

	/**
	* @brief Returns the firmware revision version read from the power supply
	*/
	const std::string& getFWVersion() const
	{
	return fwVersion;
	}

	/**
	* @brief Returns the model name of the power supply
	*/
	const std::string& getModelName() const
	{
	return modelName;
	}

	/** @brief Returns true if the number of failed reads exceeds limit
	* TODO: or CML bit on.
	*/
	bool hasCommFault() const
	{
	return readFail >= LOG_LIMIT;
	}

	private:
	/** @brief systemd bus member */
	sdbusplus::bus::bus& bus;

	/** @brief Will be updated to the latest/lastvalue read from STATUS_WORD.*/
	uint64_t statusWord = 0;

	/** @brief Will be updated to the latest/lastvalue read from STATUS_MFR.*/
	uint64_t statusMFR = 0;

	/** @brief True if a fault has already been found and not cleared */
	bool faultFound = false;

	/** @brief True if an error for a fault has already been logged. */
	bool faultLogged = false;

	/** @brief True if bit 5 of STATUS_WORD high byte is on. */
	bool inputFault = false;

	/** @brief True if bit 4 of STATUS_WORD high byte is on. */
	bool mfrFault = false;

	/** @brief True if bit 3 of STATUS_WORD low byte is on. */
	bool vinUVFault = false;

	/** @brief Count of the number of read failures. */
	size_t readFail = 0;

	/**
	* @brief D-Bus path to use for this power supply's inventory status.
	**/
	std::string inventoryPath;

	/**
	* @brief The libgpiod object for monitoring PSU presence
	*/
	std::unique_ptr<GPIOInterface> presenceGPIO = nullptr;

	/** @brief True if the power supply is present. */
	bool present = false;

	/** @brief Power supply model name. */
	std::string modelName;

	/** @brief D-Bus match variable used to subscribe to Present property
	* changes.
	**/
	std::unique_ptr<sdbusplus::bus::match_t> presentMatch;

	/** @brief D-Bus match variable used to subscribe for Present property
	* interface added.
	*/
	std::unique_ptr<sdbusplus::bus::match_t> presentAddedMatch;

	/**
	* @brief Pointer to the PMBus interface
	*
	* Used to read or write to/from PMBus power supply devices.
	*/
	std::unique_ptr<phosphor::pmbus::PMBusBase> pmbusIntf = nullptr;

	/** @brief Stored copy of the firmware version/revision string */
	std::string fwVersion;

	/**
	* @brief The file system path used for binding the device driver.
	*/
	const std::filesystem::path bindPath;

	/* @brief The string to pass in for binding the device driver. */
	std::string bindDevice;

	/**
	* @brief Binds or unbinds the power supply device driver
	*
	* Called when a presence change is detected to either bind the device
	* driver for the power supply when it is installed, or unbind the device
	* driver when the power supply is removed.
	*
	* Writes <device> to <path>/bind (or unbind)
	*
	* @param present - when true, will bind the device driver
	* when false, will unbind the device driver
	*/
	void bindOrUnbindDriver(bool present);

	/**
	* @brief Updates the presence status by querying D-Bus
	*
	* The D-Bus inventory properties for this power supply will be read to
	* determine if the power supply is present or not and update this
	* object's present member variable to reflect current status.
	**/
	void updatePresence();

	/**
	* @brief Updates the power supply presence by reading the GPIO line.
	*/
	void updatePresenceGPIO();

	/**
	* @brief Callback for inventory property changes
	*
	* Process change of Present property for power supply.
	*
	* This is used if we are watching the D-Bus properties instead of reading
	* the GPIO presence line ourselves.
	*
	* @param[in] msg - Data associated with Present change signal
	**/
	void inventoryChanged(sdbusplus::message::message& msg);

	/**
	* @brief Callback for inventory property added.
	*
	* Process add of the interface with the Present property for power supply.
	*
	* This is used if we are watching the D-Bus properties instead of reading
	* the GPIO presence line ourselves.
	*
	* @param[in] msg - Data associated with Present add signal
	**/
	void inventoryAdded(sdbusplus::message::message& msg);
	};

	} // namespace phosphor::power::psu