vcp2_soft_decisions_example.c

Dm6455 driver,magbe useful to you!

/*  ===========================================================================
 *   Copyright (c) Texas Instruments Inc 2002, 2003, 2004, 2005
 *
 *   Use of this software is controlled by the terms and conditions found in
 *   the license agreement under which this software has been supplied.
 *   ==========================================================================
 */

/** ===========================================================================
 * @file  Vcp2_soft_decisions_example.c
 *
 * @path $(CSLPATH)\example\vcp2\vcp2_soft_decisions\src
 *
 * @desc  Example of usage of CSL of VCP2 for computing soft decisions
 *
 *  ============================================================================
 *   @n Target Platform: EVM
 *  ============================================================================
 * @n <b> Description </b>
 *    This is an example for the VCP2 CSL usage for computing soft decision
 *    against the given branch metric values.
 *
 * @n The branch metrics are transferred to the VCP and soft decisions are
 *    read from the VCP using EDMA. 
 * @verbatim
       1. Configure the 2 EDMA channels
       2. Configure the input configuration registers of VCP
       3. Enable EDMA channels
       4. Start VCP
       5. Wait until VCP run is complete
   @endverbatim
 *=============================================================================
 *      
 * @n <b> Procedure to run the example </b>
 * @verbatim
      1. Configure the CCS setup
      2. Please refer CCS manual for setup configuration and loading 
         proper GEL file
      3. Launch CCS window
      4. Open project Vcp2_soft_decisions_example.pjt
      5. Build the project and load the .out file of the project.
           
   @endverbatim
 *       
 *   
 * ============================================================================
 */

/* =============================================================================
 *  Revision History
 *  ===============
 *  08-Oct-2005   SD     File Created.
 *  19-Dec-2005   SD     Added clearing of EDMA channel error registers 
 *  06-Feb-2006   SD     changes for the spec changes
 *  24-Feb-2006   DS     Added clearing of EDMA channel error registers at the
 *                       end of example
 * =============================================================================
 */
#include "csl_vcp2.h"
#include "csl_vcp2Aux.h"
#include "csl_edma3.h"
#include "stdio.h"
#include "string.h"
#include "cslr_dev.h"
#include "vcp2_example.h"

#define BITS_IN_A_BYTE 8

/* Constraint length */
#define CONSTRAINT_LEN 9

/* Frame length */
#define FRAME_LENGTH    186

/* EDMA frame size */
#define DMA_BURST_SIZE  128

/* VCP2 input configuration transfer size */
#define VCPIC_DMA_SIZE  24

/* VCP2 out register transfer size */
#define VCPOUT_DMA_SIZE  8

/* VCP2 yamamoto threshold */
#define YAMAMOTO_THRESHOLD 80

/* VCP2 initial state metric value */
#define INITIAL_STATE       63

/* Forward declarations */
Uint16 vcp2_configEdma(Uint32 inputBM, Uint32 outputHD);

/* EDMA global declarations */
CSL_Edma3Context             context;
CSL_Edma3ChannelObj          ChObj,ChObj1;
CSL_Edma3Obj                 edmaObj;
CSL_Edma3ChannelHandle       hChannel,hChannel1;
CSL_Edma3ParamHandle         hParam[4];
CSL_Edma3ParamSetup          myParamSetup;
CSL_Edma3ChannelAttr        chParam, chParam1;
CSL_Edma3ChannelErr         chErrClear;

/* Globals */                         
VCP2_ConfigIc                vcpConfig; 
Uint32                      ouputParams[2];

/*
 * =============================================================================
 *   @func   main
 *   @desc
 *       Various parameters of the input data (Branch metrics) provided along 
 *      with this example are as follows.
 *      Frame length...................................186                                
 *      rate...........................................1/2
 *      constraint length..............................9
 *      Decision mode..................................Soft 
 *      Traceback Mode.................................Mixed
 *      Index of the initial max state metric(IMAXI)...63 
 *      output parameters read flag....................TRUE
 *      Yamamoto enable................................TRUE
 *      Yamamoto threshold.............................80
 *      Traceback state enable.........................False 
 *      Traceback state index..........................N/A  
 *      DSP endian.....................................Little 
 *      Endian Register................................bm_endian
 *      Output order...................................1       
 *
 *   @expected result
 *      Appropriate message will be logged depending on 
 *      the result
 *
 *   @eg
 *      main();  
 * =============================================================================
 */
