ADC#
ADC (Analog-to-Digital Converter) 驱动 | sample: adc
学习目标#
掌握 ADC 单次采样的完整流程:
uapi_adc_init()→adc_port_read()读取电压值理解 WS53 当前 V155 ADC 的 12-bit 分辨率、1800mV 标称换算上限和校准换算方式
能够在 WS53 上读取模拟传感器的电压值
基本概念#
ADC 做什么#
ADC将模拟电压转换为数字值——温度传感器、光敏电阻、电位器等模拟信号都需要 ADC 才能被 CPU 理解。
flowchart LR
A["ADC 引脚输入电压<br/> "] --> ADC["ADC 转换器<br/> "]
ADC --> D["数字值 0~4095<br/>12-bit 分辨率"]
D --> C["CPU 读取<br/> "]
分辨率和参考电压#
ADC 原始码为 12 bit,码值范围为 0~4095,共 4096 个量化等级;V155 HAL 使用 1800mV 作为标称换算上限,并结合芯片校准参数 data_k、data_b 将原始码换算为毫伏值。
应用调用 adc_port_read() 时得到的已经是换算后的毫伏值,不需要再按 原始码 / 4095 × Vref 进行二次计算。
输入电压要求#
1800mV 是当前 V155 HAL 使用的标称换算上限。板级是否带有分压或其他模拟前端,需要以开发板原理图和芯片资料为准;在未确认硬件路径前,不要将 3.3V 直接接入 ADC 引脚。
单次采样 vs 连续采样#
模式 |
行为 |
适用场景 |
|---|---|---|
单次 |
触发一次转换,完成后 CPU 读结果 |
温度、光照等慢变信号 |
连续 |
硬件持续转换,DMA (Direct Memory Access) 搬数据 |
音频采样、快速波形捕捉 |
涉及 API#
API |
用途 |
头文件 |
|---|---|---|
|
初始化 ADC 模块 |
|
|
读取指定通道的电压值(mV) |
|
|
去初始化 ADC |
|
案例说明#
案例简介#
初始化 ADC,每 10 秒采样一次指定通道的电压值并打印。循环 10 次后退出。
功能规格#
规格项 |
说明 |
|---|---|
ADC 通道 |
|
采样间隔 |
10000ms(10 秒) |
采样次数 |
10 次 |
输出单位 |
mV(毫伏) |
任务优先级 |
26 |
程序运行流程:uapi_adc_init → 循环 10 次 adc_port_read → 打印电压 → osal_msleep(10000) → uapi_adc_deinit。
案例流程#
flowchart TD
I["<div style='width: 220px;'>uapi_adc_init</div>"] --> L
L["<div style='width: 220px;'>循环 10 次</div>"] --> R["<div style='width: 220px;'>adc_port_read channel, voltage</div>"]
R --> P["<div style='width: 220px;'>printf voltage mV</div>"]
P --> S["<div style='width: 220px;'>osal_msleep 10000ms</div>"]
S --> D{10 次?}
D -->|否| R
D -->|是| E["<div style='width: 220px;'>uapi_adc_deinit</div>"]
案例操作指导#
第一步:编译#
fbb build ws53_liteos_app
第二步:烧录#
fbb flash ws53_liteos_app
第三步:验证#
串口每 10 秒输出一次电压值:
voltage: 1650 mv
voltage: 1652 mv
...
关键配置#
参数 |
值 |
说明 |
|---|---|---|
ADC 通道 |
Kconfig 可配 |
确认硬件引脚对应哪个 ADC 通道 |
标称换算上限 |
1800mV |
当前 V155 HAL 的 |
采样间隔 |
10000ms |
慢变信号(如温度),无需高频采样 |
代码详解#
关键代码片段如下,完整实现见 src/application/samples/peripheral/adc/adc_demo_inc.c:
#include "adc.h"
#include "adc_porting.h"
#include "soc_osal.h"
#include "app_init.h"
#define DELAY_10000MS 10000
#define CYCLES 10
#define ADC_TASK_PRIO 26
#define ADC_TASK_STACK_SIZE 0x1000
static void *adc_task(const char *arg)
{
(void)arg;
osal_printk("start adc sample\r\n");
/* 初始化 ADC——clock 参数传入 ADC_CLOCK_NONE */
uapi_adc_init(ADC_CLOCK_NONE);
uint8_t adc_channel = CONFIG_ADC_CHANNEL;
uint16_t voltage = 0;
uint32_t cnt = 0;
while (cnt++ < CYCLES) {
/* 读取指定通道电压——返回单位 mV */
adc_port_read(adc_channel, &voltage);
osal_printk("voltage: %d mv\r\n", voltage);
osal_msleep(DELAY_10000MS);
}
/* 如果测量值和实际值有较大差别——确认是否有分压电阻 */
uapi_adc_deinit();
return NULL;
}
static void adc_entry(void)
{
osal_task *task = osal_kthread_create(
(osal_kthread_handler)adc_task, 0,
"AdcTask", ADC_TASK_STACK_SIZE);
if (task != NULL) {
osal_kthread_set_priority(task, ADC_TASK_PRIO);
}
}
app_run(adc_entry);
adc_port_read()直接返回毫伏值。当前 V155 HAL 以 4096 个量化等级和 1800mV 标称上限为基础,并应用芯片校准参数完成换算;如果测量值与外部电压不一致,还需确认板级分压或模拟前端。