Z-Stack – HAL Driver API – 模数转换

注明

  • 本文摘译自TI(德州仪器)公司的《HAL Drivers Application Programming Interface》。
  • 文件号:SWRA193。
  • 所有版权归TI(德州仪器)公司所有。
  • 本文章节序号与原文相同。
  • 关于硬件抽象层应用编程接口(HAL Driver API)的介绍详见Z-Stack – HAL Driver API – 简介

3. ADC服务简介

模数转换服务(ADC Service)提供8个信道上的8位、10位、14位模数转换。

3.1 HalAdcInit ()

3.1.1 描述

该ADC初始化函数会在设备启动时被调用一次。在其他ADC函数调用前必须使用该函数初始化ADC。此函数初始化ADC时会自动带上必须和可选参数。

3.1.2 原型

void HalAdcInit (void);

3.1.3 参数

无。

3.1.4 返回值

无。

3.2 HalAdcRead ()

3.2.1 描述

该函数从特定的端口上读取模拟信号并返回以特定解析度模数转换后的值。

3.2.2 原型

uint16 HalAdcRead (uint8 channel, uint8 resolution);

3.2.3 参数

channel – 模拟信号输入信道(详见文章末尾)。
resolution – 转换方案(详见文章末尾)。

3.2.4. 返回值

返回16位无符号整形(uint16)值。

3.3 常量表

3.3.1 信道表

  • HAL_ADC_CHANNEL_0 – 输入信道0。
  • HAL_ADC_CHANNEL_1 – 输入信道1。
  • HAL_ADC_CHANNEL_2 – 输入信道2。
  • HAL_ADC_CHANNEL_3 – 输入信道3。
  • HAL_ADC_CHANNEL_4 – 输入信道4。
  • HAL_ADC_CHANNEL_5 – 输入信道5。
  • HAL_ADC_CHANNEL_6 – 输入信道6(默认P0_6)。
  • HAL_ADC_CHANNEL_7 – 输入信道7(默认P0_7)。

3.3.2 转换方案表

  • HAL_ADC_RESOLUTION_8 – 8位解析度转换。
  • HAL_ADC_RESOLUTION_10 – 10位解析度转换。
  • HAL_ADC_RESOLUTION_12 – 12位解析度转换。
  • HAL_ADC_RESOLUTION_14 – 14位解析度转换。