DSP_LoadG711

Syntax


BOOL DSP_LoadG711(FSFile *file, int slotB, int slotC);

Arguments

file	G.711 component file. You must either provide this using the `DSP_OpenStaticComponentG711` function, or open the `$TwlSDK/dspcomponents/audio/audio.a` file image that was saved to ROM in advance. The file will be used within this function alone and does not need to be maintained after the function has been called.
slotB	Bit field that shows the WRAM-B slots that may be used for DSP code memory. For example, this would be specified as `(1<<4)\|(1<<5)\|(1<<6)=0x70` to provide slots 4, 5, and 6 for the DSP.
slotC	Bit field that shows the WRAM-C slots that may be used for DSP code memory. For example, this would be specified as `(1<<4)\|(1<<5)\|(1<<6)=0x70` to provide slots 4, 5, and 6 for the DSP.

Return Values

Returns TRUE if the G.711 component was successfully loaded to the DSP.
Returns FALSE if loading failed due to an insufficient number of open WRAM-B or WRAM-C slots.

Description

Loads to the DSP a component to support the G.711 encoding. Calling this function allows you to use the following functions.


DSP_EncodeG711()
DSP_DecodeG711()
DSP_WaitForG711()
DSP_TryWaitForG711()

While loading, the library will automatically allocate only the necessary number of WRAM-B and WRAM-C slots out of those specified. The number of required WRAM-B and WRAM-C slots are each defined by the following macros.

DSP_SLOT_B_COMPONENT_G711
DSP_SLOT_C_COMPONENT_G711

You can use the DSP_UnloadG711 function to unload the G.711 component if it is no longer necessary.

Note

Always specify only component files that are saved in the SDK library currently being used. Operations will not be guaranteed if the versions do not match each other.

Revision History

2008/06/13 Added definitions for the number of WRAM slots required for loading components.
2008/05/22 Changed the structure of the arguments.
2008/03/04 Revised the title.
2008/02/21 Initial version.

CONFIDENTIAL