ADC 基础读取示例

功能说明

本示例演示如何使用 LISA ADC 驱动读取模拟信号并转换为电压值。

硬件连接

ARCS EVB PB04: ADC 通道2输入引脚（3.6V 参考配置）
Venusa RD EVB PB03: ADC 通道2输入引脚（VDD_IO/3 + 3倍缓冲，默认按 3.3V VDD_IO）

示例内容

初始化 ADC 设备
配置板级 ADC 引脚为模拟输入（ARCS EVB: PB04，Venusa RD EVB: PB03）
查询 ADC 平台能力并检查目标参考电压
配置 ADC 通道参数（ARCS 通道2: 3.6V；Venusa 通道2: VDD_IO/3 + 3倍缓冲）
循环读取对应 ADC 通道的原始值并转换为电压值

编译

重要提示：编译前需要先确认当前示例支持的目标板型，然后将板型标识传给 -DBOARD。请按以下方式选择：

确认示例限制：查看当前示例 README 中的硬件连接和注意事项，确认是否限定板型。
参考示例配置：查看相关示例目录下的 sample.yaml，确认支持的板型。
填写板型标识：SDK 内置板型的标识为 boards/ 下的目录名。例如实际使用的板型目录为 boards/<板型名称>/，则编译参数填写为 -DBOARD=<板型名称>。

在 SDK 根目录执行编译，并将命令中的 <示例路径> 和 <板型名称> 替换为实际值。

Linux 使用 build.sh：

# 通用命令
./build.sh -C -S samples/<示例路径> -DBOARD=<板型名称>

# 示例：使用 arcs_evb 开发板
./build.sh -C -S samples/<示例路径> -DBOARD=arcs_evb

Windows PowerShell 使用 build.ps1：

# 通用命令
.\build.ps1 -C -S samples/<示例路径> -DBOARD=<板型名称>

# 示例：使用 arcs_evb 开发板
.\build.ps1 -C -S samples/<示例路径> -DBOARD=arcs_evb

Note

确保已安装对应平台的工具链和 ListenAI 开发工具包。Windows 环境请先执行 .\env.ps1 或直接使用 .\build.ps1 自动加载环境。

注意事项：-DBOARD 填写的是板型标识，不是芯片系列名称。如果示例有板型专用配置或额外编译参数，以示例 README 中的说明为准。

烧录

编译完成后，使用 SDK tools/burn 目录下的 cskburn 工具烧录固件。请先根据目标板型和当前示例确定芯片系列、串口设备、烧录地址和固件路径。

Linux：

# 通用命令
./tools/burn/cskburn -C <芯片系列> -s <串口设备> -b 3000000 <烧录地址> <固件路径>

# 示例：使用 arcs_evb 开发板
./tools/burn/cskburn -s /dev/ttyUSB0 -b 3000000 0x0 build/arcs.bin -C arcs

Windows PowerShell：

# 通用命令
.\tools\burn\cskburn.exe -C <芯片系列> -s <串口号> -b 3000000 <烧录地址> <固件路径>

# 示例：使用 arcs_evb 开发板
.\tools\burn\cskburn.exe -C arcs -s COM7 -b 3000000 0x0 .\build\arcs.bin

Note

烧录参数说明：

-s /dev/ttyUSB0 / -s COM7：串口设备路径，需要根据实际情况修改 - Linux 系统：通常是 /dev/ttyUSB0 或 /dev/ttyACM0 - 可通过 ls /dev/tty* 命令查看可用串口设备 - Windows 系统：通常是 COM7、COM8 等，可在“设备管理器”的“端口”中查看 - 不同开发板或 USB 转串口芯片可能使用不同的设备名
-b 3000000：烧录波特率（3Mbps）
0x0：烧录起始地址
build/arcs.bin / .\build\arcs.bin：编译生成的固件路径
-C arcs：芯片类型

注意事项：

确保开发板已正确连接到电脑
如果无法识别串口设备，请检查 USB 连接线是否正常，或尝试其他 USB 端口

预期输出

ARCS EVB：

[I][sample] === LISA ADC read example ===
[I][sample] adc0 device ready
[I][sample] Capabilities: channels=0x000000ff, references=0x0000001f, default=0
[I][sample] Channel 2 configured: 3.6V reference, 10-bit resolution
[I][sample] Start reading ADC channel 2...

[I][sample] Channel 2: raw=0x0123 ( 291), voltage=1022 mV
[I][sample] Channel 2: raw=0x0125 ( 293), voltage=1029 mV
[I][sample] Channel 2: raw=0x0124 ( 292), voltage=1025 mV
...

Venusa RD EVB：

[I][sample] === LISA ADC read example ===
[I][sample] adc0 device ready
[I][sample] Capabilities: channels=0x000000c7, references=0x0000006c, default=2
[I][sample] Channel 2 configured: VDD_IO/3 with 3x buffer reference, 10-bit resolution
[I][sample] Start reading ADC channel 2...

[I][sample] Channel 2: raw=0x0123 ( 291), voltage= 937 mV
[I][sample] Channel 2: raw=0x0125 ( 293), voltage= 944 mV
[I][sample] Channel 2: raw=0x0124 ( 292), voltage= 941 mV
...

参数说明

ARCS 参考电压: 3.6V（LISA_ADC_REF_VDD_3V6）
Venusa 参考电压: LISA_ADC_REF_VDD_IO_AUTO_MUL3，有效量程为实际 VDD_IO
分辨率: 10-bit（0-1023）
测量范围: ARCS 为 0-3.6V；Venusa 为 0-VDD_IO（示例按 3.3V）
电压计算: 使用 LISA_ADC_RAW_TO_MV(raw_value, ADC_REFERENCE_MV, 10) 宏转换
计算公式: voltage(mV) = (raw_value × ADC_REFERENCE_MV) / 1024

核心 API

API	说明
`lisa_device_get()`	获取 ADC 设备
`lisa_adc_get_capabilities()`	获取平台支持的通道和参考电压
`lisa_adc_channel_setup()`	配置 ADC 通道参数（参考电压、分辨率）
`lisa_adc_read()`	读取 ADC 通道原始值

关键代码

/* 先查询当前平台能力 */
lisa_adc_capabilities_t capabilities;
lisa_adc_get_capabilities(adc_dev, &capabilities);

/* ADC_REFERENCE 由板型选择：ARCS=3.6V，Venusa=VDD_IO/3 + 3倍缓冲 */
lisa_adc_channel_config_t ch_config = {
    .reference = ADC_REFERENCE,
    .resolution = LISA_ADC_RESOLUTION_10BIT,
};
lisa_adc_channel_setup(adc_dev, ADC_CHANNEL, &ch_config);

/* 读取ADC值 */
uint16_t raw_value = 0;
lisa_adc_read(adc_dev, ADC_CHANNEL, &raw_value);

/* 转换为电压值 */
uint32_t voltage = LISA_ADC_RAW_TO_MV(raw_value, ADC_REFERENCE_MV, 10);

注意事项

输入电压范围: 不得超过当前平台和参考配置允许的有效量程
通道配置: 必须先调用 lisa_adc_channel_setup() 配置通道参数后再读取
引脚配置: 使用外部通道前必须先将引脚配置为 ADC 模拟输入模式
平台差异: ARCS 与 Venusa 支持的参考源不同，应以能力查询结果为准
Venusa 通道范围: Venusa 仅支持外部通道 0-2，本示例使用通道 2