LISA ADC 温度传感器读取示例

功能说明

本示例演示如何使用 LISA ADC 驱动读取内部温度传感器并进行温度计算。

硬件连接

无需外部硬件连接。

通道 7: 芯片内部温度传感器（无需配置PINMUX）

示例内容

初始化 ADC 设备
配置温度传感器通道参数（1.2V 参考电压，10-bit 分辨率）
设置温度校准参数
循环读取温度传感器通道的原始值
将原始值转换为电压值并计算温度

编译

重要提示：在编译前，请先确认您使用的开发板型号。SDK 目前支持以下开发板：

arcs_evb - ARCS EVB 评估板
arcs_mini - ARCS Mini 开发板

根据您的开发板型号，选择对应的编译命令：

在示例目录下执行编译:

# 使用 arcs_evb 开发板
./build.sh -C -DBOARD=arcs_evb

# 或使用 arcs_mini 开发板
./build.sh -C -DBOARD=arcs_mini

Note

如果在 SDK 根目录执行，需要指定示例路径:

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

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

Note

确保已安装对应的工具链。

烧录

编译完成后，使用 SDK tools 目录下的 cskburn 工具烧录固件:

./tools/burn/cskburn -s /dev/ttyUSB0 -b 3000000 0x0 build/arcs.bin -C arcs

Note

烧录参数说明：

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

注意事项：

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

预期输出

[I][sample] === LISA ADC Temperature Sensor Read Example ===
[I][sample] adc0 device ready
[I][sample] Temperature sensor channel 7 configured: 1.2V reference, 10-bit resolution
[I][sample] Start reading temperature sensor (channel 7)...

[I][sample] Temperature: raw=0x258 (600), voltage=0.703125V, temp=29.45 C
[I][sample] Temperature: raw=0x259 (601), voltage=0.704297V, temp=29.73 C
[I][sample] Temperature: raw=0x25a (602), voltage=0.705469V, temp=30.01 C
...

参数说明

参考电压: 1.2V（LISA_ADC_REF_VDD_1V2）
分辨率: 10-bit（0-1023）
测量范围: 0-1.2V
校准温度: 29.8℃（示例值，需根据实际环境调整）
校准电压: 0.73125V（示例值，需根据实际测量调整）
温度计算公式: temperature = temp_cal + (temp_cal + 273.15) / voltage_cal × (voltage - voltage_cal)

核心 API

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

关键代码

/* 配置温度传感器通道 */
lisa_adc_channel_config_t temp_config = {
    .reference = LISA_ADC_REF_VDD_1V2,
    .resolution = LISA_ADC_RESOLUTION_10BIT,
};
lisa_adc_channel_setup(adc_dev, 7, &temp_config);

/* 设置校准参数 */
temp_calibration_t temp_cal = {
    .temp_cal = 29.8f,          // 校准温度
    .voltage_cal = 0.73125f     // 校准点电压
};

/* 读取并计算温度 */
uint16_t temp_raw = 0;
lisa_adc_read(adc_dev, 7, &temp_raw);

float voltage = adc_raw_to_voltage(temp_raw, 1.2f, 10);
float die_temp = calc_temperature(&temp_cal, voltage);

注意事项

内部通道: 温度传感器是内部通道 7，无需配置 GPIO 引脚
推荐参考电压: 温度传感器建议使用 1.2V 参考电压
校准参数: 示例中的校准参数需要根据实际测量环境进行调整
自热效应: 芯片工作时会产生热量，测得的温度高于环境温度
单点校准: 本示例使用单点校准，精度有限，如需更高精度可使用多点校准