/* IBM_PROLOG_BEGIN_TAG                                                   */
/* This is an automatically generated prolog.                             */
/*                                                                        */
/* $Source: src/usr/hwpf/hwp/sbe_centaur_init/cen_xip_customize.H $       */
/*                                                                        */
/* OpenPOWER HostBoot Project                                             */
/*                                                                        */
/* COPYRIGHT International Business Machines Corp. 2013,2014              */
/*                                                                        */
/* 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                                                     */
// $Id: cen_xip_customize.H,v 1.1 2013/01/24 14:07:39 cmolsen Exp $

#include <fapi.H>

typedef fapi::ReturnCode (*cen_xip_customize_FP_t) (	const fapi::Target&, 
																					    			void*,
																										void*,
																							    	uint32_t&,
																										void*,
																										const uint32_t,
																										void*,
																								    const uint32_t );

extern "C"
{

//
// Function declares.
//

	// Description: 
	// FAPI HWP entry point for cen_xip_customize().
	// cen_xip_customize() customizes the Centaur image.
	//
	// Parameters:  
	// fapi::Target &i_target:        Processor chip target.
  // void         *i_imageIn:       Ptr to input IPL or SLW image.
  // void         *i_imageOut:      Ptr to output IPL img. (Ignored for SLW/RAM imgs.)
  // uint32_t     &io_sizeImageOut: In: Max size of IPL/SRAM img. Out: Final size.
  // void         *i_buf1:          Temp buffer1 for dexed RS4 ring. Caller allocs/frees.
  // uint32_t     i_sizeBuf1:       Size of buf1.
  // void         *i_buf2:          Temp buffer2 for WF ring. Caller allocs/frees.
  // uint32_t     i_sizeBuf22       Size of buf2.
	fapi::ReturnCode cen_xip_customize( const fapi::Target &i_target,
                                     void  *i_imageIn,
														         void  *i_imageOut,
																		 uint32_t    &io_sizeImageOut,
																		 void  *i_buf1,
																		 const uint32_t    i_sizeBuf1,
																		 void  *i_buf2,
																		 const uint32_t    i_sizeBuf2 );
}