已绑定手机
|
1.1 目的
本文件描述了HAL驱动的应用程序编程接口。API 为应用程序提供了接口以访问定时器、GPIO、UART 和 ADC。这是一个独立的 API 平台,为每个服务提供了功能的一个超集 。并非所有的功能都适用于所有的平台。
ADC | 模拟数字转换 | API | 应用程序编程接口 | CD | 载波检测 | CTS | 清除发送 | DSR | 数传机就绪 | DTR | 数据终端准备就绪 | GPIO | 通用输入输出 | HAL | 硬件抽象层 | MAC | 媒体访问控制 | OS AL | 操作系统抽象层 | RI | 振铃指示器 | RTS | 准备发送 |
2、驱动API概览
2.1 函数调用
2.1.1 初始化函数调用
这些函数调用用于初始化一个服务和/或为具体平台的数据配置可选参数。初始化函数通常在设备上电的开始阶段调用。
2.1.2 服务访问函数调用
这些函数调用可以直接访问硬件寄存器,以获得/设置硬件(比如,ADC)的某个值,或控制硬件组件(比如,LED)。
2.1.3 回调函数调用
这些函数必须由应用程序执行,用于给上层传递硬件(中断、计数器、定时器……)或轮询机制(UART 轮询、定时器轮询……)产生的事件。通过回调函数参数(比如一个指向数据的指针)进行的数据访问仅在函数执行时是有效的,当函数返回时不能视为有效。如果这些函数在中断的情况下执行,它必须是有效的,且不能执行 CPU 密集的操作或使用关键部分。
2.2 服务
HAL 驱动为 MAC 和上层提供了定时器、GPIO、LED、开关、UART 和 ADC 服务。这些服务中并非所有的功能都适用于每个平台。每个服务的功能可以通过初始化函数为不同的平台分别配置。
3、ADC 服务
本服务支持 8 个信道(0-7)上的 8、10 和 14 位模拟数字转换。
3.1 HalAdcInit()
3.1.1 描述
一旦启动,就调用这个 ADC 初始化函数。本函数必须在任何其它 ADC 函数调用之前
首先调用。它按照所必需的和可选的参数初始化 ADC。
3.1.2 函数原型
void HalAdcInit ( void )
3.1.3 参数描述:无。
3.1.4 返回值:无。
3.2 HalAdcRead()
3.2.1 描述
本函数读取并返回指定信道和分辨率上 ADC 转换的值。
3.2.2 函数原型
uint16 HalAdcRead (uint8 channel,uint8 resolution);
3.2.3 参数描述
channel–输入信道(对照信道表)
resolution–转换的分辨率。(对照分辨率表)
3.2.4 返回值
返回给定信道和分辨率的转换的 16 位值。
更多内容请下载附件查看
|
|