深入Linux IIO子系统：以RK3568 SARADC为例，看驱动如何暴露数据给用户空间
深入解析Linux IIO子系统：RK3568 SARADC驱动的数据通路设计
在嵌入式Linux开发中，ADC（模数转换器）作为连接物理世界与数字系统的关键接口，其驱动实现质量直接影响数据采集的准确性和实时性。RK3568芯片内置的SARADC（逐次逼近型ADC）模块通过Linux IIO（Industrial I/O）子系统为开发者提供了标准化的访问接口。本文将深入剖析从硬件寄存器操作到用户空间/sys/bus/iio/devices/iio:deviceX/in_voltage*_raw文件的数据通路全貌，揭示Linux IIO子系统的设计哲学与实现细节。
1. IIO子系统架构概览
Linux IIO子系统是为传感器和转换器设计的统一框架，其核心目标是简化各类模拟信号采集设备的驱动开发。与传统的字符设备驱动不同，IIO采用sysfs接口暴露设备功能，使得用户空间可以通过文件操作完成数据采集，无需频繁的ioctl调用。
IIO核心组件关系图：
硬件寄存器层 → IIO设备驱动层 → IIO核心层 → sysfs接口 → 用户空间 ↑ iio_info结构体RK3568的SARADC驱动（rockchip_saradc.c）典型地体现了这种分层设计。驱动开发者主要关注两个关键部分：
- 硬件寄存器操作（启动转换、读取数据等）
iio_info结构体的实现，特别是read_raw回调函数
这种设计将硬件相关的操作与IIO框架解耦，使得驱动开发更专注于设备特性，而通用功能则由IIO核心统一处理。
2. SARADC硬件与设备树配置
RK3568的SARADC模块具有以下硬件特性：
- 8通道单端输入
- 10位分辨率
- 最高1MS/s采样率
- 1.8V参考电压
设备树配置示例：
saradc: saradc@fe720000 { compatible = "rockchip,rk3568-saradc"; reg = <0x0 0xfe720000 0x0 0x100>; interrupts = <GIC_SPI 93 IRQ_TYPE_LEVEL_HIGH>; #io-channel-cells = <1>; clocks = <&cru CLK_SARADC>, <&cru PCLK_SARADC>; vref-supply = <&vcca_1v8>; status = "okay"; };关键参数说明：
| 参数 | 作用 | 典型值 |
|---|---|---|
| reg | 寄存器物理地址范围 | 0xfe720000~0xfe720100 |
| interrupts | 转换完成中断 | SPI 93 |
| vref-supply | 参考电压 | 1.8V |
驱动通过of_match_table匹配设备树中的compatible字符串，完成设备与驱动的绑定：
static const struct of_device_id rockchip_saradc_match[] = { { .compatible = "rockchip,rk3568-saradc" }, {}, };3. 驱动核心数据结构剖析
SARADC驱动的核心是rockchip_saradc结构体，它封装了所有硬件操作所需的信息：
struct rockchip_saradc { void __iomem *regs; // 寄存器基地址 struct clk *pclk; // APB时钟 struct clk *clk; // ADC工作时钟 struct completion completion; // 转换完成同步机制 struct regulator *vref; // 参考电压源 int uv_vref; // 参考电压值(微伏) u16 last_val; // 最近一次采样值 };在probe函数中，驱动完成了以下关键初始化步骤：
- 映射寄存器地址空间
- 获取并配置时钟
- 设置参考电压
- 初始化IIO设备结构
其中最关键的IIO设备注册过程如下：
indio_dev = devm_iio_device_alloc(&pdev->dev, sizeof(*info)); info = iio_priv(indio_dev); indio_dev->info = &rockchip_saradc_iio_info; indio_dev->channels = rockchip_saradc_iio_channels; indio_dev->num_channels = ARRAY_SIZE(rockchip_saradc_iio_channels); return devm_iio_device_register(&pdev->dev, indio_dev);4. 数据通路关键实现：从硬件到sysfs
当用户空间读取/sys/bus/iio/devices/iio:deviceX/in_voltageY_raw文件时，内核通过以下调用链完成数据采集：
用户read() → IIO核心 → iio_info.read_raw → 硬件寄存器操作具体到RK3568 SARADC驱动，rockchip_saradc_read_raw函数实现了完整的采样流程：
static int rockchip_saradc_read_raw(struct iio_dev *indio_dev, struct iio_chan_spec const *chan, int *val, int *val2, long mask) { struct rockchip_saradc *info = iio_priv(indio_dev); switch (mask) { case IIO_CHAN_INFO_RAW: // 1. 配置采样参数 writel_relaxed(8, info->regs + SARADC_DLY_PU_SOC); // 2. 启动转换 writel(SARADC_CTRL_POWER_CTRL | (chan->channel & SARADC_CTRL_CHN_MASK) | SARADC_CTRL_IRQ_ENABLE, info->regs + SARADC_CTRL); // 3. 等待转换完成 if (!wait_for_completion_timeout(&info->completion, SARADC_TIMEOUT)) return -ETIMEDOUT; // 4. 返回采样值 *val = info->last_val; return IIO_VAL_INT; case IIO_CHAN_INFO_SCALE: // 计算比例因子 *val = info->uv_vref / 1000; *val2 = info->data->num_bits; return IIO_VAL_FRACTIONAL_LOG2; } }中断处理函数则负责在转换完成后更新采样值：
static irqreturn_t rockchip_saradc_isr(int irq, void *dev_id) { struct rockchip_saradc *info = dev_id; // 读取ADC数据寄存器 info->last_val = readl_relaxed(info->regs + SARADC_DATA); info->last_val &= SARADC_DATA_MASK; // 通知等待进程 complete(&info->completion); return IRQ_HANDLED; }5. 性能优化与实践技巧
在实际应用中，SARADC的性能往往受到多种因素影响。以下是几个关键优化点：
时钟配置优化：
# 查看当前ADC时钟频率 cat /sys/kernel/debug/clk/clk_summary | grep saradc # 在设备树中调整时钟频率 &saradc { assigned-clocks = <&cru CLK_SARADC>; assigned-clock-rates = <1000000>; // 1MHz };采样时序调整： 通过修改SARADC_DLY_PU_SOC寄存器的值（默认8个时钟周期），可以优化电源稳定时间：
// 在read_raw回调中调整 writel_relaxed(12, info->regs + SARADC_DLY_PU_SOC); // 增加稳定时间多通道采样策略： 当需要轮询多个通道时，建议采用以下模式避免频繁开关电源：
// 先开启电源 writel(SARADC_CTRL_POWER_CTRL, info->regs + SARADC_CTRL); usleep_range(10, 20); // 短暂延时 // 然后轮流采样各通道 for (i = 0; i < num_channels; i++) { writel(SARADC_CTRL_POWER_CTRL | (chan[i] & SARADC_CTRL_CHN_MASK) | SARADC_CTRL_IRQ_ENABLE, info->regs + SARADC_CTRL); // ...等待采样完成... } // 最后关闭电源 writel(0, info->regs + SARADC_CTRL);用户空间读取优化： 避免频繁打开/关闭sysfs文件，典型的优化读取方式：
// 保持文件描述符打开 int fd_raw = open("/sys/bus/iio/devices/iio:device0/in_voltage3_raw", O_RDONLY); int fd_scale = open("/sys/bus/iio/devices/iio:device0/in_voltage_scale", O_RDONLY); while (1) { pread(fd_raw, buf, sizeof(buf), 0); pread(fd_scale, buf_scale, sizeof(buf_scale), 0); // ...处理数据... usleep(10000); // 10ms采样间隔 }6. 调试与问题排查
当ADC数据异常时，可以按照以下步骤排查：
基础检查清单：
- 确认参考电压稳定（测量VREF引脚）
- 检查输入信号在0-1.8V范围内
- 验证设备树配置正确启用ADC控制器
内核调试手段：
# 查看IIO设备信息 ls /sys/bus/iio/devices/ # 监控中断计数 cat /proc/interrupts | grep saradc # 动态打印调试信息 echo 'file rockchip_saradc.c +p' > /sys/kernel/debug/dynamic_debug/control常见问题处理：
| 现象 | 可能原因 | 解决方案 |
|---|---|---|
| 采样值始终为0 | 电源未开启 | 检查CTRL寄存器的POWER_CTRL位 |
| 数据波动大 | 参考电压不稳 | 增加电源滤波电容 |
| 采样速率低 | 时钟配置不当 | 调整设备树时钟频率 |
| 读取超时 | 中断未触发 | 验证中断线连接和配置 |
7. 进阶应用：与用户空间框架集成
现代Linux系统提供了多种访问IIO设备的高级方式，避免了直接操作sysfs文件：
libiio库应用：
#include <iio.h> struct iio_context *ctx; struct iio_device *dev; struct iio_channel *chn; ctx = iio_create_local_context(); dev = iio_context_find_device(ctx, "rockchip-saradc"); chn = iio_device_find_channel(dev, "voltage3", false); iio_channel_attr_read_raw(chn, "raw", &value); printf("ADC value: %d\n", value);RTKit实时采集： 对于需要确定性的实时应用，可以采用以下模式：
#include <sched.h> // 设置为实时优先级 struct sched_param param = { .sched_priority = 90 }; sched_setscheduler(0, SCHED_FIFO, ¶m); // 内存锁定防止换页 mlockall(MCL_CURRENT | MCL_FUTURE); // 然后进行采集循环 while (1) { struct timespec ts; clock_gettime(CLOCK_MONOTONIC, &ts); // 精确控制采样间隔 const struct timespec interval = { .tv_nsec = 1000000 }; // 1ms read_adc_value(); ts = timespec_add(ts, interval); clock_nanosleep(CLOCK_MONOTONIC, TIMER_ABSTIME, &ts, NULL); }与sysfs_notify配合的事件驱动： 当需要ADC值变化触发应用逻辑时：
int fd = open("/sys/bus/iio/devices/iio:device0/uevent", O_RDWR); write(fd, "add\n", 4); // 触发uevent // 然后通过inotify监控文件变化 int inot_fd = inotify_init(); inotify_add_watch(inot_fd, "/sys/bus/iio/devices/iio:device0/in_voltage3_raw", IN_MODIFY);在嵌入式项目实践中，SARADC的稳定性和准确性往往需要软硬件协同优化。某智能家居项目中，通过将ADC电源与数字电源分离，采样精度提升了约15%；而在另一个工业传感器节点中，调整采样时序参数使抗干扰能力显著增强。这些经验表明，深入理解IIO子系统与硬件特性的结合点，是开发高质量数据采集系统的关键。