blob: e6e7c03d7b5aa45e96d0ed65b400659defd14adc [file] [log] [blame]
Frank Vibrans2b4c8312011-02-14 18:30:54 +00001/* $NoKeywords:$ */
2/**
3 * @file
4 *
5 * Service procedure to access heap.
6 *
7 *
8 *
9 * @xrefitem bom "File Content Label" "Release Content"
10 * @e project: AGESA
11 * @e sub-project: GNB
12 * @e \$Revision: 34897 $ @e \$Date: 2010-07-13 19:07:10 -0700 (Tue, 13 Jul 2010) $
13 *
14 */
15/*
16 *****************************************************************************
17 *
18 * Copyright (c) 2011, Advanced Micro Devices, Inc.
19 * All rights reserved.
Edward O'Callaghan1542a6f2014-07-06 19:24:06 +100020 *
Frank Vibrans2b4c8312011-02-14 18:30:54 +000021 * Redistribution and use in source and binary forms, with or without
22 * modification, are permitted provided that the following conditions are met:
23 * * Redistributions of source code must retain the above copyright
24 * notice, this list of conditions and the following disclaimer.
25 * * Redistributions in binary form must reproduce the above copyright
26 * notice, this list of conditions and the following disclaimer in the
27 * documentation and/or other materials provided with the distribution.
Edward O'Callaghan1542a6f2014-07-06 19:24:06 +100028 * * Neither the name of Advanced Micro Devices, Inc. nor the names of
29 * its contributors may be used to endorse or promote products derived
Frank Vibrans2b4c8312011-02-14 18:30:54 +000030 * from this software without specific prior written permission.
Edward O'Callaghan1542a6f2014-07-06 19:24:06 +100031 *
Frank Vibrans2b4c8312011-02-14 18:30:54 +000032 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
33 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
34 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
35 * DISCLAIMED. IN NO EVENT SHALL ADVANCED MICRO DEVICES, INC. BE LIABLE FOR ANY
36 * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
37 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
38 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
39 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
40 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
41 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Edward O'Callaghan1542a6f2014-07-06 19:24:06 +100042 *
Frank Vibrans2b4c8312011-02-14 18:30:54 +000043 * ***************************************************************************
44 *
45 */
46
47/*----------------------------------------------------------------------------------------
48 * M O D U L E S U S E D
49 *----------------------------------------------------------------------------------------
50 */
51#include "Porting.h"
52#include "AMD.h"
53#include "heapManager.h"
54#include "GnbLibPciAcc.h"
efdesign9884cbce22011-08-04 12:09:17 -060055#include "GnbLibHeap.h"
Frank Vibrans2b4c8312011-02-14 18:30:54 +000056#include "Filecode.h"
57#define FILECODE PROC_GNB_MODULES_GNBCOMMONLIB_GNBLIBHEAP_FILECODE
58/*----------------------------------------------------------------------------------------
59 * D E F I N I T I O N S A N D M A C R O S
60 *----------------------------------------------------------------------------------------
61 */
62
63
64/*----------------------------------------------------------------------------------------
65 * T Y P E D E F S A N D S T R U C T U R E S
66 *----------------------------------------------------------------------------------------
67 */
68
69
70/*---------------------------------------------------------------------------------------*/
71/**
72 * Allocates space for a new buffer in the heap
73 *
74 *
75 * @param[in] Handle Buffer handle
76 * @param[in] Length Buffer length
77 * @param[in] StdHeader Standard configuration header
78 *
79 * @retval NULL Buffer allocation fail
80 *
81 */
82
83VOID*
84GnbAllocateHeapBuffer (
85 IN UINT32 Handle,
86 IN UINTN Length,
87 IN AMD_CONFIG_PARAMS *StdHeader
88 )
89{
90 AGESA_STATUS Status;
91 ALLOCATE_HEAP_PARAMS AllocHeapParams;
92
93 AllocHeapParams.RequestedBufferSize = (UINT32) Length;
94 AllocHeapParams.BufferHandle = Handle;
95 AllocHeapParams.Persist = HEAP_SYSTEM_MEM;
96 Status = HeapAllocateBuffer (&AllocHeapParams, StdHeader);
97 if (Status != AGESA_SUCCESS) {
98 return NULL;
99 }
100 return AllocHeapParams.BufferPtr;
101}
102
103/*---------------------------------------------------------------------------------------*/
104/**
105 * Locates a previously allocated buffer on the heap.
106 *
107 *
108 * @param[in] Handle Buffer handle
109 * @param[in] StdHeader Standard configuration header
110 *
111 * @retval NULL Buffer handle not found
112 *
113 */
114
115VOID *
116GnbLocateHeapBuffer (
117 IN UINT32 Handle,
118 IN AMD_CONFIG_PARAMS *StdHeader
119 )
120{
121 AGESA_STATUS Status;
122 LOCATE_HEAP_PTR LocHeapParams;
123 LocHeapParams.BufferHandle = Handle;
124 Status = HeapLocateBuffer (&LocHeapParams, StdHeader);
125 if (Status != AGESA_SUCCESS) {
126 return NULL;
127 }
128 return LocHeapParams.BufferPtr;
129}
130