79 lines
5.3 KiB
C
79 lines
5.3 KiB
C
/**********************************ADC V3.5a 说明 ************************************************************************
|
||
ADC模块用于“STC-B学习板”上与ADC相关电路:温度Rt、光照Rop、导航按键Nav、扩展接口EXT上的ADC转换。提供ADC模块初始化函数、2个应用函数,2个事件：
|
||
(1) AdcInit(char ADCsel)：ADC模块初始化函数；
|
||
函数参数: ADCsel选择扩展接口EXT是否用作ADC功能，取值：
|
||
ADCincEXT : 含对扩展接口EXT设置ADC功能（EXT上P1.0、P1.1不可作数字IO功能使用）
|
||
ADCexpEXT : 不含对扩展接口EXT设置ADC功能（EXT上P1.0、P1.1可作数字IO功能使用）
|
||
(2) struct_ADC GetADC()：获取ADC值。
|
||
函数参数：无
|
||
函数返回值：返回数据结构 struct_ADC。
|
||
数据结构定义：
|
||
typedef struct //ADC转换结果
|
||
{ unsigned int EXT_P10; // 扩展接口EXT上P1.0脚ADC（10bit）
|
||
unsigned int EXT_P11; // 扩展接口EXT上P1.1脚ADC（10bit）
|
||
unsigned int Rt; // 热敏电阻上ADC（10bit）
|
||
unsigned int Rop; // 光敏电阻上ADC（10bit）
|
||
unsigned int Nav; // 导航按键上ADC（10bit）
|
||
} struct_ADC;
|
||
|
||
说明1：每个数字表示 VCC/1024（单位：V），其中VCC为电路板供电电压（USB接口一般为5V左右）
|
||
说明2：对于导航按键，下面GetAdcNavAct函数输出消抖后导航按键事件和状态，更方便使用；
|
||
|
||
(3) char GetAdcNavAct(char Nav_button)：获取导航按键（包含K3）状态
|
||
函数参数：Nav_button：指定要获取状态的导航按键。取值：
|
||
enumAdcNavKey3（K3键）,
|
||
enumAdcNavKeyRight（右按）,
|
||
enumAdcNavKeyDown（下按）,
|
||
enumAdcNavKeyCenter（中心按）
|
||
enumAdcNavKeyLeft（左按）,
|
||
enumAdcNavKeyUp（上按）.
|
||
（当参数取值不在有效范围，函数将返回enumKeyFail）
|
||
函数返回值：返回当前按键事件，返回值：（同Key模块GetAdcKeyAct（）返回值）
|
||
enumKeyNull（无按键动作）,
|
||
enumKeyPress（按下）,
|
||
enumKeyRelease（抬起）,
|
||
enumKeyFail（失败）
|
||
返回值是经过多次检测按键实时状态和统计检测结果后（软件消抖）的有效事件。
|
||
每个按键查询一次后,事件值变成 enumKeyNull (仅查询一次有效)
|
||
(4) 导航按键事件“：enumEventNav
|
||
当导航按键5个方向或按键K3有任意”按下“或”抬起“动作时，将产生一个”导航按键事件“enumEventNav。响应导航按键事件的用户回调函数由用户编写,并由sys提供的SetEventCallBack()函数设置响应函数.
|
||
(5) 扩展接口EXT上P1.0、P1.1两个端口有新的AD值事件“：enumEventXADC
|
||
当ADC模块对P1.0、P1.1进行ADC转换，获得了它们新的ADC结果时，将产生enumEventXADC事件，通知用户进行处理。响应enumEventXADC事件的用户回调函数由用户编写,并有sys提供的SetEventCallBack()函数设置响应函数.
|
||
ADC模块对P1.0、P1.1进行ADC转换速度为3mS，也即每3mS或每秒钟333次转换.
|
||
(6) 补充说明：
|
||
a：对EXT上P1.0、P1.0的转换速度为3mS，也即每秒钟提供333次转换结果，提供了有新转换结果事件：enumEventXADC，方便用户处理
|
||
b：对于Rt、Rop，转换速度为9mS，也即每秒钟提供111次转换结果。没有提供相应“事件”，用户随时用函数GetAdcResult()查询和使用
|
||
c：对导航按键进行了软件消抖处理，最快可支持导航按键每秒12次操作速度，提供了导航按键发生了操作事件：enumEventNav
|
||
d：由于导航按键与K3键共用了单片机同一个端口（P1.7），启用ADC模块后，P1.7口IO功能失效，只能用GetAdcNavAct(char Nav_button)函数获取K3按键的事件或状态。
|
||
e: STC-B板上Rt型号为：10K/3950 NTC热敏电阻，光敏电阻Rop型号为：GL5516. 它们的ADC值与温度、光照强度关系请参阅它们的数据手册与STC-B电路图进行换算。
|
||
|
||
|
||
编写：徐成（电话18008400450） 2021年3月25日设计,2021年8月30日修改
|
||
*/
|
||
|
||
#ifndef _adc_H_
|
||
#define _adc_H_
|
||
|
||
#define ADCincEXT 0x9B
|
||
#define ADCexpEXT 0x98
|
||
|
||
typedef struct //ADC转换结果
|
||
{ unsigned int EXT_P10; // 扩展接口EXT上P1.0脚ADC
|
||
unsigned int EXT_P11; // 扩展接口EXT上P1.1脚ADC
|
||
unsigned int Rt; // 热敏电阻上ADC
|
||
unsigned int Rop; // 光敏电阻上ADC
|
||
unsigned int Nav; // 导航按键上ADC
|
||
} struct_ADC;
|
||
|
||
extern void AdcInit(char ADCsel);
|
||
|
||
extern struct_ADC GetADC();
|
||
extern unsigned char GetAdcNavAct(char Nav_button); //获取导航按键5个方向（右、下、中心、左、上）操作，以及按键K3操作的事件
|
||
//返回值：enuKeyNull（无按键动作）,enuKeyPress（按下）,enuKeyRelease（抬起）,enuKeyFail（失败）
|
||
enum KN_name {enumAdcNavKey3=0, //导航按键：按键K3
|
||
enumAdcNavKeyRight, //导航按键：右
|
||
enumAdcNavKeyDown, //导航按键：下
|
||
enumAdcNavKeyCenter, //导航按键：中心
|
||
enumAdcNavKeyLeft, //导航按键：左
|
||
enumAdcNavKeyUp}; //导航按键：上
|
||
#endif |