NetFn: Use api.hpp instead of api.h

Since NetFn declared in api.h has been gradually deprecated, this
submission is to use api.hpp instead of api.h.

https://gerrit.openbmc.org/c/openbmc/phosphor-host-ipmid/+/79391

Change-Id: I765c4962baff5c6d57279a3462bc58abd1b52bae
Signed-off-by: George Liu <liuxiwei@ieisystem.com>
1 file changed
tree: bca95d4e4eebc21277deb93e9f50118426e0fc13
  1. org/
  2. scripts/
  3. subprojects/
  4. .clang-format
  5. .gitignore
  6. bootstrap.sh
  7. elog-errors.hpp
  8. host-interface.cpp
  9. host-interface.hpp
  10. LICENSE
  11. meson.build
  12. meson.options
  13. oemhandler.cpp
  14. oemhandler.hpp
  15. OWNERS
  16. README.md
README.md

This .so file is designed to support the OpenPOWER's BIOS OEM commands. Documentation can be found by contacting the OpenPOWER mailing list @ https://github.com/open-power/op-build

To Build

To build this package, do the following steps:

    meson setup build
    ninja -C build

To clean the repository again run rm -rf build.

Supported Commands

  • Partial Add
  • Prepare for host update
  • BMC Factory Reset

Command Documentation

BMC Factory Reset

Netfun: 0x3a Command: 0x11

This command will call to reset the BMC to its factory default. See here for the factory reset implementation details.

This includes:

  1. Power the chassis off. The host needs to be powered off because the factory reset deletes the inventory items, which are needed for the BMC during the power on path, causing the power on to fail. The inventory items are repopulated during a host power on. An enhancement to OpenBMC would be to handle missing inventory items during a BMC reboot when the host is on.
  2. Set the BMC to perform factory reset on reboot.
  3. Reboot the BMC for the factory reset to take effect.

Because the chassis is powered off, the host does not receive a return code when successful.

This command is not allowed when the IPMI restriction mode is set to 'Whitelist'. See here for more information.