Framework Components Application Programming Interface (API)  fc-v07
iresman.h
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2012, Texas Instruments Incorporated
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  *
9  * * Redistributions of source code must retain the above copyright
10  * notice, this list of conditions and the following disclaimer.
11  *
12  * * Redistributions in binary form must reproduce the above copyright
13  * notice, this list of conditions and the following disclaimer in the
14  * documentation and/or other materials provided with the distribution.
15  *
16  * * Neither the name of Texas Instruments Incorporated nor the names of
17  * its contributors may be used to endorse or promote products derived
18  * from this software without specific prior written permission.
19  *
20  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
21  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
22  * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
23  * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
24  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
25  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
26  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
27  * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
28  * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
29  * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
30  * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
31  *
32  */
51 #ifndef ti_sdo_fc_ires_IRESMAN_
52 #define ti_sdo_fc_ires_IRESMAN_
53 
56 
57 #ifdef __cplusplus
58 extern "C" {
59 #endif
60 
61 #include <ti/xdais/ires_common.h>
62 #include <ti/xdais/ires.h>
63 
68 typedef Bool (IRESMAN_PersistentAllocFxn)(IALG_MemRec *memTab, Int numRecs);
69 
74 typedef Void (IRESMAN_PersistentFreeFxn)(IALG_MemRec *memTab, Int numRecs);
75 
76 
82 typedef struct IRESMAN_Params {
83  Int32 size;
90 
96 
98 
99 typedef struct IRESMAN_Fxns {
100 
104  String (*getProtocolName)();
105 
110  IRES_ProtocolRevision * (* getProtocolRevision)();
111 
123  IRES_Status (* init)(IRESMAN_Params * initArgs);
124 
133 
153  IRES_ResourceDescriptor * resDesc, Int scratchGroupId,
154  IRES_Status * status);
155 
167  IRES_Handle resourceHandle, IRES_ResourceDescriptor * resDesc,
168  Int scratchGroupId);
169 
170  /* Two new optional APIs */
171  Void (* activateResource)(IALG_Handle algHandle, IRES_Fxns * resFxns);
172 
173  Void (* deactivateResource)(IALG_Handle algHandle, IRES_Fxns * resFxns);
174 
175 } IRESMAN_Fxns;
176 
177 #ifdef __cplusplus
178 }
179 #endif
180 
183 #endif
String(* getProtocolName)()
Function to query the name of the protocol.
Definition: iresman.h:104
IRES_Status
IRES_Status defines the standard error and success codes returned by IRES APIs.
Definition: ires_common.h:57
Configuration Parameters required by the Resource Manager implementation. These can be extended by in...
Definition: iresman.h:82
Memory records.
Definition: ialg.h:142
IRESMAN_PersistentAllocFxn * allocFxn
Function to allocate memory required by the resource manager implementation and the protocol...
Definition: iresman.h:89
struct IRES_Obj * IRES_Handle
Handle to "logical" resource.
Definition: ires_common.h:196
Definition: iresman.h:99
IRES_Status(* exit)()
Function called when RESMAN is no longer needed. Use it to free memory allocated etc.
Definition: iresman.h:132
Protocol revision type. Used to ensure the given 'protocol' revision can be validated.
Definition: ires_common.h:73
Algorithm instance object definition.
Definition: ialg.h:159
IRES Resource Protocol Definitions - IRES Resource.
Int32 size
Definition: iresman.h:83
IRESMAN_PersistentFreeFxn * freeFxn
Function to free memory released by the resource manager implementation and the protocol.
Definition: iresman.h:95
IRES_Status(* freeHandle)(IALG_Handle algHandle, IRES_Handle resourceHandle, IRES_ResourceDescriptor *resDesc, Int scratchGroupId)
Frees handles back to the resource pool.
Definition: iresman.h:166
Bool( IRESMAN_PersistentAllocFxn)(IALG_MemRec *memTab, Int numRecs)
Memory allocation function for all of ResMan and other IRES protocol's memory requirements.
Definition: iresman.h:68
IRES_Handle(* getHandle)(IALG_Handle algHandle, IRES_ResourceDescriptor *resDesc, Int scratchGroupId, IRES_Status *status)
Function that returns the IRES_Handle to resource requested using the IRES_ProtocolArgs.
Definition: iresman.h:152
struct IRESMAN_Fxns IRESMAN_Fxns
IRES_Obj holds the private state associated with each logical resource.
Definition: ires_common.h:176
IRES Interface Definitions - Allows algorithms to request and receive handles representing private lo...
struct IRESMAN_Params IRESMAN_Params
Configuration Parameters required by the Resource Manager implementation. These can be extended by in...
Void(* deactivateResource)(IALG_Handle algHandle, IRES_Fxns *resFxns)
Definition: iresman.h:173
Void( IRESMAN_PersistentFreeFxn)(IALG_MemRec *memTab, Int numRecs)
Memory free functions for all of ResMan and other IRES protocol's memory requirements.
Definition: iresman.h:74
Descriptor to Logical Resource.
Definition: ires_common.h:122
These fxns are used to query/grant the resources requested by the algorithm at initialization time...
Definition: ires.h:168
Void(* activateResource)(IALG_Handle algHandle, IRES_Fxns *resFxns)
Definition: iresman.h:171
IRES_Status(* init)(IRESMAN_Params *initArgs)
Function to create and initialize the device specific resource manager implementation.
Definition: iresman.h:123
Copyright 2016, Texas Instruments Incorporated