void main()
{
    volatile Uint16         frameLen, constLen;
    Uint32                  numSymProc;
    Uint32                  inputBM;
    Uint32                  outputHD;
    Uint32                  outputHD_bytes;
    Uint32                  outputHD_words;
    VCP2_Params             vcpParams;
    VCP2_BaseParams         vcpBaseParams;
    VCP2_Errors             errors;
	Uint32 					index;

    VCP2_Poly        poly = {0x6c, 0xe4, 0,0}; /* polynomials used */

    /* Enable the VCP2 in power saver */
    CSL_FINST (((CSL_DevRegs*)CSL_DEV_REGS)->PERLOCK, DEV_PERLOCK_LOCKVAL, 
                                                                    UNLOCK);

    CSL_FINST (((CSL_DevRegs*)CSL_DEV_REGS)->PERCFG0, DEV_PERCFG0_VCPCTL, 
                                                                    ENABLE);

    while (CSL_DEV_PERSTAT0_VCPSTAT_ENABLE != 
            CSL_FEXT (((CSL_DevRegs*)CSL_DEV_REGS)->PERSTAT0, 
                                                    DEV_PERSTAT0_VCPSTAT));

    /* VCP configuration */
    vcpBaseParams.rate      = VCP2_RATE_1_2;
    vcpBaseParams.constLen  = CONSTRAINT_LEN;
    vcpBaseParams.frameLen  = FRAME_LENGTH;
    vcpBaseParams.yamTh     = YAMAMOTO_THRESHOLD;
    vcpBaseParams.stateNum  = INITIAL_STATE;
    vcpBaseParams.tbConvrgMode = FALSE;
    vcpBaseParams.decision  = VCP2_DECISION_SOFT;
    vcpBaseParams.readFlag  = TRUE;
    vcpBaseParams.tailBitEnable = FALSE;
    vcpBaseParams.traceBackIndex = 0;
    vcpBaseParams.outOrder  = 1;

    /* VCP configuration */
    VCP2_genParams (&vcpBaseParams, &vcpParams);

    /* Number of EDMA frames (transfers) for branch metrics */
    inputBM = vcpParams.numBmFrames;

    /* Output hard decisions in terms of bytes rounded to upper byte */
    outputHD_bytes = vcpBaseParams.frameLen + vcpBaseParams.constLen - 1;

    /* Output hard decisions in terms of words rounded to upper words */
    outputHD_words = VCP2_normalCeil (outputHD_bytes, sizeof (Uint32));

    /* Total number of bytes required to be transfered */
    outputHD = outputHD_words * sizeof (Uint32);
    
    /* Configure EDMA */
    if (!(vcp2_configEdma (inputBM, outputHD)))
    {
        printf("\nError in configuring EDMA\n");
        return;
    }
    else
        printf("\nConfiguring EDMA......... Success\n");

    /* update the polynomials */        
    VCP2_addPoly (&poly, &vcpParams);
    
    frameLen = vcpParams.frameLen;
    constLen = vcpParams.constLen;
    VCP2_genIc (&vcpParams, &vcpConfig);

    /* clear the error registers */
    chErrClear.missed = TRUE;
    chErrClear.secEvt = TRUE;
    CSL_edma3HwChannelControl (hChannel, CSL_EDMA3_CMD_CHANNEL_DISABLE, NULL);
    CSL_edma3HwChannelControl (hChannel1, CSL_EDMA3_CMD_CHANNEL_DISABLE, NULL);
    CSL_edma3HwChannelControl (hChannel, CSL_EDMA3_CMD_CHANNEL_CLEARERR, 
                               &chErrClear);
    CSL_edma3HwChannelControl (hChannel1, CSL_EDMA3_CMD_CHANNEL_CLEARERR, 
                               &chErrClear);
    CSL_edma3HwChannelControl (hChannel, CSL_EDMA3_CMD_CHANNEL_CLEAR, NULL);
    CSL_edma3HwChannelControl (hChannel1, CSL_EDMA3_CMD_CHANNEL_CLEAR, NULL);

    /* Enable Channel */
    CSL_edma3HwChannelControl(hChannel1, CSL_EDMA3_CMD_CHANNEL_ENABLE , NULL);