diff options
author | Shakeeb <shakeebbk@in.ibm.com> | 2016-09-01 06:24:44 -0500 |
---|---|---|
committer | AMIT J. TENDOLKAR <amit.tendolkar@in.ibm.com> | 2016-09-01 07:48:28 -0400 |
commit | 5e83bcb5cf9d400739cfb2beaab1a3173e8cafb2 (patch) | |
tree | b3d6cd12b5eb0c92404ae5ac0352bb360b38fa95 /src/import/chips/p9/procedures/hwp/nest/p9_adu_access.H | |
parent | 1008ef70a71fcfdec398ff30923d5025991c85f4 (diff) | |
download | talos-sbe-5e83bcb5cf9d400739cfb2beaab1a3173e8cafb2.tar.gz talos-sbe-5e83bcb5cf9d400739cfb2beaab1a3173e8cafb2.zip |
SBE move import`
Change-Id: I726951318cdb19fd445af2f7910e0d6872eff18c
Reviewed-on: http://ralgit01.raleigh.ibm.com/gerrit1/29086
Tested-by: Jenkins Server <pfd-jenkins+hostboot@us.ibm.com>
Reviewed-by: Sachin Gupta <sgupta2m@in.ibm.com>
Reviewed-by: AMIT J. TENDOLKAR <amit.tendolkar@in.ibm.com>
Diffstat (limited to 'src/import/chips/p9/procedures/hwp/nest/p9_adu_access.H')
-rw-r--r-- | src/import/chips/p9/procedures/hwp/nest/p9_adu_access.H | 105 |
1 files changed, 105 insertions, 0 deletions
diff --git a/src/import/chips/p9/procedures/hwp/nest/p9_adu_access.H b/src/import/chips/p9/procedures/hwp/nest/p9_adu_access.H new file mode 100644 index 00000000..0b8e1a15 --- /dev/null +++ b/src/import/chips/p9/procedures/hwp/nest/p9_adu_access.H @@ -0,0 +1,105 @@ +/* IBM_PROLOG_BEGIN_TAG */ +/* This is an automatically generated prolog. */ +/* */ +/* $Source: import/chips/p9/procedures/hwp/nest/p9_adu_access.H $ */ +/* */ +/* OpenPOWER sbe Project */ +/* */ +/* Contributors Listed Below - COPYRIGHT 2015,2016 */ +/* [+] 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 */ +//----------------------------------------------------------------------------------- +// +/// @file p9_adu_access.H +/// @brief Read coherent state of memory via the ADU (FAPI) +/// +// *HWP HWP Owner: Christina Graves clgraves@us.ibm.com +// *HWP FW Owner: Thi Tran thi@us.ibm.com +// *HWP Team: Nest +// *HWP Level: 1 +// *HWP Consumed by: +// ---------------------------------------------------------------------------------- +// +// *! ADDITIONAL COMMENTS : +// *! +// *! The purpose of this procedure is to perform a coherent read from system +// *! memory via fabric commands issued from the ADU. +// *! +// *! Succcessful operation assumes that: +// *! o System clocks are running +// *! o Fabric is initalized +// *! +// *! +//----------------------------------------------------------------------------------- + +#ifndef _P9_ADU_ACCESS_H_ +#define _P9_ADU_ACCESS_H_ + +//----------------------------------------------------------------------------------- +// Includes +//----------------------------------------------------------------------------------- + +#include <fapi2.H> +#include <p9_adu_constants.H> +#include <p9_pba_constants.H> + +//----------------------------------------------------------------------------------- +// Structure definitions +//----------------------------------------------------------------------------------- + +//function pointer typedef definition for HWP call support +typedef fapi2::ReturnCode +(*p9_adu_access_FP_t) (const fapi2::Target<fapi2::TARGET_TYPE_PROC_CHIP>&, + const uint64_t, + const bool, + const uint32_t, + const bool, + const bool, + uint8_t[] ); + +//----------------------------------------------------------------------------------- +// Constant definitions +//----------------------------------------------------------------------------------- + +extern "C" { + +//----------------------------------------------------------------------------------- +// Function prototype +//----------------------------------------------------------------------------------- + +/// @brief do the actual read/write from the ADU +/// @param[in] i_target => P9 chip target +/// @param[in] i_address => base real address for read/write operation (expected to be 8B aligned) +/// @param[in] i_rnw => if the operation is a read not write (1 for read, 0 for write) +/// @param[in] i_flags => other information that is needed - see the p9_adu_constants adu_flags enums for bit definitions +// Note: To construct the flag you can use p9_ADU_oper_flag class +/// @param[in] i_lastGranule => if this is the last 8B of data that we are collecting (true = last granule, false = not last granule) +/// @param[in] i_firstGranule => if this is the first 8B of data that we are collecting (true = first granule, false = not first granule) +/// @param[in, out] io_data => The data is read/written +/// @return FAPI_RC_SUCCESS if the read/write completes successfully + fapi2::ReturnCode p9_adu_access( + const fapi2::Target<fapi2::TARGET_TYPE_PROC_CHIP>& i_target, + const uint64_t i_address, + const bool i_rnw, + const uint32_t i_flags, + const bool i_firstGranule, + const bool i_lastGranule, + uint8_t io_data[]); +} //extern "C" + +#endif //_P9_ADU_ACCESS_H_ + |