JET: Level 1, p9_pm_pba_init

Change-Id: Ib26e4f678a6c672ebeddb07906785c340b6dd48e
RTC: 137021
Reviewed-on: http://gfw160.aus.stglabs.ibm.com:8080/gerrit/21314
Tested-by: Jenkins Server
Reviewed-by: Bilicon Patil <bilpatil@in.ibm.com>
Reviewed-by: Jennifer A. Stofer <stofer@us.ibm.com>
Reviewed-on: http://gfw160.aus.stglabs.ibm.com:8080/gerrit/23837
Reviewed-by: Daniel M. Crowell <dcrowell@us.ibm.com>
Tested-by: Daniel M. Crowell <dcrowell@us.ibm.com>

1 files changed, 175 insertions, 0 deletions

diff --git a/src/import/chips/p9/procedures/hwp/pm/p9_pm_pba_init.H b/src/import/chips/p9/procedures/hwp/pm/p9_pm_pba_init.H
new file mode 100755
index 000000000..7f88c444f
--- /dev/null
+++ b/src/import/chips/p9/procedures/hwp/pm/p9_pm_pba_init.H
@@ -0,0 +1,175 @@
+/* IBM_PROLOG_BEGIN_TAG                                                   */
+/* This is an automatically generated prolog.                             */
+/*                                                                        */
+/* $Source: chips/p9/procedures/hwp/pm/p9_pm_pba_init.H $                 */
+/*                                                                        */
+/* IBM CONFIDENTIAL                                                       */
+/*                                                                        */
+/* EKB Project                                                            */
+/*                                                                        */
+/* COPYRIGHT 2015                                                         */
+/* [+] <                                                                  */
+/*                                                                        */
+/*                                                                        */
+/* 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_pm_pba_init.H
+/// @brief: Initialize PBA registers for modes PM_INIT, PM_RESET
+///
+// *HWP HWP Owner: Greg Still <stillgs@us.ibm.com>
+// *HWP FW Owner: Sangeetha T S <sangeet2@in.ibm.com>
+// *HWP Team: PM
+// *HWP Level: 1
+// *HWP Consumed by: HS
+//
+
+///
+///   @verbatim
+///
+///       high level flow:
+///           if {i_mode == PM_INIT)
+///               rc =  pba_init_init(i_target);
+///           else if (i_mode == PM_RESET)
+///               rc =  pba_init_reset(i_target);
+///   @endverbatim
+///
+
+#ifndef _P9_PBAINIT_H_
+#define _P9_PBAINIT_H_
+
+// ----------------------------------------------------------------------
+// Includes
+// ----------------------------------------------------------------------
+#include <fapi2.H>
+#include <p9_pm.H>
+
+// ----------------------------------------------------------------------
+// Constant Defintions
+// ----------------------------------------------------------------------
+namespace p9pba
+{
+// BCDE and BCUE Status registers bits
+enum PBA_BC_STAT
+{
+    PBA_BC_STAT_RUNNING = 0,
+    PBA_BC_STAT_STOPPED = 29,
+    PBA_BC_STAT_ERROR   = 30,
+    PBA_BC_STAT_DONE    = 31
+};
+
+// Valid command scope.
+enum CMD_SCOPE
+{
+    LOCAL_NODAL    = 0x00,
+    NEAR_NODE      = 0x02,
+    GROUP          = 0x03,
+    REMOTE_NODE    = 0x04,
+    VECTORED_GROUP = 0x5
+};
+
+// Maximum number of Polls for PBA slave reset
+enum PBA_SLAVE_POLL
+{
+    MAX_PBA_RESET_POLLS = 16 , // in microseconds
+    PBA_RESET_POLL_DELAY = 1
+};
+
+// Maximum number of Polls for PBA Block Copy Stopping - 500ms timeout
+enum PBA_BLOCK_COPY_POLL
+{
+    MAX_PBA_BC_STOP_POLLS = 256 ,        // in microseconds
+    PBA_BC_STOP_POLL_DELAY = 10
+};
+
+// structure of values for cmd_scope, pba and pbabar initialization
+struct pba_cmd_init
+{
+    CMD_SCOPE cmd_scope;
+    uint64_t  addr;
+    uint64_t  size;
+};
+
+struct pba_cmd_init_reg
+{
+    pba_cmd_init regs0;
+    pba_cmd_init regs1;
+    pba_cmd_init regs2;
+    pba_cmd_init regs3;
+};
+
+struct pba_bar_fields
+{
+    CMD_SCOPE cmd_scope;
+    uint8_t   reserved_1;
+    uint16_t  non_maskable_base_addr;
+    uint32_t  maskable_base_addr;
+    uint8_t   reserved_2;
+    uint16_t  vtarget;
+};
+
+struct pba_barmask_fields
+{
+    uint32_t reserved_1;
+    uint32_t mask;
+    uint32_t reserved_2;
+};
+
+struct pba_bar_init_type
+{
+    pba_bar_fields     bar_reg;
+    pba_barmask_fields barmsk_reg;
+};
+
+struct pba_bar_init_type_all
+{
+    pba_bar_init_type pba_bar0_init;
+    pba_bar_init_type pba_bar1_init;
+    pba_bar_init_type pba_bar2_init;
+    pba_bar_init_type pba_bar3_init;
+};
+
+typedef uint64_t pba_slvctl_type;
+
+struct pbax_config_fields
+{
+    uint32_t  reserved_0;
+    char      pm_pbax_pcv_reserv_timeout;
+    uint8_t   reserved_1;
+    char      pm_pbax_snd_retry_count_overcommit_enable;
+    uint8_t   pm_pbax_snd_retry_threshold;
+    uint8_t   pm_pbax_snd_reserv_timeout;
+    uint32_t  reserved_2;
+};
+} //namespace
+
+// function pointer typedef definition for HWP call support
+typedef fapi2::ReturnCode (*p9_pm_pba_init_FP_t)
+(const fapi2::Target<fapi2::TARGET_TYPE_PROC_CHIP>&,
+ const p9pm::PM_FLOW_MODE);
+
+extern "C" {
+
+// ----------------------------------------------------------------------
+// Function prototypes
+// ----------------------------------------------------------------------
+
+///
+/// @brief Set the pba registers depending on "mode"
+///
+/// @param[in] i_target Chip target
+/// @param[in] i_mode   Mode
+///
+/// @return FAPI2_RC_SUCCESS on success or error return code
+///
+    fapi2::ReturnCode p9_pm_pba_init
+    (const fapi2::Target<fapi2::TARGET_TYPE_PROC_CHIP>& i_target,
+     const p9pm::PM_FLOW_MODE i_mode);
+}
+
+#endif // _P9_PBAINIT_H_
+
+