1 /**
2  * Copyright © 2019 IBM Corporation
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *     http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 #include "pel_values.hpp"
17 
18 #include <algorithm>
19 #include <cassert>
20 
21 namespace openpower
22 {
23 namespace pels
24 {
25 namespace pel_values
26 {
27 
28 /**
29  * The possible values for the subsystem field  in the User Header.
30  */
31 const PELValues subsystemValues = {
32     {0x10, "processor", "Processor"},
33     {0x11, "processor_fru", "Processor FRU"},
34     {0x12, "processor_chip", "Processor Chip Cache"},
35     {0x13, "processor_unit", "Processor Unit (CPU)"},
36     {0x14, "processor_bus", "Processor Bus Controller"},
37 
38     {0x20, "memory", "Memory"},
39     {0x21, "memory_ctlr", "Memory Controller"},
40     {0x22, "memory_bus", "Memory Bus Interface"},
41     {0x23, "memory_dimm", "Memory DIMM"},
42     {0x24, "memory_fru", "Memory Card/FRU"},
43     {0x25, "external_cache", "External Cache"},
44 
45     {0x30, "io", "I/O"},
46     {0x31, "io_hub", "I/O Hub"},
47     {0x32, "io_bridge", "I/O Bridge"},
48     {0x33, "io_bus", "I/O bus interface"},
49     {0x34, "io_processor", "I/O Processor"},
50     {0x35, "io_hub_other", "SMA Hub"},
51     {0x38, "phb", "PCI Bridge Chip"},
52 
53     {0x40, "io_adapter", "I/O Adapter"},
54     {0x41, "io_adapter_comm", "I/O Adapter Communication"},
55     {0x46, "io_device", "I/O Device"},
56     {0x47, "io_device_dasd", "I/O Device Disk"},
57     {0x4C, "io_external_general", "I/O External Peripheral"},
58     {0x4D, "io_external_workstation",
59      "I/O External Peripheral Local Work Station"},
60     {0x4E, "io_storage_mezz", "I/O Storage Mezza Expansion"},
61 
62     {0x50, "cec_hardware", "CEC Hardware"},
63     {0x51, "cec_sp_a", "CEC Hardware - Service Processor A"},
64     {0x52, "cec_sp_b", "CEC Hardware - Service Processor B"},
65     {0x53, "cec_node_controller", "CEC Hardware - Node Controller"},
66     {0x55, "cec_vpd", "CEC Hardware - VPD Interface"},
67     {0x56, "cec_i2c", "CEC Hardware - I2C Devices"},
68     {0x57, "cec_chip_iface", "CEC Hardware - CEC Chip Interface"},
69     {0x58, "cec_clocks", "CEC Hardware - Clock"},
70     {0x59, "cec_op_panel", "CEC Hardware - Operator Panel"},
71     {0x5A, "cec_tod", "CEC Hardware - Time-Of-Day Hardware"},
72     {0x5B, "cec_storage_device", "CEC Hardware - Memory Device"},
73     {0x5C, "cec_sp_hyp_iface",
74      "CEC Hardware - Hypervisor<->Service Processor Interface"},
75     {0x5D, "cec_service_network", "CEC Hardware - Service Network"},
76     {0x5E, "cec_sp_hostboot_iface",
77      "CEC Hardware - Hostboot-Service Processor Interface"},
78 
79     {0x60, "power", "Power/Cooling"},
80     {0x61, "power_supply", "Power Supply"},
81     {0x62, "power_control_hw", "Power Control Hardware"},
82     {0x63, "power_fans", "Fan (AMD)"},
83     {0x64, "power_sequencer", "Digital Power Supply"},
84 
85     {0x70, "others", "Miscellaneous"},
86     {0x71, "other_hmc", "HMC & Hardware"},
87     {0x72, "other_test_tool", "Test Tool"},
88     {0x73, "other_media", "Removable Media"},
89     {0x74, "other_multiple_subsystems", "Multiple Subsystems"},
90     {0x75, "other_na", "Not Applicable"},
91     {0x76, "other_info_src", "Miscellaneous"},
92 
93     {0x7A, "surv_hyp_lost_sp",
94      "Hypervisor lost communication with service processor"},
95     {0x7B, "surv_sp_lost_hyp",
96      "Service processor lost communication with Hypervisor"},
97     {0x7C, "surv_sp_lost_hmc", "Service processor lost communication with HMC"},
98     {0x7D, "surv_hmc_lost_lpar",
99      "HMC lost communication with logical partition"},
100     {0x7E, "surv_hmc_lost_bpa", "HMC lost communication with BPA"},
101     {0x7F, "surv_hmc_lost_hmc", "HMC lost communication with another HMC"},
102 
103     {0x80, "platform_firmware", "Platform Firmware"},
104     {0x81, "sp_firmware", "Service Processor Firmware"},
105     {0x82, "hyp_firmware", "System Hypervisor Firmware"},
106     {0x83, "partition_firmware", "Partition Firmware"},
107     {0x84, "slic_firmware", "SLIC Firmware"},
108     {0x85, "spcn_firmware", "System Power Control Network Firmware"},
109     {0x86, "bulk_power_firmware_side_a", "Bulk Power Firmware Side A"},
110     {0x87, "hmc_code_firmware", "HMC Code"},
111     {0x88, "bulk_power_firmware_side_b", "Bulk Power Firmware Side B"},
112     {0x89, "virtual_sp", "Virtual Service Processor Firmware"},
113     {0x8A, "hostboot", "HostBoot"},
114     {0x8B, "occ", "OCC"},
115     {0x8D, "bmc_firmware", "BMC Firmware"},
116 
117     {0x90, "software", "Software"},
118     {0x91, "os_software", "Operating System software"},
119     {0x92, "xpf_software", "XPF software"},
120     {0x93, "app_software", "Application software"},
121 
122     {0xA0, "ext_env", "External Environment"},
123     {0xA1, "input_power_source", "Input Power Source (ac)"},
124     {0xA2, "ambient_temp", "Room Ambient Temperature"},
125     {0xA3, "user_error", "User Error"},
126     {0xA4, "corrosion", "Corrosion"}};
127 
128 /**
129  * The possible values for the severity field in the User Header.
130  */
131 const PELValues severityValues = {
132     {0x00, "non_error", "Informational Event"},
133 
134     {0x10, "recovered", "Recovered Error"},
135     {0x20, "predictive", "Predictive Error"},
136     {0x21, "predictive_degraded_perf",
137      "Predictive Error, Degraded Performance"},
138     {0x22, "predictive_reboot", "Predictive Error, Correctable"},
139     {0x23, "predictive_reboot_degraded",
140      "Predictive Error, Correctable, Degraded"},
141     {0x24, "predictive_redundancy_loss", "Predictive Error, Redundancy Lost"},
142 
143     {0x40, "unrecoverable", "Unrecoverable Error"},
144     {0x41, "unrecoverable_degraded_perf",
145      "Unrecoverable Error, Degraded Performance"},
146     {0x44, "unrecoverable_redundancy_loss",
147      "Unrecoverable Error, Loss of Redundancy"},
148     {0x45, "unrecoverable_redundancy_loss_perf",
149      "Unrecoverable, Loss of Redundancy + Performance"},
150     {0x48, "unrecoverable_loss_of_function",
151      "Unrecoverable Error, Loss of Function"},
152 
153     {0x50, "critical", "Critical Error, Scope of Failure unknown"},
154     {0x51, "critical_system_term", "Critical Error, System Termination"},
155     {0x52, "critical_imminent_failure",
156      "Critical Error, System Failure likely or imminent"},
157     {0x53, "critical_partition_term",
158      "Critical Error, Partition(s) Termination"},
159     {0x54, "critical_partition_imminent_failure",
160      "Critical Error, Partition(s) Failure likely or imminent"},
161 
162     {0x60, "diagnostic_error", "Error detected during diagnostic test"},
163     {0x61, "diagnostic_error_incorrect_results",
164      "Diagostic error, resource w/incorrect results"},
165 
166     {0x71, "symptom_recovered", "Symptom Recovered"},
167     {0x72, "symptom_predictive", "Symptom Predictive"},
168     {0x74, "symptom_unrecoverable", "Symptom Unrecoverable"},
169     {0x75, "symptom_critical", "Symptom Critical"},
170     {0x76, "symptom_diag_err", "Symptom Diag Err"}};
171 
172 /**
173  * The possible values for the Event Type field in the User Header.
174  */
175 const PELValues eventTypeValues = {
176     {0x00, "na", "Not Applicable"},
177     {0x01, "misc_information_only", "Miscellaneous, Informational Only"},
178     {0x02, "tracing_event", "Tracing Event"},
179     {0x08, "dump_notification", "Dump Notification"},
180     {0x30, "env_normal", "Customer environmental problem back to normal"}};
181 
182 /**
183  * The possible values for the Event Scope field in the User Header.
184  */
185 const PELValues eventScopeValues = {
186     {0x01, "single_partition", "Single Partition"},
187     {0x02, "multiple_partitions", "Multiple Partitions"},
188     {0x03, "entire_platform", "Entire Platform"},
189     {0x04, "possibly_multiple_platforms", "Multiple Platforms"}};
190 
191 /**
192  * The possible values for the Action Flags field in the User Header.
193  */
194 const PELValues actionFlagsValues = {
195     {0x8000, "service_action", "Service Action Required"},
196     {0x4000, "hidden", "Event not customer viewable"},
197     {0x2000, "report", "Report Externally"},
198     {0x1000, "dont_report", "Do Not Report To Hypervisor"},
199     {0x0800, "call_home", "HMC Call Home"},
200     {0x0400, "isolation_incomplete",
201      "Isolation Incomplete, further analysis required"},
202     {0x0100, "termination", "Service Processor Call Home Required"},
203     {0x0020, "heartbeat_call_home", "Heartbeat Call Home Event"}};
204 
205 /**
206  * The possible values for the Callout Priority field in the SRC.
207  */
208 const PELValues calloutPriorityValues = {
209     {0x48, "high", "Mandatory, replace all with this type as a unit"},
210     {0x4D, "medium", "Medium Priority"},
211     {0x41, "medium_group_a", "Medium Priority A, replace these as a group"},
212     {0x42, "medium_group_b", "Medium Priority B, replace these as a group"},
213     {0x43, "medium_group_c", "Medium Priority C, replace these as a group"},
214     {0x4C, "low", "Lowest priority replacement"}};
215 
216 /**
217  * @brief Map of the registry names for the maintenance procedures
218  *        to their actual names.
219  */
220 const std::map<std::string, std::string> maintenanceProcedures = {
221     {"bmc_code", "BMC0001"},
222     // Isolation not possible, please contact your next level of support
223     {"next_level_support", "BMC0002"},
224     // Problem is in SBE code, upgrade your firmware
225     {"sbe_code", "BMC0003"},
226     // Problem is somewhere in the FSI bus path
227     {"fsi_path", "BMC0004"},
228     // Problem is over-current PSU fault
229     {"power_overcurrent", "BMC0005"},
230     // An unrecoverable event occurred, look for previous errors for the cause
231     {"find_sue_root_cause", "BMC0006"},
232     // Correct system backplane VPD mismatch
233     {"system_vpd_correction", "BMC0007"},
234     // service reminder about the failed parts present in the system
235     {"detected_issue_need_service", "BMC0008"},
236 };
237 
238 /**
239  * @brief Map of the registry names for the symbolic FRUs to their
240  *        actual names.
241  */
242 const std::map<std::string, std::string> symbolicFRUs = {
243     {"service_docs", "SVCDOCS"},      {"pwrsply", "PWRSPLY"},
244     {"air_mover", "AIRMOVR"},         {"pgood_part", "PGDPART"},
245     {"usb_pgood", "USBPGD"},          {"ambient_temp", "AMBTEMP"},
246     {"ambient_temp_back", "AMBBACK"}, {"ambient_perf_loss", "AMBPERF"},
247     {"ac_module", "ACMODUL"},         {"fan_cable", "FANCBL"},
248     {"cable_continued", "CBLCONT"},   {"altitude", "ALTTUDE"},
249     {"pcie_hot_plug", "PCIEHP"},      {"overtemp", "OVERTMP"},
250     {"memory_dimm", "MEMDIMM"}};
251 
findByValue(uint32_t value,const PELValues & fields)252 PELValues::const_iterator findByValue(uint32_t value, const PELValues& fields)
253 {
254     return std::find_if(fields.begin(), fields.end(),
255                         [value](const auto& entry) {
256                             return value == std::get<fieldValuePos>(entry);
257                         });
258 }
259 
findByName(const std::string & name,const PELValues & fields)260 PELValues::const_iterator findByName(const std::string& name,
261                                      const PELValues& fields)
262 
263 {
264     return std::find_if(fields.begin(), fields.end(),
265                         [&name](const auto& entry) {
266                             return name == std::get<registryNamePos>(entry);
267                         });
268 }
269 
270 /**
271  * @brief Map for section IDs
272  */
273 const std::map<std::string, std::string> sectionTitles = {
274     {"PH", "Private Header"},
275     {"UH", "User Header"},
276     {"PS", "Primary SRC"},
277     {"SS", "Secondary SRC"},
278     {"EH", "Extended User Header"},
279     {"MT", "Failing MTMS"},
280     {"DH", "Dump Location"},
281     {"SW", "Firmware Error"},
282     {"LP", "Impacted Partition"},
283     {"LR", "Logical Resource"},
284     {"HM", "HMC ID"},
285     {"EP", "EPOW"},
286     {"IE", "IO Event"},
287     {"MI", "MFG Info"},
288     {"CH", "Call Home"},
289     {"UD", "User Data"},
290     {"EI", "Env Info"},
291     {"ED", "Extended User Data"}};
292 
293 /**
294  * @brief Map for Procedure Descriptions
295  */
296 const std::map<std::string, std::string> procedureDesc = {{"TODO", "TODO"}};
297 
298 /**
299  * @brief Map for Callout Failing Component Types
300  */
301 const std::map<uint8_t, std::string> failingComponentType = {
302     {0x10, "Normal Hardware FRU"},
303     {0x20, "Code FRU"},
304     {0x30, "Configuration error, configuration procedure required"},
305     {0x40, "Maintenance Procedure Required"},
306     {0x90, "External FRU"},
307     {0xA0, "External Code FRU"},
308     {0xB0, "Tool FRU"},
309     {0xC0, "Symbolic FRU"},
310     {0xE0, "Symbolic FRU with trusted location code"}};
311 
312 /**
313  * @brief Map for Boolean value
314  */
315 const std::map<bool, std::string> boolString = {{true, "True"},
316                                                 {false, "False"}};
317 
318 /**
319  * @brief Map for creator IDs
320  */
321 const std::map<std::string, std::string> creatorIDs = {
322 
323     {"O", "BMC"},      {"C", "HMC"},      {"H", "PHYP"}, {"L", "Partition FW"},
324     {"S", "SLIC"},     {"B", "Hostboot"}, {"T", "OCC"},  {"M", "I/O Drawer"},
325     {"K", "Sapphire"}, {"P", "PowerNV"}};
326 
327 /**
328  * @brief Map for transmission states
329  */
330 const std::map<TransmissionState, std::string> transmissionStates = {
331     {TransmissionState::newPEL, "Not Sent"},
332     {TransmissionState::badPEL, "Rejected"},
333     {TransmissionState::sent, "Sent"},
334     {TransmissionState::acked, "Acked"}};
335 
getValue(const uint8_t field,const pel_values::PELValues & values,const uint8_t position)336 std::string getValue(const uint8_t field, const pel_values::PELValues& values,
337                      const uint8_t position)
338 {
339     auto tmp = pel_values::findByValue(field, values);
340     if (tmp != values.end())
341     {
342         if (position == pel_values::registryNamePos)
343         {
344             return std::get<pel_values::registryNamePos>(*tmp);
345         }
346         else
347         {
348             return std::get<pel_values::descriptionPos>(*tmp);
349         }
350     }
351     else
352     {
353         return "invalid";
354     }
355 }
356 
getValuesBitwise(uint16_t value,const pel_values::PELValues & table)357 std::vector<std::string> getValuesBitwise(uint16_t value,
358                                           const pel_values::PELValues& table)
359 {
360     std::vector<std::string> foundValues;
361     std::for_each(
362         table.begin(), table.end(), [&value, &foundValues](const auto& entry) {
363             if (value & std::get<fieldValuePos>(entry))
364             {
365                 foundValues.push_back(std::get<descriptionPos>(entry));
366             }
367         });
368     return foundValues;
369 }
370 
371 } // namespace pel_values
372 } // namespace pels
373 } // namespace openpower
374