csl_mcbspaux.h

来自「dsp在音频处理中的运用」· C头文件 代码 · 共 207 行

/*****************************************************\
 *  Copyright 2003, Texas Instruments Incorporated.  *
 *  All rights reserved.                             *
 *  Restricted rights to use, duplicate or disclose  *
 *  this   code   are  granted   through  contract.  *
 \*****************************************************/

/*  @(#) PSP/CSL 3.00.01.00[5912PG1_0] (2003-11-12)  */

#ifndef _CSL_MCBSPAUX_H_
#define _CSL_MCBSPAUX_H_

#include <csl_types.h>
#include <csl_error.h>
#include <cslr_mcbsp.h>

/**************************************************************************\
* MCBSP Private function declarations
\**************************************************************************/

#ifdef __cplusplus
extern "C" {
#endif

/*
 * ======================================================
 *   @func   _csl_mcbspBlockAssign.c
 *   @desc   The funtion is used to assign block to a particular partition
 *                This is an Internal function and is used by the CSL_mcbspHwControl
 *                function
 *
 *
 *   @arg  hMcbsp
 *              Handle of the McBSP
 *   @arg  partition
 *              Partition to which the block is to be assigned to
 *   @arg  block
 *              Identifies the block
 *   @ret  CSL_Status
 *
 *          CSL_SOK: Successful completion
 *          CSL_ESYS_FAIL: Operation could not the done
 *
 *   @eg
 *     CSL_mcbspBlockAssign(hMcbsp, CSL_MCBSP_PARTITION_ATX, CSL_MCBSP_BLOCK0);
 *
 * ======================================================
*/

CSL_Status  CSL_mcbspBlockAssign(
    CSL_McbspHandle                         hMcbsp,
    CSL_McbspPartition                      partition,
    CSL_McbspBlock                          block
);

/*
 * ======================================================
 *   @func   _csl_mcbspChannelControl.c
 *   @desc   Eanble one Channel in Multi Channel Selection Mode
 *
 *
 *   @arg  hMcbsp
 *              Device Handle;
 *   @arg  channelNo
 *              Channel Number
 *   @arg  block
 *              Block to which the channel belongs to
 *   @arg  operation
 *              The operation to be performed
 *   @ret  CSL_Status
 *
 *
 *   @eg
 *     MCBSP_Handle hMcbsp;
 *     hMcbsp = CSL_mcbspOpen(hMcbsp, CSL_MCBSP_0, CSL_EXCLUSIVE, &status, NULL);
 *     CSL_mcbspChannelControl( hMcbsp, 11, 1, CSL_MCBSP_CHAN_RX_ENABLE);
 *
 *
 * ======================================================
*/

CSL_Status  CSL_mcbspChannelControl(
    CSL_McbspHandle                       hMcbsp,
    Uint16                                channelNo,
    CSL_McbspBlock                        block,
    CSL_McbspChCtrl                       operation
);

/*
 * ======================================================
 *   @func   _csl_mcbspClearFrmSyncErr.c
 *   @desc   Clear Frame Sync Error for Receiver and Transmitter.
 *
 *
 *   @arg  hMcbsp
 *              Device Handle;
 *   @arg  chanType
 *              Selects receiver/transmitter.
 *   @ret  void
 *               None
 *
 *   @eg
 *     CSL_McbspHandle hMcbsp;
 *     hMcbsp = CSL_mcbspOpen(hMcbsp, CSL_MCBSP_0, CSL_EXCLUSIVE, &status, NULL);
 *     CSL_mcbspClearFrmSyncErr( hMcbsp, CSL_MCBSP_RX);
 *
 *
 * ======================================================
*/

void  CSL_mcbspClearFrmSyncErr(
    CSL_McbspHandle                         hMcbsp,
    CSL_McbspChType                       chanType
);

/*
 * ======================================================
 *   @func   _csl_mcbspIoModeCtrl.c
 *   @desc   Configure selected McBSP pins for Input/Output
 *
 *
 *   @arg  hMcbsp
 *              Device Handle;
 *   @arg  outputSel
 *              Select Pins for output. Bitwise OR of CSL_MCBSP_IO_XXXX
 *   @arg  inputSel
 *              Select Pins for input. Bitwise OR of CSL_MCBSP_IO_XXXX
 *   @ret  void
 *
 *
 *   @eg
 *     CSL_McbspHandle hMcbsp;
 *     hMcbsp = CSL_mcbspOpen(hMcbsp, CSL_MCBSP_0, CSL_EXCLUSIVE, &status, NULL);
 *     CSL_mcbspIoModeCtrl( hMcbsp,  CSL_MCBSP_IO_CLKX | CSL_MCBSP_IO_CLKR,
 *                                         CSL_MCBSP_IO_FSX | CSL_MCBSP_IO_CLKR );
 *
 * ======================================================
*/

void  CSL_mcbspIoModeCtrl(
    CSL_McbspHandle                         hMcbsp,
    CSL_BitMask16                           outputSel,
    CSL_BitMask16                           inputSel
);

/*
 * ======================================================
 *   @func   _csl_mcbspResetCtrl.c
 *   @desc   Enable/Disable Frame Sync Logic/Sample Rate Generator and Receiver and Transmitter Operation
 *
 *
 *   @arg  hMcbsp
 *              Device Handle
 *   @arg  selectMask
 *              Selects enable/disable of receiverCfg/transmitter. Bitwise OR of MCBSP_CTRL_XXXX
 *   @ret  void
 *               None
 *
 *
 *   @eg
 *     CSL_McbspHandle hMcbsp;
 *     hMcbsp = CSL_mcbspOpen(hMcbsp, CSL_MCBSP_0, CSL_EXCLUSIVE, &status, NULL);
 *     CSL_mcbspResetCtrl( hMcbsp, CSL_MCBSP_CTRL_SRG_ENABLE | CSL_MCBSP_CTRL_FSYNC_DISABLE
 *                                 | CSL_MCBSP_CTRL_RX_ENABLE
 *                                 | CSL_MCBSP_CTRL_TX_ENABLE );
 *
 * ======================================================
*/

void  CSL_mcbspResetCtrl(
    CSL_McbspHandle                         hMcbsp,
    CSL_BitMask16                           selectMask
);

/*
 * ======================================================
 *   @func   _csl_mcbspRegReset.c
 *   @desc   Function to reset all the registers values
 *
 *
 *   @arg  hMcbsp
 *              Device Handle;
 *   @ret  void
 *               None
 *
 *
 *   @eg
 *     CSL_McbspHandle hMcbsp;
 *     hMcbsp = CSL_mcbspOpen(hMcbsp, CSL_MCBSP_0, CSL_EXCLUSIVE, &status, NULL);
 *     CSL_mcbspRegReset(hMcbsp);
 *
 *
 * ======================================================
*/

void  CSL_mcbspRegReset(
    CSL_McbspHandle                         hMcbsp
);

#ifdef __cplusplus
}
#endif


#endif