blob: e64cb72c2376e45441b1a7fa3d6fd09ea2e5f0d1 [file] [log] [blame]
#include "watchdog.hpp"
#include "watchdog_service.hpp"
#include <endian.h>
#include <ipmid/api.hpp>
#include <phosphor-logging/elog-errors.hpp>
#include <phosphor-logging/elog.hpp>
#include <phosphor-logging/log.hpp>
#include <xyz/openbmc_project/Common/error.hpp>
#include <bitset>
#include <cstdint>
#include <string>
using phosphor::logging::commit;
using phosphor::logging::level;
using phosphor::logging::log;
using sdbusplus::error::xyz::openbmc_project::common::InternalFailure;
static bool lastCallSuccessful = false;
void reportError()
{
// We don't want to fill the SEL with errors if the daemon dies and doesn't
// come back but the watchdog keeps on ticking. Instead, we only report the
// error if we haven't reported one since the last successful call
if (!lastCallSuccessful)
{
return;
}
lastCallSuccessful = false;
// TODO: This slow down the end of the IPMI transaction waiting
// for the commit to finish. commit<>() can take at least 5 seconds
// to complete. 5s is very slow for an IPMI command and ends up
// congesting the IPMI channel needlessly, especially if the watchdog
// is ticking fairly quickly and we have some transient issues.
commit<InternalFailure>();
}
ipmi::RspType<> ipmiAppResetWatchdogTimer()
{
try
{
WatchdogService wd_service;
// Notify the caller if we haven't initialized our timer yet
// so it can configure actions and timeouts
if (!wd_service.getInitialized())
{
lastCallSuccessful = true;
constexpr uint8_t ccWatchdogNotInit = 0x80;
return ipmi::response(ccWatchdogNotInit);
}
// The ipmi standard dictates we enable the watchdog during reset
wd_service.resetTimeRemaining(true);
lastCallSuccessful = true;
return ipmi::responseSuccess();
}
catch (const InternalFailure& e)
{
reportError();
return ipmi::responseUnspecifiedError();
}
catch (const std::exception& e)
{
const std::string e_str = std::string("wd_reset: ") + e.what();
log<level::ERR>(e_str.c_str());
return ipmi::responseUnspecifiedError();
}
catch (...)
{
log<level::ERR>("wd_reset: Unknown Error");
return ipmi::responseUnspecifiedError();
}
}
static constexpr uint8_t wd_dont_stop = 0x1 << 6;
static constexpr uint8_t wd_timeout_action_mask = 0x3;
static constexpr uint8_t wdTimerUseResTimer1 = 0x0;
static constexpr uint8_t wdTimerUseResTimer2 = 0x6;
static constexpr uint8_t wdTimerUseResTimer3 = 0x7;
static constexpr uint8_t wdTimeoutActionMax = 3;
static constexpr uint8_t wdTimeoutInterruptTimer = 0x04;
enum class IpmiAction : uint8_t
{
None = 0x0,
HardReset = 0x1,
PowerOff = 0x2,
PowerCycle = 0x3,
};
/** @brief Converts an IPMI Watchdog Action to DBUS defined action
* @param[in] ipmi_action The IPMI Watchdog Action
* @return The Watchdog Action that the ipmi_action maps to
*/
WatchdogService::Action ipmiActionToWdAction(IpmiAction ipmi_action)
{
switch (ipmi_action)
{
case IpmiAction::None:
{
return WatchdogService::Action::None;
}
case IpmiAction::HardReset:
{
return WatchdogService::Action::HardReset;
}
case IpmiAction::PowerOff:
{
return WatchdogService::Action::PowerOff;
}
case IpmiAction::PowerCycle:
{
return WatchdogService::Action::PowerCycle;
}
default:
{
throw std::domain_error("IPMI Action is invalid");
}
}
}
enum class IpmiTimerUse : uint8_t
{
Reserved = 0x0,
BIOSFRB2 = 0x1,
BIOSPOST = 0x2,
OSLoad = 0x3,
SMSOS = 0x4,
OEM = 0x5,
};
WatchdogService::TimerUse ipmiTimerUseToWdTimerUse(IpmiTimerUse ipmiTimerUse)
{
switch (ipmiTimerUse)
{
case IpmiTimerUse::Reserved:
{
return WatchdogService::TimerUse::Reserved;
}
case IpmiTimerUse::BIOSFRB2:
{
return WatchdogService::TimerUse::BIOSFRB2;
}
case IpmiTimerUse::BIOSPOST:
{
return WatchdogService::TimerUse::BIOSPOST;
}
case IpmiTimerUse::OSLoad:
{
return WatchdogService::TimerUse::OSLoad;
}
case IpmiTimerUse::SMSOS:
{
return WatchdogService::TimerUse::SMSOS;
}
case IpmiTimerUse::OEM:
{
return WatchdogService::TimerUse::OEM;
}
default:
{
return WatchdogService::TimerUse::Reserved;
}
}
}
static bool timerNotLogFlags = false;
static std::bitset<8> timerUseExpirationFlags = 0;
static uint3_t timerPreTimeoutInterrupt = 0;
static constexpr uint8_t wdExpirationFlagReservedBit0 = 0x0;
static constexpr uint8_t wdExpirationFlagReservedBit6 = 0x6;
static constexpr uint8_t wdExpirationFlagReservedBit7 = 0x7;
/**@brief The Set Watchdog Timer ipmi command.
*
* @param
* - timerUse
* - dontStopTimer
* - dontLog
* - timerAction
* - pretimeout
* - expireFlags
* - initialCountdown
*
* @return completion code on success.
**/
ipmi::RspType<>
ipmiSetWatchdogTimer(uint3_t timerUse, uint3_t reserved, bool dontStopTimer,
bool dontLog, uint3_t timeoutAction, uint1_t reserved1,
uint3_t preTimeoutInterrupt, uint1_t reserved2,
uint8_t preTimeoutInterval,
std::bitset<8> expFlagValue, uint16_t initialCountdown)
{
if ((timerUse == wdTimerUseResTimer1) ||
(timerUse == wdTimerUseResTimer2) ||
(timerUse == wdTimerUseResTimer3) ||
(timeoutAction > wdTimeoutActionMax) ||
(preTimeoutInterrupt == wdTimeoutInterruptTimer) ||
(reserved | reserved1 | reserved2 |
expFlagValue.test(wdExpirationFlagReservedBit0) |
expFlagValue.test(wdExpirationFlagReservedBit6) |
expFlagValue.test(wdExpirationFlagReservedBit7)))
{
return ipmi::responseInvalidFieldRequest();
}
if (preTimeoutInterval > (initialCountdown / 10))
{
return ipmi::responseInvalidFieldRequest();
}
timerNotLogFlags = dontLog;
timerPreTimeoutInterrupt = preTimeoutInterrupt;
try
{
WatchdogService wd_service;
// Stop the timer if the don't stop bit is not set
if (!(dontStopTimer))
{
wd_service.setEnabled(false);
}
// Set the action based on the request
const auto ipmi_action = static_cast<IpmiAction>(
static_cast<uint8_t>(timeoutAction) & wd_timeout_action_mask);
wd_service.setExpireAction(ipmiActionToWdAction(ipmi_action));
const auto ipmiTimerUse = types::enum_cast<IpmiTimerUse>(timerUse);
wd_service.setTimerUse(ipmiTimerUseToWdTimerUse(ipmiTimerUse));
wd_service.setExpiredTimerUse(WatchdogService::TimerUse::Reserved);
timerUseExpirationFlags &= ~expFlagValue;
// Set the new interval and the time remaining deci -> mill seconds
const uint64_t interval = initialCountdown * 100;
wd_service.setInterval(interval);
wd_service.resetTimeRemaining(false);
// Mark as initialized so that future resets behave correctly
wd_service.setInitialized(true);
wd_service.setLogTimeout(!dontLog);
lastCallSuccessful = true;
return ipmi::responseSuccess();
}
catch (const std::domain_error&)
{
return ipmi::responseInvalidFieldRequest();
}
catch (const InternalFailure& e)
{
reportError();
return ipmi::responseUnspecifiedError();
}
catch (const std::exception& e)
{
const std::string e_str = std::string("wd_set: ") + e.what();
log<level::ERR>(e_str.c_str());
return ipmi::responseUnspecifiedError();
}
catch (...)
{
log<level::ERR>("wd_set: Unknown Error");
return ipmi::responseUnspecifiedError();
}
}
/** @brief Converts a DBUS Watchdog Action to IPMI defined action
* @param[in] wd_action The DBUS Watchdog Action
* @return The IpmiAction that the wd_action maps to
*/
IpmiAction wdActionToIpmiAction(WatchdogService::Action wd_action)
{
switch (wd_action)
{
case WatchdogService::Action::None:
{
return IpmiAction::None;
}
case WatchdogService::Action::HardReset:
{
return IpmiAction::HardReset;
}
case WatchdogService::Action::PowerOff:
{
return IpmiAction::PowerOff;
}
case WatchdogService::Action::PowerCycle:
{
return IpmiAction::PowerCycle;
}
default:
{
// We have no method via IPMI to signal that the action is unknown
// or unmappable in some way.
// Just ignore the error and return NONE so the host can reconcile.
return IpmiAction::None;
}
}
}
IpmiTimerUse wdTimerUseToIpmiTimerUse(WatchdogService::TimerUse wdTimerUse)
{
switch (wdTimerUse)
{
case WatchdogService::TimerUse::Reserved:
{
return IpmiTimerUse::Reserved;
}
case WatchdogService::TimerUse::BIOSFRB2:
{
return IpmiTimerUse::BIOSFRB2;
}
case WatchdogService::TimerUse::BIOSPOST:
{
return IpmiTimerUse::BIOSPOST;
}
case WatchdogService::TimerUse::OSLoad:
{
return IpmiTimerUse::OSLoad;
}
case WatchdogService::TimerUse::SMSOS:
{
return IpmiTimerUse::SMSOS;
}
case WatchdogService::TimerUse::OEM:
{
return IpmiTimerUse::OEM;
}
default:
{
return IpmiTimerUse::Reserved;
}
}
}
static constexpr uint8_t wd_running = 0x1 << 6;
/**@brief The getWatchdogTimer ipmi command.
*
* @return Completion code plus timer details.
* - timerUse
* - timerAction
* - pretimeout
* - expireFlags
* - initialCountdown
* - presentCountdown
**/
ipmi::RspType<uint3_t, // timerUse - timer use
uint3_t, // timerUse - reserved
bool, // timerUse - timer is started
bool, // timerUse - don't log
uint3_t, // timerAction - timeout action
uint1_t, // timerAction - reserved
uint3_t, // timerAction - pre-timeout interrupt
uint1_t, // timerAction - reserved
uint8_t, // pretimeout
std::bitset<8>, // expireFlags
uint16_t, // initial Countdown - Little Endian (deciseconds)
uint16_t // present Countdown - Little Endian (deciseconds)
>
ipmiGetWatchdogTimer()
{
uint16_t presentCountdown = 0;
uint8_t pretimeout = 0;
try
{
WatchdogService wd_service;
WatchdogService::Properties wd_prop = wd_service.getProperties();
// Build and return the response
// Interval and timeRemaining need converted from milli -> deci seconds
uint16_t initialCountdown = htole16(wd_prop.interval / 100);
if (wd_prop.expiredTimerUse != WatchdogService::TimerUse::Reserved)
{
timerUseExpirationFlags.set(static_cast<uint8_t>(
wdTimerUseToIpmiTimerUse(wd_prop.expiredTimerUse)));
}
if (wd_prop.enabled)
{
presentCountdown = htole16(wd_prop.timeRemaining / 100);
}
else
{
if (wd_prop.expiredTimerUse == WatchdogService::TimerUse::Reserved)
{
presentCountdown = initialCountdown;
}
else
{
presentCountdown = 0;
// Automatically clear it whenever a timer expiration occurs.
timerNotLogFlags = false;
}
}
// TODO: Do something about having pretimeout support
pretimeout = 0;
lastCallSuccessful = true;
return ipmi::responseSuccess(
types::enum_cast<uint3_t>(
wdTimerUseToIpmiTimerUse(wd_prop.timerUse)),
0, wd_prop.enabled, timerNotLogFlags,
types::enum_cast<uint3_t>(
wdActionToIpmiAction(wd_prop.expireAction)),
0, timerPreTimeoutInterrupt, 0, pretimeout, timerUseExpirationFlags,
initialCountdown, presentCountdown);
}
catch (const InternalFailure& e)
{
reportError();
return ipmi::responseUnspecifiedError();
}
catch (const std::exception& e)
{
const std::string e_str = std::string("wd_get: ") + e.what();
log<level::ERR>(e_str.c_str());
return ipmi::responseUnspecifiedError();
}
catch (...)
{
log<level::ERR>("wd_get: Unknown Error");
return ipmi::responseUnspecifiedError();
}
}