vpd-tool:Option to fixSystemVPD keywords
This commit has an added option in vpd-tool that fixes system VPD
restorable keywords in an interactive way.
This option is required in a field usecase.
In the field when there is a fault in BMC and BMC gets replaced,
the replaced BMC VPD will now have all blank data. Now the Product
engineer can use vpd-tool fixSystemVPD option to update the BMC
critical keywords by chosing the corresponding keyword data from
system backplane.
Similarly when the system backplane is replaced,
using the option, the PEs' can copy the keyword data from BMC.
When both system backplane and BMC are replaced, the PEs' will have
option to update new value on both.
This interactive tool option eases keyword data updation and avoids
manual updation for each and every mismatching critical keyword.
Test: Tested on everest
// Create a mismatch.
root@ever8bmc:/tmp# ./vpd-tool-writeHardwareFix -w -H -O /sys/bus/i2c/drivers/at24/8-0050/eeprom -R VCEN -K FC -V 0x64560204
Disabled reboot
Sleep started
Enabled reboot
root@ever8bmc:/tmp#
root@ever8bmc:/tmp# busctl set-property xyz.openbmc_project.Inventory.Manager /xyz/openbmc_project/inventory/system/chassis/motherboard com.ibm.ipzvpd.LXR0 LX ay 2 0x04 0x64
root@ever8bmc:/tmp#
root@ever8bmc:/tmp# busctl set-property xyz.openbmc_project.Inventory.Manager /xyz/openbmc_project/inventory/system/chassis/motherboard com.ibm.ipzvpd.VSYS WN ay 3 0x74 0x85 0x69
root@ever8bmc:/tmp# ./vpd-tool-writeHardwareFix -w -H -O /sys/bus/i2c/drivers/at24/8-0050/eeprom -R VSYS -K WN -V 0x64560204077675
Disabled reboot
Sleep started
Enabled reboot
=========
(Trimmed the output)
root@ever8bmc:/tmp# ./vpd-tool --fixSystemVPD
Restorable record-keyword pairs and their data on cache & hardware.
|======================================================================================================|
S.No Record Keyword Data On Cache Data On Hardware Data Mismatch
|======================================================================================================|
1 UTIL D0 0x69 0x69 NO
|------------------------------------------------------------------------------------------------------|
2 LXR0 LX 0x0464 0x3100080100300074 YES
|------------------------------------------------------------------------------------------------------|
3 VCEN FC 0x373830432d303031 0x645602042d303031 YES
|------------------------------------------------------------------------------------------------------|
4 VCEN SE RCH0014 RCH0014 NO
|------------------------------------------------------------------------------------------------------|
5 VSYS BR 0x5330 0x5330 NO
|------------------------------------------------------------------------------------------------------|
6 VSYS TM 0x646534302d4d5258 0x646534302d4d5258 NO
|------------------------------------------------------------------------------------------------------|
7 VSYS SE 13E8CEX 13E8CEX NO
|------------------------------------------------------------------------------------------------------|
8 VSYS SU 0x0004ac1e9fd4 0x0004ac1e9fd4 NO
|------------------------------------------------------------------------------------------------------|
9 VSYS RB 0x31000000 0x31000000 NO
|------------------------------------------------------------------------------------------------------|
10 VSYS WN 0x748569 0x645602040776754243453432 YES
|------------------------------------------------------------------------------------------------------|
11 VSYS RG 0x00000000 0x00000000 NO
|------------------------------------------------------------------------------------------------------|
Enter 1 => If you choose cache data of all mismatching record-keyword pairs
Enter 2 => If you choose hardware data of all mismatching record-keyword pairs
Enter 3 => If you wish to explore more options
Enter 0 to exit 3
|======================================================================================================|
Iterate through all restorable record-keyword pairs
|======================================================================================================|
S.No Record Keyword Data On Cache Data On Hardware Data Mismatch
1 UTIL D0 0x69 0x69 NO
|======================================================================================================|
No mismatch found.
Enter 6 => If you wish to enter a new value to update both on BMC and System Backplane
Enter 7 => If you wish to skip the above record-keyword pair
Enter 0 => To exit successfully : 6
|======================================================================================================|
Enter the new value to update both on BMC & System Backplane (Value should be in ASCII or in HEX(prefixed with 0x)) : 0x02
|======================================================================================================|
Data updated successfully.
|======================================================================================================|
S.No Record Keyword Data On Cache Data On Hardware Data Mismatch
2 LXR0 LX 0x0464 0x3100080100300074 YES
|======================================================================================================|
Enter 4 => If you choose the cache value as the right value
Enter 5 => If you choose hardware value as the right value
Enter 6 => If you wish to enter a new value to update both cache and hardware
Enter 7 => If you wish to skip the above record-keyword pair
Enter 0 => To exit successfully 5
|=======================================================================|
Disabled reboot
Sleep started, try to reboot
Sleep end
Sleep started
Enabled reboot
Data updated successfully.
|======================================================================================================|
S.No Record Keyword Data On Cache Data On Hardware Data Mismatch
3 VCEN FC 0x373830432d303031 0x645602042d303031 YES
|======================================================================================================|
Enter 4 => If you choose the cache value as the right value
Enter 5 => If you choose hardware value as the right value
Enter 6 => If you wish to enter a new value to update both cache and hardware
Enter 7 => If you wish to skip the above record-keyword pair
Enter 0 => To exit successfully 4
|=======================================================================|
Disabled reboot
Sleep started, try to reboot
Sleep end
Sleep started
Enabled reboot
Data updated successfully.
|======================================================================================================|
S.No Record Keyword Data On Cache Data On Hardware Data Mismatch
4 VCEN SE RCH0014 RCH0014 NO
|======================================================================================================|
No mismatch found.
Enter 6 => If you wish to enter a new value to update both on BMC and System Backplane
Enter 7 => If you wish to skip the above record-keyword pair
Enter 0 => To exit successfully : 7
|======================================================================================================|
Skipped the above record-keyword pair. Continueing to the next pair if available.
|======================================================================================================|
S.No Record Keyword Data On Cache Data On Hardware Data Mismatch
10 VSYS WN 0x748569 0x645602040776754243453432 YES
|======================================================================================================|
Enter 4 => If you choose the cache value as the right value
Enter 5 => If you choose hardware value as the right value
Enter 6 => If you wish to enter a new value to update both cache and hardware
Enter 7 => If you wish to skip the above record-keyword pair
Enter 0 => To exit successfully 6
|=======================================================================|
Enter the new value to update both in cache & hardware (Value should be in ASCII or in HEX(prefixed with 0x)) : 0x433035303736304243453432
|=======================================================================|
Data updated successfully.
|======================================================================================================|
S.No Record Keyword Data On Cache Data On Hardware Data Mismatch
11 VSYS RG 0x00000000 0x00000000 NO
|======================================================================================================|
No mismatch found. Skip this record-keyword pair.
Signed-off-by: Priyanga Ramasamy <priyanga24@in.ibm.com>
Change-Id: Ifb32efd1174360409b795b162282673a4f73df1b
diff --git a/vpd_tool_impl.hpp b/vpd_tool_impl.hpp
index 3de98f9..8938fce 100644
--- a/vpd_tool_impl.hpp
+++ b/vpd_tool_impl.hpp
@@ -9,6 +9,11 @@
using json = nlohmann::json;
+// <S.no, Record, Keyword, D-Bus value, HW value, Data mismatch>
+using SystemCriticalData =
+ std::vector<std::tuple<int, std::string, std::string, std::string,
+ std::string, std::string>>;
+
class VpdTool
{
private:
@@ -17,6 +22,7 @@
const std::string keyword;
const std::string value;
bool objFound = true;
+ SystemCriticalData recKwData;
// Store Type of FRU
std::string fruType;
@@ -132,6 +138,34 @@
json getPresentPropJson(const std::string& invPath,
std::string& parentPresence);
+ /**
+ * @brief Parse through the options to fix system VPD
+ *
+ * @param[in] json - Inventory JSON
+ */
+ void parseSVPDOptions(const nlohmann::json& json);
+
+ /**
+ * @brief List of user options that can be used to fix system VPD keywords.
+ */
+ enum UserOption
+ {
+ EXIT = 0,
+ BMC_DATA_FOR_ALL = 1,
+ SYSTEM_BACKPLANE_DATA_FOR_ALL = 2,
+ MORE_OPTIONS = 3,
+ BMC_DATA_FOR_CURRENT = 4,
+ SYSTEM_BACKPLANE_DATA_FOR_CURRENT = 5,
+ NEW_VALUE_ON_BOTH = 6,
+ SKIP_CURRENT = 7
+ };
+
+ /**
+ * @brief Print options to fix system VPD.
+ * @param[in] option - Option to use.
+ */
+ void printFixSystemVPDOption(UserOption option);
+
public:
/**
* @brief Dump the complete inventory in JSON format
@@ -199,6 +233,16 @@
void readKwFromHw(const uint32_t& startOffset);
/**
+ * @brief Fix System VPD keyword.
+ * This API provides an interactive way to fix system VPD keywords that are
+ * part of restorable record-keyword pairs. The user can use this option to
+ * restore the restorable keywords in cache or in hardware or in both cache
+ * and hardware.
+ * @return returncode (success/failure).
+ */
+ int fixSystemVPD();
+
+ /**
* @brief Constructor
* Constructor is called during the
* object instantiation for dumpInventory option and