csl_pwrdwngethwsetup.c

TI达芬奇dm644x各硬件模块测试代码

/* ============================================================================
 * 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 csl_pwrdwnGetHwSetup.c
 *
 *  @brief File for functional layer of CSL API @a CSL_pwrdwnGetHwSetup()
 *
 *  PATH \\(CSLPATH)\\ipmodules\\pwrdwn\\src
 *
 *  @Desc The @a CSL_pwrdwnGetHwSetup() function definition & it's associated
 *        functions
 *
 *  Modification 1
 *    - Modified on: 7/16/2004
 *    - Reason: created the sources
 *
 *  @author Ruchika Kharwar.
 * ============================================================================
 */

#include <csl_pwrdwn.h>

/** ===========================================================================
 *   @n@b CSL_pwrdwnGetHwSetup
 *
 *   @b Description
 *   @n It retrives the hardware setup parameters
 *
 *   @b Arguments
 *   @verbatim
         hPwr        Handle to the PWRDWN instance

         hwSetup     Pointer to hardware setup structure
     @endverbatim
 *
 *   <b> Return Value </b>  CSL_Status
 *   @li                    CSL_SOK             - Hardware setup retrived
 *   @li                    CSL_ESYS_BADHANDLE  - Invalid handle
 *
 *   <b> Pre Condition </b>
 *   @b CSL_pwrdwnInit(), CSL_pwrdwnOpen() must be opened prior to this call.
 *
 *   <b> Post Condition </b>
 *   @n  The hardware set up structure will be populated with values from
 *       the registers
 *
 *   @b Modifies
 *   @n None
 *   
 *   @b Example
     @verbatim
       CSL_PwrdwnObj pwrObj;
       CSL_PwrdwnHwSetup pwrSetup,querySetup;
       CSL_PwrdwnHandle hPwr;
       CSL_BitMask32 pageSleep;
       // Init Module
       ...
       if (CSL_pwrdwnInit(NULL) != CSL_SOK)
           exit;
           // Opening a handle for the Module	
           hPwr = CSL_pwrdwnOpen (&pwrObj, CSL_PWRDWN_0, NULL, NULL);
	
	   // Setup the arguments for the Setup structure
	   ...
	
	   // Setup
	   CSL_pwrdwnHwSetup(hPwr,&pwrSetup);
    
       // Query Setup
       CSL_pwrdwnGetHwSetup(hPwr,&querySetup);
	
       // Close handle
       CSL_pwrdwnClose(hPwr);

     @endverbatim
 * ============================================================================
 */
#pragma CODE_SECTION (CSL_pwrdwnGetHwSetup, ".text:csl_section:pwrdwn");
CSL_Status CSL_pwrdwnGetHwSetup (
	/** Pointer to the object that holds reference to the
     *  instance of PWRDWN.
	 */
    CSL_PwrdwnHandle  hPwrdwn,
    /** Pointer to setup structure which contains the
	 *  information to program PWRDWN to a useful state 
	 */
    CSL_PwrdwnHwSetup *setup
	){

	CSL_Status status = CSL_SOK;
	/** This is a pointer to the registers of the instance of L2 PWRDWN
     *  referred to by this object
     */
	CSL_L2pwrdwnRegsOvly l2pwrdwnRegs;
	Uint32 tempPdcCmd;

	if (hPwrdwn== NULL) {
        return CSL_ESYS_BADHANDLE;
    }

    if (setup == NULL) {
        return CSL_ESYS_INVPARAMS;
    } 
	
    tempPdcCmd = hPwrdwn->pdcRegs->PDCCMD;
    
    if (setup->l1dConf) {
    	setup->l1dConf->clockGate = (Bool)CSL_FEXT(tempPdcCmd,PDC_PDCCMD_DMCLOG);
    	setup->l1dConf->mode = 	(CSL_PwrdwnSramSleepMode)CSL_FEXT(tempPdcCmd,\
                                                           PDC_PDCCMD_DMCMEM);
    }
   	if (setup->l2Conf) {
   		setup->l2Conf->clockGate = (Bool)CSL_FEXT(tempPdcCmd,PDC_PDCCMD_UMCLOG);
   		setup->l2Conf->mode = (CSL_PwrdwnSramSleepMode)CSL_FEXT(tempPdcCmd, \
                                                          PDC_PDCCMD_UMCMEM);
    }
    if (setup->l1pConf) {
    	setup->l1pConf->clockGate = (Bool)CSL_FEXT(tempPdcCmd,PDC_PDCCMD_PMCLOG);
    	setup->l1pConf->mode = (CSL_PwrdwnSramSleepMode)CSL_FEXT(tempPdcCmd, \
                                                           PDC_PDCCMD_PMCMEM);
    }
    if (setup->emcConf) {
    	setup->emcConf->clockGate = (Bool)CSL_FEXT(tempPdcCmd,PDC_PDCCMD_EMCLOG);
    	setup->emcConf->mode =(CSL_PwrdwnSramSleepMode)CSL_FEXT(tempPdcCmd, \
                                                          PDC_PDCCMD_EMCMEM);
   	}
   	if (setup->autoPwrdwn) {
	    l2pwrdwnRegs = hPwrdwn->l2pwrdwnRegs;
	    setup->autoPwrdwn->umap0PageEnable = l2pwrdwnRegs->L2PDAEN[0] ;
	    setup->autoPwrdwn->umap1PageEnable = l2pwrdwnRegs->L2PDAEN[1] ;
	    setup->autoPwrdwn->umap0PeriodSelect = l2pwrdwnRegs->L2PDAPS[0]; 
	    setup->autoPwrdwn->umap1PeriodSelect = l2pwrdwnRegs->L2PDAPS[1];
	    setup->autoPwrdwn->periodA = CSL_FEXT(l2pwrdwnRegs->L2PDAP, \
                                               L2PWRDWN_L2PDAP_PERA);
	    setup->autoPwrdwn->periodB = CSL_FEXT(l2pwrdwnRegs->L2PDAP, \
                                               L2PWRDWN_L2PDAP_PERB);
    }
   	if (setup->manualPwrdwn) {
   	    setup->manualPwrdwn->umap0PageWake = 0;
   		setup->manualPwrdwn->umap1PageWake = 0;
   		setup->manualPwrdwn->umap0PageSleep = 0;
  		setup->manualPwrdwn->umap1PageSleep = 0;
   	}
    
	return status;
}