OEM-IPMI Commands to talk to Phosphor-pid-control

IPMI Command Specification

The host needs the ability to send to the BMC, the margin information on the devices that it knows how to read that the BMC cannot. There is no command in IPMI that currently supports this use-case, therefore it will be added as an OEM command.

The state of the BMC readable temperature sensors can be read through normal IPMI commands and is already supported.

OEM Set Control

A host tool needs to be able to set the control of the thermal system to either automatic or manual. When manual, the daemon will effectively wait to be told to be put back in automatic mode. It is expected in this manual mode that something will be controlling the fans via the other commands.

Manual mode is controlled by zone through the following OEM command:

Request

BytePurposeValue
00netfn0x2e
01command0x04 (also using manual command)
02oem10xcf
03oem20xc2
04padding0x00
05SubCommandGet or Set. Get == 0, Set == 1
06ZoneId
07ModeIf Set, Value 1 == Manual Mode, 0 == Automatic Mode

Response

BytePurposeValue
02oem10xcf
03oem20xc2
04padding0x00
07ModeIf Set, Value 1 == Manual Mode, 0 == Automatic Mode

OEM Get Failsafe Mode

A host tool needs to be able to read back whether a zone is in failsafe mode. This setting is read-only because it's dynamically determined within Swampd per zone.

BytePurposeValue
00netfn0x2e
01command0x04 (also using manual command)
02oem10xcf
03oem20xc2
04padding0x00
05SubCommandGet == 2
06ZoneId

Response

BytePurposeValue
02oem10xcf
03oem20xc2
04padding0x00
07failsafe1 == in Failsafe Mode, 0 not in failsafe mode