blob: 6e196666483d91bdd544117b9a0e55f9a7a45b9a [file] [log] [blame]
#pragma once
#include <stdint.h>
#include <ipmid/api.hpp>
#include <ipmid/types.hpp>
#include <exception>
// IPMI commands for net functions.
enum ipmi_netfn_sen_cmds
{
IPMI_CMD_PLATFORM_EVENT = 0x2,
IPMI_CMD_GET_DEVICE_SDR_INFO = 0x20,
IPMI_CMD_GET_DEVICE_SDR = 0x21,
IPMI_CMD_RESERVE_DEVICE_SDR_REPO = 0x22,
IPMI_CMD_GET_SENSOR_READING = 0x2D,
IPMI_CMD_GET_SENSOR_TYPE = 0x2F,
IPMI_CMD_SET_SENSOR = 0x30,
IPMI_CMD_GET_SENSOR_THRESHOLDS = 0x27,
};
/**
* @enum device_type
* IPMI FRU device types
*/
enum device_type
{
IPMI_PHYSICAL_FRU = 0x00,
IPMI_LOGICAL_FRU = 0x80,
};
// Discrete sensor types.
enum ipmi_sensor_types
{
IPMI_SENSOR_TEMP = 0x01,
IPMI_SENSOR_VOLTAGE = 0x02,
IPMI_SENSOR_CURRENT = 0x03,
IPMI_SENSOR_FAN = 0x04,
IPMI_SENSOR_TPM = 0xCC,
};
/** @brief Custom exception for reading sensors that are not funcitonal.
*/
struct SensorFunctionalError : public std::exception
{
const char* what() const noexcept
{
return "Sensor not functional";
}
};
#define MAX_DBUS_PATH 128
struct dbus_interface_t
{
uint8_t sensornumber;
uint8_t sensortype;
char bus[MAX_DBUS_PATH];
char path[MAX_DBUS_PATH];
char interface[MAX_DBUS_PATH];
};
struct PlatformEventRequest
{
uint8_t eventMessageRevision;
uint8_t sensorType;
uint8_t sensorNumber;
uint8_t eventDirectionType;
uint8_t data[3];
};
static constexpr const char* ipmiSELPath = "/xyz/openbmc_project/Logging/IPMI";
static constexpr const char* ipmiSELAddInterface =
"xyz.openbmc_project.Logging.IPMI";
static const std::string ipmiSELAddMessage = "IPMI generated SEL Entry";
static constexpr int selSystemEventSizeWith3Bytes = 8;
static constexpr int selSystemEventSizeWith2Bytes = 7;
static constexpr int selSystemEventSizeWith1Bytes = 6;
static constexpr int selIPMBEventSize = 7;
static constexpr uint8_t directionMask = 0x80;
static constexpr uint8_t byte3EnableMask = 0x30;
static constexpr uint8_t byte2EnableMask = 0xC0;
int set_sensor_dbus_state_s(uint8_t, const char*, const char*);
int set_sensor_dbus_state_y(uint8_t, const char*, const uint8_t);
int find_openbmc_path(uint8_t, dbus_interface_t*);
ipmi_ret_t ipmi_sen_get_sdr(ipmi_netfn_t netfn, ipmi_cmd_t cmd,
ipmi_request_t request, ipmi_response_t response,
ipmi_data_len_t data_len, ipmi_context_t context);
ipmi::RspType<uint16_t> ipmiSensorReserveSdr();
static const uint16_t FRU_RECORD_ID_START = 256;
static const uint16_t ENTITY_RECORD_ID_START = 512;
static const uint8_t SDR_VERSION = 0x51;
static const uint16_t END_OF_RECORD = 0xFFFF;
static const uint8_t LENGTH_MASK = 0x1F;
/**
* Get SDR Info
*/
namespace get_sdr_info
{
namespace request
{
// Note: for some reason the ipmi_request_t appears to be the
// raw value for this call.
inline bool get_count(void* req)
{
return (bool)((uint64_t)(req) & 1);
}
} // namespace request
} // namespace get_sdr_info
/**
* Get SDR
*/
namespace get_sdr
{
struct GetSdrReq
{
uint8_t reservation_id_lsb;
uint8_t reservation_id_msb;
uint8_t record_id_lsb;
uint8_t record_id_msb;
uint8_t offset;
uint8_t bytes_to_read;
} __attribute__((packed));
namespace request
{
inline uint16_t get_reservation_id(GetSdrReq* req)
{
return (req->reservation_id_lsb + (req->reservation_id_msb << 8));
};
inline uint16_t get_record_id(GetSdrReq* req)
{
return (req->record_id_lsb + (req->record_id_msb << 8));
};
} // namespace request
// Response
struct GetSdrResp
{
uint8_t next_record_id_lsb;
uint8_t next_record_id_msb;
uint8_t record_data[64];
} __attribute__((packed));
namespace response
{
inline void set_next_record_id(uint16_t next, GetSdrResp* resp)
{
resp->next_record_id_lsb = next & 0xff;
resp->next_record_id_msb = (next >> 8) & 0xff;
};
} // namespace response
// Record header
struct SensorDataRecordHeader
{
uint8_t record_id_lsb;
uint8_t record_id_msb;
uint8_t sdr_version;
uint8_t record_type;
uint8_t record_length; // Length not counting the header
} __attribute__((packed));
namespace header
{
inline void set_record_id(int id, SensorDataRecordHeader* hdr)
{
hdr->record_id_lsb = (id & 0xFF);
hdr->record_id_msb = (id >> 8) & 0xFF;
};
} // namespace header
enum SensorDataRecordType
{
SENSOR_DATA_FULL_RECORD = 0x1,
SENSOR_DATA_COMPACT_RECORD = 0x2,
SENSOR_DATA_EVENT_RECORD = 0x3,
SENSOR_DATA_ENTITY_RECORD = 0x8,
SENSOR_DATA_FRU_RECORD = 0x11,
SENSOR_DATA_MGMT_CTRL_LOCATOR = 0x12,
};
// Record key
struct SensorDataRecordKey
{
uint8_t owner_id;
uint8_t owner_lun;
uint8_t sensor_number;
} __attribute__((packed));
/** @struct SensorDataFruRecordKey
*
* FRU Device Locator Record(key) - SDR Type 11
*/
struct SensorDataFruRecordKey
{
uint8_t deviceAddress;
uint8_t fruID;
uint8_t accessLun;
uint8_t channelNumber;
} __attribute__((packed));
/** @struct SensorDataEntityRecordKey
*
* Entity Association Record(key) - SDR Type 8
*/
struct SensorDataEntityRecordKey
{
uint8_t containerEntityId;
uint8_t containerEntityInstance;
uint8_t flags;
uint8_t entityId1;
uint8_t entityInstance1;
} __attribute__((packed));
namespace key
{
static constexpr uint8_t listOrRangeBit = 7;
static constexpr uint8_t linkedBit = 6;
inline void set_owner_id_ipmb(SensorDataRecordKey* key)
{
key->owner_id &= ~0x01;
};
inline void set_owner_id_system_sw(SensorDataRecordKey* key)
{
key->owner_id |= 0x01;
};
inline void set_owner_id_bmc(SensorDataRecordKey* key)
{
key->owner_id |= 0x20;
};
inline void set_owner_id_address(uint8_t addr, SensorDataRecordKey* key)
{
key->owner_id &= 0x01;
key->owner_id |= addr << 1;
};
inline void set_owner_lun(uint8_t lun, SensorDataRecordKey* key)
{
key->owner_lun &= ~0x03;
key->owner_lun |= (lun & 0x03);
};
inline void set_owner_lun_channel(uint8_t channel, SensorDataRecordKey* key)
{
key->owner_lun &= 0x0f;
key->owner_lun |= ((channel & 0xf) << 4);
};
inline void set_flags(bool isList, bool isLinked,
SensorDataEntityRecordKey* key)
{
key->flags = 0x00;
if (!isList)
key->flags |= 1 << listOrRangeBit;
if (isLinked)
key->flags |= 1 << linkedBit;
};
} // namespace key
/** @struct GetSensorThresholdsResponse
*
* Response structure for Get Sensor Thresholds command
*/
struct GetSensorThresholdsResponse
{
uint8_t validMask; //!< valid mask
uint8_t lowerNonCritical; //!< lower non-critical threshold
uint8_t lowerCritical; //!< lower critical threshold
uint8_t lowerNonRecoverable; //!< lower non-recoverable threshold
uint8_t upperNonCritical; //!< upper non-critical threshold
uint8_t upperCritical; //!< upper critical threshold
uint8_t upperNonRecoverable; //!< upper non-recoverable threshold
} __attribute__((packed));
// Body - full record
#define FULL_RECORD_ID_STR_MAX_LENGTH 16
static const int FRU_RECORD_DEVICE_ID_MAX_LENGTH = 16;
struct SensorDataFullRecordBody
{
uint8_t entity_id;
uint8_t entity_instance;
uint8_t sensor_initialization;
uint8_t sensor_capabilities; // no macro support
uint8_t sensor_type;
uint8_t event_reading_type;
uint8_t supported_assertions[2]; // no macro support
uint8_t supported_deassertions[2]; // no macro support
uint8_t discrete_reading_setting_mask[2]; // no macro support
uint8_t sensor_units_1;
uint8_t sensor_units_2_base;
uint8_t sensor_units_3_modifier;
uint8_t linearization;
uint8_t m_lsb;
uint8_t m_msb_and_tolerance;
uint8_t b_lsb;
uint8_t b_msb_and_accuracy_lsb;
uint8_t accuracy_and_sensor_direction;
uint8_t r_b_exponents;
uint8_t analog_characteristic_flags; // no macro support
uint8_t nominal_reading;
uint8_t normal_max;
uint8_t normal_min;
uint8_t sensor_max;
uint8_t sensor_min;
uint8_t upper_nonrecoverable_threshold;
uint8_t upper_critical_threshold;
uint8_t upper_noncritical_threshold;
uint8_t lower_nonrecoverable_threshold;
uint8_t lower_critical_threshold;
uint8_t lower_noncritical_threshold;
uint8_t positive_threshold_hysteresis;
uint8_t negative_threshold_hysteresis;
uint16_t reserved;
uint8_t oem_reserved;
uint8_t id_string_info;
char id_string[FULL_RECORD_ID_STR_MAX_LENGTH];
} __attribute__((packed));
/** @struct SensorDataCompactRecord
*
* Compact Sensor Record(body) - SDR Type 2
*/
struct SensorDataCompactRecordBody
{
uint8_t entity_id;
uint8_t entity_instance;
uint8_t sensor_initialization;
uint8_t sensor_capabilities; // no macro support
uint8_t sensor_type;
uint8_t event_reading_type;
uint8_t supported_assertions[2]; // no macro support
uint8_t supported_deassertions[2]; // no macro support
uint8_t discrete_reading_setting_mask[2]; // no macro support
uint8_t sensor_units_1;
uint8_t sensor_units_2_base;
uint8_t sensor_units_3_modifier;
uint8_t record_sharing[2];
uint8_t positive_threshold_hysteresis;
uint8_t negative_threshold_hysteresis;
uint8_t reserved[3];
uint8_t oem_reserved;
uint8_t id_string_info;
char id_string[FULL_RECORD_ID_STR_MAX_LENGTH];
} __attribute__((packed));
/** @struct SensorDataEventRecord
*
* Event Only Sensor Record(body) - SDR Type 3
*/
struct SensorDataEventRecordBody
{
uint8_t entity_id;
uint8_t entity_instance;
uint8_t sensor_type;
uint8_t event_reading_type;
uint8_t sensor_record_sharing_1;
uint8_t sensor_record_sharing_2;
uint8_t reserved;
uint8_t oem_reserved;
uint8_t id_string_info;
char id_string[FULL_RECORD_ID_STR_MAX_LENGTH];
} __attribute__((packed));
/** @struct SensorDataFruRecordBody
*
* FRU Device Locator Record(body) - SDR Type 11
*/
struct SensorDataFruRecordBody
{
uint8_t reserved;
uint8_t deviceType;
uint8_t deviceTypeModifier;
uint8_t entityID;
uint8_t entityInstance;
uint8_t oem;
uint8_t deviceIDLen;
char deviceID[FRU_RECORD_DEVICE_ID_MAX_LENGTH];
} __attribute__((packed));
/** @struct SensorDataEntityRecordBody
*
* Entity Association Record(body) - SDR Type 8
*/
struct SensorDataEntityRecordBody
{
uint8_t entityId2;
uint8_t entityInstance2;
uint8_t entityId3;
uint8_t entityInstance3;
uint8_t entityId4;
uint8_t entityInstance4;
} __attribute__((packed));
namespace body
{
inline void set_entity_instance_number(uint8_t n,
SensorDataFullRecordBody* body)
{
body->entity_instance &= 1 << 7;
body->entity_instance |= (n & ~(1 << 7));
};
inline void set_entity_physical_entity(SensorDataFullRecordBody* body)
{
body->entity_instance &= ~(1 << 7);
};
inline void set_entity_logical_container(SensorDataFullRecordBody* body)
{
body->entity_instance |= 1 << 7;
};
inline void sensor_scanning_state(bool enabled, SensorDataFullRecordBody* body)
{
if (enabled)
{
body->sensor_initialization |= 1 << 0;
}
else
{
body->sensor_initialization &= ~(1 << 0);
};
};
inline void event_generation_state(bool enabled, SensorDataFullRecordBody* body)
{
if (enabled)
{
body->sensor_initialization |= 1 << 1;
}
else
{
body->sensor_initialization &= ~(1 << 1);
}
};
inline void init_types_state(bool enabled, SensorDataFullRecordBody* body)
{
if (enabled)
{
body->sensor_initialization |= 1 << 2;
}
else
{
body->sensor_initialization &= ~(1 << 2);
}
};
inline void init_hyst_state(bool enabled, SensorDataFullRecordBody* body)
{
if (enabled)
{
body->sensor_initialization |= 1 << 3;
}
else
{
body->sensor_initialization &= ~(1 << 3);
}
};
inline void init_thresh_state(bool enabled, SensorDataFullRecordBody* body)
{
if (enabled)
{
body->sensor_initialization |= 1 << 4;
}
else
{
body->sensor_initialization &= ~(1 << 4);
}
};
inline void init_events_state(bool enabled, SensorDataFullRecordBody* body)
{
if (enabled)
{
body->sensor_initialization |= 1 << 5;
}
else
{
body->sensor_initialization &= ~(1 << 5);
}
};
inline void init_scanning_state(bool enabled, SensorDataFullRecordBody* body)
{
if (enabled)
{
body->sensor_initialization |= 1 << 6;
}
else
{
body->sensor_initialization &= ~(1 << 6);
}
};
inline void init_settable_state(bool enabled, SensorDataFullRecordBody* body)
{
if (enabled)
{
body->sensor_initialization |= 1 << 7;
}
else
{
body->sensor_initialization &= ~(1 << 7);
}
};
inline void set_percentage(SensorDataFullRecordBody* body)
{
body->sensor_units_1 |= 1 << 0;
};
inline void unset_percentage(SensorDataFullRecordBody* body)
{
body->sensor_units_1 &= ~(1 << 0);
};
inline void set_modifier_operation(uint8_t op, SensorDataFullRecordBody* body)
{
body->sensor_units_1 &= ~(3 << 1);
body->sensor_units_1 |= (op & 0x3) << 1;
};
inline void set_rate_unit(uint8_t unit, SensorDataFullRecordBody* body)
{
body->sensor_units_1 &= ~(7 << 3);
body->sensor_units_1 |= (unit & 0x7) << 3;
};
inline void set_analog_data_format(uint8_t format,
SensorDataFullRecordBody* body)
{
body->sensor_units_1 &= ~(3 << 6);
body->sensor_units_1 |= (format & 0x3) << 6;
};
inline void set_m(uint16_t m, SensorDataFullRecordBody* body)
{
body->m_lsb = m & 0xff;
body->m_msb_and_tolerance &= ~(3 << 6);
body->m_msb_and_tolerance |= ((m & (3 << 8)) >> 2);
};
inline void set_tolerance(uint8_t tol, SensorDataFullRecordBody* body)
{
body->m_msb_and_tolerance &= ~0x3f;
body->m_msb_and_tolerance |= tol & 0x3f;
};
inline void set_b(uint16_t b, SensorDataFullRecordBody* body)
{
body->b_lsb = b & 0xff;
body->b_msb_and_accuracy_lsb &= ~(3 << 6);
body->b_msb_and_accuracy_lsb |= ((b & (3 << 8)) >> 2);
};
inline void set_accuracy(uint16_t acc, SensorDataFullRecordBody* body)
{
// bottom 6 bits
body->b_msb_and_accuracy_lsb &= ~0x3f;
body->b_msb_and_accuracy_lsb |= acc & 0x3f;
// top 4 bits
body->accuracy_and_sensor_direction &= 0x0f;
body->accuracy_and_sensor_direction |= ((acc >> 6) & 0xf) << 4;
};
inline void set_accuracy_exp(uint8_t exp, SensorDataFullRecordBody* body)
{
body->accuracy_and_sensor_direction &= ~(3 << 2);
body->accuracy_and_sensor_direction |= (exp & 3) << 2;
};
inline void set_sensor_dir(uint8_t dir, SensorDataFullRecordBody* body)
{
body->accuracy_and_sensor_direction &= ~(3 << 0);
body->accuracy_and_sensor_direction |= (dir & 3);
};
inline void set_b_exp(uint8_t exp, SensorDataFullRecordBody* body)
{
body->r_b_exponents &= 0xf0;
body->r_b_exponents |= exp & 0x0f;
};
inline void set_r_exp(uint8_t exp, SensorDataFullRecordBody* body)
{
body->r_b_exponents &= 0x0f;
body->r_b_exponents |= (exp & 0x0f) << 4;
};
inline void set_id_strlen(uint8_t len, SensorDataFullRecordBody* body)
{
body->id_string_info &= ~(0x1f);
body->id_string_info |= len & 0x1f;
};
inline void set_id_strlen(uint8_t len, SensorDataEventRecordBody* body)
{
body->id_string_info &= ~(0x1f);
body->id_string_info |= len & 0x1f;
};
inline uint8_t get_id_strlen(SensorDataFullRecordBody* body)
{
return body->id_string_info & 0x1f;
};
inline void set_id_type(uint8_t type, SensorDataFullRecordBody* body)
{
body->id_string_info &= ~(3 << 6);
body->id_string_info |= (type & 0x3) << 6;
};
inline void set_id_type(uint8_t type, SensorDataEventRecordBody* body)
{
body->id_string_info &= ~(3 << 6);
body->id_string_info |= (type & 0x3) << 6;
};
inline void set_device_id_strlen(uint8_t len, SensorDataFruRecordBody* body)
{
body->deviceIDLen &= ~(LENGTH_MASK);
body->deviceIDLen |= len & LENGTH_MASK;
};
inline uint8_t get_device_id_strlen(SensorDataFruRecordBody* body)
{
return body->deviceIDLen & LENGTH_MASK;
};
inline void set_readable_mask(uint8_t mask, SensorDataFullRecordBody* body)
{
body->discrete_reading_setting_mask[1] = mask & 0x3F;
}
} // namespace body
// More types contained in section 43.17 Sensor Unit Type Codes,
// IPMI spec v2 rev 1.1
enum SensorUnitTypeCodes
{
SENSOR_UNIT_UNSPECIFIED = 0,
SENSOR_UNIT_DEGREES_C = 1,
SENSOR_UNIT_VOLTS = 4,
SENSOR_UNIT_AMPERES = 5,
SENSOR_UNIT_WATTS = 6,
SENSOR_UNIT_JOULES = 7,
SENSOR_UNIT_RPM = 18,
SENSOR_UNIT_METERS = 34,
SENSOR_UNIT_REVOLUTIONS = 41,
};
struct SensorDataFullRecord
{
SensorDataRecordHeader header;
SensorDataRecordKey key;
SensorDataFullRecordBody body;
} __attribute__((packed));
/** @struct SensorDataComapactRecord
*
* Compact Sensor Record - SDR Type 2
*/
struct SensorDataCompactRecord
{
SensorDataRecordHeader header;
SensorDataRecordKey key;
SensorDataCompactRecordBody body;
} __attribute__((packed));
/** @struct SensorDataEventRecord
*
* Event Only Sensor Record - SDR Type 3
*/
struct SensorDataEventRecord
{
SensorDataRecordHeader header;
SensorDataRecordKey key;
SensorDataEventRecordBody body;
} __attribute__((packed));
/** @struct SensorDataFruRecord
*
* FRU Device Locator Record - SDR Type 11
*/
struct SensorDataFruRecord
{
SensorDataRecordHeader header;
SensorDataFruRecordKey key;
SensorDataFruRecordBody body;
} __attribute__((packed));
/** @struct SensorDataEntityRecord
*
* Entity Association Record - SDR Type 8
*/
struct SensorDataEntityRecord
{
SensorDataRecordHeader header;
SensorDataEntityRecordKey key;
SensorDataEntityRecordBody body;
} __attribute__((packed));
} // namespace get_sdr
namespace ipmi
{
namespace sensor
{
/**
* @brief Map offset to the corresponding bit in the assertion byte.
*
* The discrete sensors support up to 14 states. 0-7 offsets are stored in one
* byte and offsets 8-14 in the second byte.
*
* @param[in] offset - offset number.
* @param[in/out] resp - get sensor reading response.
*/
inline void setOffset(uint8_t offset, ipmi::sensor::GetSensorResponse* resp)
{
if (offset > 7)
{
resp->discreteReadingSensorStates |= 1 << (offset - 8);
}
else
{
resp->thresholdLevelsStates |= 1 << offset;
}
}
/**
* @brief Set the reading field in the response.
*
* @param[in] offset - offset number.
* @param[in/out] resp - get sensor reading response.
*/
inline void setReading(uint8_t value, ipmi::sensor::GetSensorResponse* resp)
{
resp->reading = value;
}
/**
* @brief Map the value to the assertion bytes. The assertion states are stored
* in 2 bytes.
*
* @param[in] value - value to mapped to the assertion byte.
* @param[in/out] resp - get sensor reading response.
*/
inline void setAssertionBytes(uint16_t value,
ipmi::sensor::GetSensorResponse* resp)
{
resp->thresholdLevelsStates = static_cast<uint8_t>(value & 0x00FF);
resp->discreteReadingSensorStates = static_cast<uint8_t>(value >> 8);
}
/**
* @brief Set the scanning enabled bit in the response.
*
* @param[in/out] resp - get sensor reading response.
*/
inline void enableScanning(ipmi::sensor::GetSensorResponse* resp)
{
resp->readingOrStateUnavailable = false;
resp->scanningEnabled = true;
resp->allEventMessagesEnabled = false;
}
} // namespace sensor
} // namespace ipmi