adc.h

西安明朗公司开发板ML-F020ICB的全部测试代码

/************************************************************************************
*  Copyright (c), 2004-2007,西安铭朗电子科技有限责任公司
*            All rights reserved.
*
* Http:  www.mlarm.com
* Email: [e-mail]
*
* File name: ADC.h
* Project  : ML-F020ICB
* Processor: C8051F020
* Compiler : Keil C51 Compiler
* 
* Author:  李林利
* Version: 1.20
* Date:    2007.6.1
* Email:   [e-mail]
* 
* Description: 本文件ADC硬件驱动程序头文件;
*
* Others: none;                 
*  
* Function List:
*	1. void ADC_Init(void)
*   2. void ADC_Enable(void)
*	3. void ADC_Disable(void)
*	4. void ADC_ClearFIFO(void)
*	5. unsigned char ADC_Read(unsigned int *p, unsigned int len)
*   6. unsigned int ADC_GetWordsRxBuf(void)
*
* History:
*   1. Author:       李林利  
*	   Version: 	 1.10
*	   Date:         2007.3.12
*      Modification: none
*
*   2. Author:       李林利   
*	   Version: 	 1.00
*      Date:         2004.11.24
*      Modification: 建立文件
*
*************************************************************************************/
/*************************************************************************************
* 						ADC硬件驱动程序函数使用说明
*
*	1. 第1步,必须在Config.h文件中进行ADC转换配置,详见其说明;
*	2. 第2步,必须调用函数ADC_Init(),本函数只允许调用1次;
*	3. 第3步,必须调用函数ADC_Enable(),启动AD转换;
*	4. 第4步,调用函数ADC_Read(),读取数据进行处理;在调用前也可先调用函数ADC_GetWordsRxBuf()
*      进行判断;	
*   5. 接下来要停止AD转换调用函数ADC_Disable(),也可重新调用函数ADC_Enable(),启动AD转换;
*	6. 如果想清空FIFO中数据调用 ADC_ClearFIFO()函数;
*	7. 其它细节详见具体函数说明;
*
*************************************************************************************/

/************************************************************************************/
// 常量及全局变量定义
/************************************************************************************/
extern bit bADC_FIFOFull; // ADC FIFO 满标志, 1:FIFO满,0:FIFO未满;

/*************************************************************************************/
//
// 							ADC硬件驱动程序函数外部引用声明
//
/*************************************************************************************/
/***********************************************************************************
* Function: ADC_Init;
*
* Description: ADC初始化函数;
*              
* Input:  none;
*
* Output: none;
*
* Return: none;
*
* Note:   本AD采样采用定时器2(被占用)进行触发并允许AD中断;
************************************************************************************/
void ADC_Init(void);

/***********************************************************************************
* Function: ADC_Enable;
*
* Description: ADC使能函数, ADC开始工作;
*              
* Input:  none;
*
* Output: none;
*
* Return: none;
*
* Note:   none;
************************************************************************************/
void ADC_Enable(void);

/***********************************************************************************
* Function: ADC_Disable;
*
* Description: ADC关闭函数, ADC停止工作;
*              
* Input:  none;
*
* Output: none;
*
* Return: none;
*
* Note:   none;
************************************************************************************/
void ADC_Disable(void);

/***********************************************************************************
* Function: ADC_ClearFIFO;
*
* Description: 清空ADC转换的数据FIFO;
*              
* Input:  none;
*
* Output: none;
*
* Return: none;
*
* Note:   调用此函数后,开始在数据FIFO重新装入AD数据采样值;
************************************************************************************/
void ADC_ClearFIFO(void);

/***********************************************************************************
* Function: ADC_Read;
*
* Description: 读取ADC转换数据函数;
*              
* Input:  *p,数据存储位置指针; len,读取数据的长度;
*
* Output: none;
*
* Return: TRUE, 读取成功; FALSE, 转换未完成, 读取失败, 等待一段时间后在读取;
*
* Note:   要求len的长度必须是有效AD转换通道数的整数倍,这样保证每次读取的第一个数据都是
*         所选则的第一个AD通道,以下数据按顺序类推;
************************************************************************************/
unsigned char ADC_Read(unsigned int *p, unsigned int len);

/***********************************************************************************
* Function: Uart0_GetCharsRxBuf;
*
* Description: 读取数据FIFO中AD转换数据长度;
*           
* Input:  none;
*
* Output: none;
*          		
* Return: 数据FIFO中AD转换数据长度;
*
* Note:   none;
************************************************************************************/
unsigned int ADC_GetWordsRxBuf(void);

/***********************************************************************************/
// 文件结束
/***********************************************************************************/