Adding support for TOD RAS on FSP systems

Moved the TOD files from directory /hostboot/src/usr/isteps/istep18
into a new TOD directory - /hostboot/src/usr/isteps/tod.  Created a tod
library from the files within the new TOD directory.  Added a runtime
directory underneath the tod directory.  Created the rt_todintf.C file
which contains the two newly added interfaces -
readTodProcDataFromFile and resetBackupTopology.

Change-Id: I68c9edcd8f59adf9a2cf1f1f3fff07fea2d94e99
RTC:171490
Reviewed-on: http://ralgit01.raleigh.ibm.com/gerrit1/48188
Tested-by: Jenkins Server <pfd-jenkins+hostboot@us.ibm.com>
Reviewed-by: Christian R. Geddes <crgeddes@us.ibm.com>
Tested-by: Jenkins OP Build CI <op-jenkins+hostboot@us.ibm.com>
Tested-by: Jenkins OP HW <op-hw-jenkins+hostboot@us.ibm.com>
Tested-by: FSP CI Jenkins <fsp-CI-jenkins+hostboot@us.ibm.com>
Reviewed-by: Daniel M. Crowell <dcrowell@us.ibm.com>

1 files changed, 77 insertions, 0 deletions

diff --git a/src/include/usr/isteps/tod/runtime/rt_todintf.H b/src/include/usr/isteps/tod/runtime/rt_todintf.H
new file mode 100644
index 000000000..b79e24c1c
--- /dev/null
+++ b/src/include/usr/isteps/tod/runtime/rt_todintf.H
@@ -0,0 +1,77 @@
+/* IBM_PROLOG_BEGIN_TAG                                                   */
+/* This is an automatically generated prolog.                             */
+/*                                                                        */
+/* $Source: src/include/usr/isteps/tod/runtime/rt_todintf.H $             */
+/*                                                                        */
+/* OpenPOWER HostBoot Project                                             */
+/*                                                                        */
+/* Contributors Listed Below - COPYRIGHT 2014,2017                        */
+/* [+] International Business Machines Corp.                              */
+/*                                                                        */
+/*                                                                        */
+/* Licensed under the Apache License, Version 2.0 (the "License");        */
+/* you may not use this file except in compliance with the License.       */
+/* You may obtain a copy of the License at                                */
+/*                                                                        */
+/*     http://www.apache.org/licenses/LICENSE-2.0                         */
+/*                                                                        */
+/* Unless required by applicable law or agreed to in writing, software    */
+/* distributed under the License is distributed on an "AS IS" BASIS,      */
+/* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or        */
+/* implied. See the License for the specific language governing           */
+/* permissions and limitations under the License.                         */
+/*                                                                        */
+/* IBM_PROLOG_END_TAG                                                     */
+#ifndef __RUNTIME__TOD_INTERFACE_H
+#define __RUNTIME__TOD_INTERFACE_H
+
+#include <errl/errlentry.H>           // errlHndl_t
+#include <targeting/common/target.H>  // TARGETING::TargetHandleList
+#include <isteps/tod/TodTypes.H>      // TodChipDataContainer
+
+/**
+ *  @file rt_todintf.H
+ *
+ *  @brief TOD FSP interfaces
+ *
+ *
+ */
+
+namespace TOD
+{
+
+/**
+ *  @brief This interface creates a new backup TOD topology.  This request
+ *         is sent to the FSP for resetting the backup topology.
+ *
+ *  @param[in] i_oscPos the ordinal ID of the failing OSC.  Value of
+ *             0xFFFFFFFF means no OSC to avoid.
+ *  @param[in] i_procOscTgt target of the processor with which the failing OSC
+ *             is associated with. If ordinal ID is 0xFFFFFFFF then this should
+ *             be NULL, otherwise provide a valid target. If ordinal ID is
+ *             0xFFFFFFFF, i_procOscTgt is ignored regardless of it's validity.
+ *  @param[in] i_badChipList input list of targets.
+ *  @param[in] i_informPhyp flag to inform the PHYP that it won't have a
+ *             backup available for fail over while we are re-configuring it.
+ *
+ *  @return Error log handle indicating the status of the request
+ */
+errlHndl_t resetBackupTopology(
+                              uint32_t i_oscPos,
+                              const TARGETING::TargetHandle_t& i_procOscTgt,
+                              const TARGETING::TargetHandleList& i_badChipList,
+                              bool i_informPhyp);
+
+/**
+ *  @brief This interface returns the TOD topology data for analysis
+ *
+ *  @param[out] o_todChipData container that holds the processor data
+ *
+ *  @return Error log handle indicating the status of the request
+ */
+errlHndl_t readTodProcDataFromFile(TodChipDataContainer& o_todChipData);
+
+}  // end namespace TOD
+
+#endif   // end __RUNTIME__TOD_INTERFACE_H
+