#pragma once #include "data_interface.hpp" #include "elog_entry.hpp" #include "pel_values.hpp" #include "registry.hpp" #include "section.hpp" #include "stream.hpp" namespace openpower { namespace pels { static constexpr uint8_t userHeaderVersion = 0x01; static constexpr uint16_t actionFlagsDefault = 0xFFFF; /** * @class UserHeader * * This represents the User Header section in a PEL. It is required, * and it is always the second section. * * The Section base class handles the section header structure that every * PEL section has at offset zero. * * The fields in this class directly correspond to the order and sizes of * the fields in the section. */ class UserHeader : public Section { public: UserHeader() = delete; ~UserHeader() = default; UserHeader(const UserHeader&) = default; UserHeader& operator=(const UserHeader&) = default; UserHeader(UserHeader&&) = default; UserHeader& operator=(UserHeader&&) = default; /** * @brief Constructor * * Creates a valid UserHeader with the passed in data. * * @param[in] entry - The message registry entry for this error * @param[in] severity - The OpenBMC event log severity for this error * @param[in] additionalData - The AdditionalData properties in this * error log * @param[in] dataIface - The DataInterface object */ UserHeader(const message::Entry& entry, phosphor::logging::Entry::Level severity, const AdditionalData& additionalData, const DataInterfaceBase& dataIface); /** * @brief Constructor * * Fills in this class's data fields from the stream. * * @param[in] pel - the PEL data stream */ explicit UserHeader(Stream& pel); /** * @brief Flatten the section into the stream * * @param[in] stream - The stream to write to */ void flatten(Stream& stream) const override; /** * @brief Returns the subsystem field. * * @return uint8_t - the subsystem */ uint8_t subsystem() const { return _eventSubsystem; } /** * @brief Returns the event scope field. * * @return uint8_t - the event scope */ uint8_t scope() const { return _eventScope; } /** * @brief Returns the severity field. * * @return uint8_t - the severity */ uint8_t severity() const { return _eventSeverity; } /** * @brief Returns the event type field. * * @return uint8_t - the event type */ uint8_t eventType() const { return _eventType; } /** * @brief Set the event type field * * @param[in] type - the new event type */ void setEventType(uint8_t type) { _eventType = type; } /** * @brief Returns the problem domain field. * * @return uint8_t - the problem domain */ uint8_t problemDomain() const { return _problemDomain; } /** * @brief Returns the problem vector field. * * @return uint8_t - the problem vector */ uint8_t problemVector() const { return _problemVector; } /** * @brief Returns the action flags field. * * @return uint16_t - the action flags */ uint16_t actionFlags() const { return _actionFlags; } /** * @brief Sets the action flags field * * @param[in] flags - the new action flags */ void setActionFlags(uint16_t flags) { _actionFlags = flags; } /** * @brief Returns the host transmission state * * @return uint8_t - the host transmission state */ uint8_t hostTransmissionState() const { return _states & 0xFF; } /** * @brief Sets the host transmission state * * @param[in] state - the new state */ void setHostTransmissionState(uint8_t state) { _states &= 0xFFFFFF00; _states |= state; } /** * @brief Returns the HMC transmission state * * (HMC = Hardware Management Console) * * @return uint8_t - the HMC transmission state */ uint8_t hmcTransmissionState() const { return (_states & 0x0000FF00) >> 8; } /** * @brief Sets the HMC transmission state * * @param[in] state - the new state */ void setHMCTransmissionState(uint8_t state) { uint32_t newState = state << 8; _states &= 0xFFFF00FF; _states |= newState; } /** * @brief Returns the size of this section when flattened into a PEL * * @return size_t - the size of the section */ static constexpr size_t flattenedSize() { return Section::flattenedSize() + sizeof(_eventSubsystem) + sizeof(_eventScope) + sizeof(_eventSeverity) + sizeof(_eventType) + sizeof(_reserved4Byte1) + sizeof(_problemDomain) + sizeof(_problemVector) + sizeof(_actionFlags) + sizeof(_states); } /** * @brief Get section in JSON. * @return std::optional -User header section's JSON */ std::optional getJSON() const override; private: /** * @brief Fills in the object from the stream data * * @param[in] stream - The stream to read from */ void unflatten(Stream& stream); /** * @brief Validates the section contents * * Updates _valid (in Section) with the results. */ void validate() override; /** * @brief Returns the severity value to use from the list * of them passed in based on the system type. * * If there isn't an entry found for the current system * type then std::nullopt will be returned. * * @param[in] severities - The array of {systype, severity} * structures to find an entry in. * @param[in] dataIface - The DataInterface object */ std::optional getSeverity(const std::vector& severities, const DataInterfaceBase& dataIface) const; /** * @brief The subsystem associated with the event. */ uint8_t _eventSubsystem; /** * @brief The event scope field. */ uint8_t _eventScope; /** * @brief The event severity. */ uint8_t _eventSeverity; /** * @brief The event type. */ uint8_t _eventType; /** * @brief A reserved word placeholder */ uint32_t _reserved4Byte1; /** * @brief The problem domain field. */ uint8_t _problemDomain; /** * @brief The problem vector field. */ uint8_t _problemVector; /** * @brief The action flags field. */ uint16_t _actionFlags; /** * @brief The second reserved word that we are * using for storing state information. * * 0x0000AABB * Where: * 0xAA = HMC transmission state * 0xBB = Host transmission state */ uint32_t _states; }; } // namespace pels } // namespace openpower