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: Icfb91ea78853c725bff695dc12103df161a33b26
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/22089
Tested-by: Jenkins Server
Reviewed-by: Sachin Gupta <sgupta2m@in.ibm.com>

1 files changed, 60 insertions, 0 deletions

diff --git a/import/chips/p9/procedures/hwp/cache/p9_hcd_cache_poweron.H b/import/chips/p9/procedures/hwp/cache/p9_hcd_cache_poweron.H
new file mode 100644
index 00000000..a103836c
--- /dev/null
+++ b/import/chips/p9/procedures/hwp/cache/p9_hcd_cache_poweron.H
@@ -0,0 +1,60 @@
+/* IBM_PROLOG_BEGIN_TAG                                                   */
+/* This is an automatically generated prolog.                             */
+/*                                                                        */
+/* $Source: chips/p9/procedures/hwp/cache/p9_hcd_cache_poweron.H $        */
+/*                                                                        */
+/* 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_hcd_cache_poweron.H
+/// @brief Cache Chiplet Power-on
+///
+/// *HWP HWP Owner   : David Du       <daviddu@us.ibm.com>
+/// *HWP FW Owner    : Sangeetha T S  <sangeet2@in.ibm.com>
+/// *HWP Team        : PM
+/// *HWP Consumed by : SBE:SGPE
+/// *HWP Level       : 1
+///
+
+#ifndef __P9_HCD_CACHE_POWERON_H__
+#define __P9_HCD_CACHE_POWERON_H__
+
+extern "C"
+{
+
+/// @typedef p9_hcd_cache_poweron_FP_t
+/// function pointer typedef definition for HWP call support
+    typedef fapi2::ReturnCode (*p9_hcd_cache_poweron_FP_t) (
+        const fapi2::Target<fapi2::TARGET_TYPE_EQ>&,
+        const uint32_t);
+
+
+/// @brief Cache Chiplet Power-on
+///
+/// @param [in] i_target    TARGET_TYPE_EQ target
+/// @param [in] i_operation ENUM(ON,OFF)
+///
+/// @attr
+/// @attritem ATTR_PFET_*
+///
+/// @retval FAPI_RC_SUCCESS
+    fapi2::ReturnCode
+    p9_hcd_cache_poweron(
+        const fapi2::Target<fapi2::TARGET_TYPE_EQ>& i_target,
+        const uint32_t i_operation);
+
+
+} // extern C
+
+#endif  // __P9_HCD_CACHE_POWERON_H__