PPE-HWP: [Level 1] Cache + Core Hcode Procedures with API and Attribute defined

Patch 6 Update:
  FW owner email address fix

Patch 5 Update:
  target types fixed, all compiles now.
    (Will rework them when multicast target is ready in Fapi2)
  add @brief to function doxygen
  add FW Owners to all headers
  typo fixes
  Note: NOT fixed with this update or this level 1 release but was commented:
    1) still need a solution for document attributes in doxygen headers.
    2) All traces in procedures including entry/exit are going to be
       finalized in future releases as the function body development
       reaches next maturity. There will be more discussion
       in-term/inter-term on how to do tracing overall on these procs,
       dont want to block this release because of it.

Patch 3 Update:
  addressed comments from Patch 2 review.
  merged p9_hcd_cache/core_sp_runtime_scom and p9_hcd_cache/core_host_runtime_scom
  into p9_hcd_cache/core_ras_runtime_scom based on changes in P9_IPL_Flow.doc(v55)

Patch 2 Update:
  renamed proc_* to p9_* for all procedure filenames per comment in Patch 1

Note:
1) Due to ongoing interface discussion and resolution, some of these procedures
   are not yet ready for building under Cronus. Regular Fapi2 build is ready.
   If you see some of Fapi2 Target Types in these procedures are not in Fapi2 yet,
   that is because they are currently in discussion of addition to Fapi2.
2) There are ongoing function body development in the code, which are all
   "#if 0" out in this level 1 release. The effective code in all files are
   only the API prototypes. Please focus your review only to the interfaces.
3) cache/core runinit is for SGPE and CME at runtime only, not for IPL or SBE.
4) common_pro_epi_log and common_poweronoff are subroutine support(not in IPL_Flow)

Change-Id: Ic8e10960edc14dd15b350d9e367f79c052cf555a
Original-Change-Id: I46f07bb3e7cf050256c123e7f16982ccead2ceda
Reviewed-on: http://gfw160.aus.stglabs.ibm.com:8080/gerrit/17193
Reviewed-by: Reshmi Nair <reshminair@in.ibm.com>
Reviewed-by: Sangeetha T S <sangeet2@in.ibm.com>
Reviewed-by: Gregory S. Still <stillgs@us.ibm.com>
Reviewed-by: Brian Silver <bsilver@us.ibm.com>
Tested-by: Brian Silver <bsilver@us.ibm.com>
Reviewed-on: http://gfw160.aus.stglabs.ibm.com:8080/gerrit/21813
Tested-by: Jenkins Server
Reviewed-by: Amit J. Tendolkar <amit.tendolkar@in.ibm.com>

1 files changed, 64 insertions, 0 deletions

diff --git a/import/chips/p9/procedures/hwp/lib/p9_common_pro_epi_log.C b/import/chips/p9/procedures/hwp/lib/p9_common_pro_epi_log.C
new file mode 100644
index 00000000..d6e31b38
--- /dev/null
+++ b/import/chips/p9/procedures/hwp/lib/p9_common_pro_epi_log.C
@@ -0,0 +1,64 @@
+/* IBM_PROLOG_BEGIN_TAG                                                   */
+/* This is an automatically generated prolog.                             */
+/*                                                                        */
+/* $Source: chips/p9/procedures/hwp/lib/p9_common_pro_epi_log.C $         */
+/*                                                                        */
+/* IBM CONFIDENTIAL                                                       */
+/*                                                                        */
+/* EKB Project                                                            */
+/*                                                                        */
+/* COPYRIGHT 2015                                                         */
+/* [+] International Business Machines Corp.                              */
+/*                                                                        */
+/*                                                                        */
+/* The source code for this program is not published or otherwise         */
+/* divested of its trade secrets, irrespective of what has been           */
+/* deposited with the U.S. Copyright Office.                              */
+/*                                                                        */
+/* IBM_PROLOG_END_TAG                                                     */
+///
+/// @file  p9_common_pro_epi_log.C
+/// @brief common procedure prologue/epilogue routines
+///
+/// *HWP HWP Owner   : David Du      <daviddu@us.ibm.com>
+/// *HWP FW Owner    : Reshmi Nair   <resnair5@in.ibm.com>
+/// *HWP Team        : PM
+/// *HWP Consumed by : SBE:SGPE
+/// *HWP Level       : 1
+///
+/// Procedure Summary:
+///
+
+//------------------------------------------------------------------------------
+// Includes
+//------------------------------------------------------------------------------
+#include <fapi2.H>
+//#include <common_scom_addresses.H>
+//will be replaced with real scom address header file
+#include "p9_common_pro_epi_log.H"
+
+//------------------------------------------------------------------------------
+// Constant Definitions:
+//------------------------------------------------------------------------------
+
+//------------------------------------------------------------------------------
+// Procedure:
+//------------------------------------------------------------------------------
+
+extern "C"
+{
+
+    fapi2::ReturnCode
+    p9_common_pro_epi_log(
+        const fapi2::Target < fapi2::TARGET_TYPE_EQ |
+        fapi2::TARGET_TYPE_CORE > & i_target,
+        int i_operation)
+    {
+        return fapi2::FAPI2_RC_SUCCESS;
+
+    } // Procedure
+
+
+} // extern C
+
+