csp_capt.c

IAR 平台ATMEL 的例程, 和说明

/*-----------------------------------------------------------------------------
*   EUROPE TECHNOLOGIES Software Support
*------------------------------------------------------------------------------
* The software is delivered "AS IS" without warranty or condition of any
* kind, either express, implied or statutory. This includes without
* limitation any warranty or condition with respect to merchantability or
* fitness for any particular purpose, or against the infringements of
* intellectual property rights of others.
*------------------------------------------------------------------------------
*
* File Name       : csp_capt.c
* Description     : Function declarations for Capture management
* Library Version : 2.00
* Module Version  : 1.XX
*
*       +----- (NEW | MODify | ADD | DELete)                                 
*       |                                                                    
*  No   |   When       Who                What               
*-----+---+----------+------------------+--------------------------------------
* 000  NEW  01/05/99   Patrice VILCHEZ    Creation
* 001  MOD  01/04/01   David COMBE        Introduce CSP_CAPTConfigInterrupt 
                                          function
                                          Define Global CSP_CAPTCounter Variable
* 002  MOD  01/04/01   Olivier MAZUYER    Clean up
* 003  MOD  08/06/01   Frederic SAMSON    Clean Up
* 004  MOD  12/11/01   Christophe GARDIN  Clean Up
* 005  MOD  11/04/02   Christophe GARDIN  Add CSP_CAPTClose function
*----------------------------------------------------------------------------*/

/******************************************************************************
* Include Files
******************************************************************************/
#include "csp.h"


/******************************************************************************
****************************  F U N C T I O N S  ******************************
******************************************************************************/

/******************************************************************************
* Function          : CSP_CAPTInit
* Description       : Switch on the clock, reset the registers and configure the 
*                     CAPTURE module mode and the PDC RX line
* Inputs            : <*capt> = Pointer to CAPTURE structure
*                     <mode>  = Configure the CAPTURE mode
* Functions called  : CSP_PDCInitRx
* Returns           : None
******************************************************************************/
void CSP_CAPTInit(CSP_CAPT_T *const capt, U32_T mode)
{
   /* Enable CAPTURE Clock */
   CSP_CAPT_SET_ECR(capt, CAP);
     
   /* CAPTURE Software Reset */
   CSP_CAPT_SET_CR(capt, SWRST);

   /* Configure CAPTURE Mode */
   CSP_CAPT_SET_MR(capt, mode);
     
   /* Configure CAPTURE PDC Rx Line */
   CSP_PDCInitRx((U32_T) capt, (U32_T) &(capt->DR), SIZE_HALFWORD);
}


/******************************************************************************
* Function          : CSP_CAPTClose
* Description       : Reset and switch off the clock
* Inputs            : <*capt> = Pointer to CAPTURE structure
* Functions called  : None
* Returns           : None
******************************************************************************/
void CSP_CAPTClose(CSP_CAPT_T *const capt)
{
   /* CAPTURE Software Reset */
   CSP_CAPT_SET_CR(capt, SWRST);

   /* Disable CAPTURE Clock */  
   CSP_CAPT_SET_DCR(capt, CAP);
}


/******************************************************************************
* Function          : CSP_CAPTConfigInterrupt
* Description       : Configure CAPTURE Interrupts
* Inputs            : <*capt>    = Pointer to CAPTURE structure
*                     <int_mode> = Configure the priority level and source type
*                     <int_mask> = Configure which interrupt bits are activated
*                     <callback> = Function called through the assembler interrupt handler
* Functions called  : CSP_GET_INTERRUPT_NUMBER, CSP_GICConfigInterrupt
* Returns           : None
******************************************************************************/
void CSP_CAPTConfigInterrupt(CSP_CAPT_T *const capt, 
                             U32_T int_mode, 
                             U32_T int_mask, 
                             U32_T callback)
{
   /* Local Variables */
   U8_T int_num = 0;

   /* Get Peripheral Interrupt Number */
   int_num = CSP_GET_INTERRUPT_NUMBER(capt);

   /* Disable all interrupt */
   CSP_CAPT_SET_IDR(capt, 0xFFFFFFFF);
      
   /* Interrupt Enable */
   CSP_CAPT_SET_IER(capt, int_mask);

   /* Configure CAPTURE controller interrupt mode in GIC module */
   CSP_GICConfigInterrupt(int_num, int_mode, callback);
}


/******************************************************************************
* Function          : CSP_CAPTEnable
* Description       : Enable CAPTURE
* Inputs            : <*capt> = Pointer to CAPTURE structure
* Functions called  : None
* Returns           : None
******************************************************************************/
void CSP_CAPTEnable(CSP_CAPT_T *const capt)
{
   /* Enable CAPTURE */
   CSP_CAPT_SET_CR(capt, CAPEN);
}


/******************************************************************************
* Function          : CSP_CAPTDisable
* Description       : Disable CAPTURE 
* Inputs            : <*capt> = Pointer to CAPTURE structure
* Functions called  : None
* Returns           : None
******************************************************************************/
void CSP_CAPTDisable(CSP_CAPT_T *const capt)
{
   /* Disable CAPTURE */
   CSP_CAPT_SET_CR(capt, CAPDIS);
}


/******************************************************************************
* Function          : CSP_CAPTStart
* Description       : Start CAPTURE
* Inputs            : <*capt> = Pointer to CAPTURE structure
* Functions called  : None
* Returns           : None
******************************************************************************/
void CSP_CAPTStart(CSP_CAPT_T *const capt)
{
   /* Start CAPTURE */
   CSP_CAPT_SET_CR(capt, STARTCAPT);
}