RK3568的ADC按键驱动深度解析：从SARADC硬件到Input子系统的事件上报链路
在嵌入式Linux开发中，ADC按键作为一种常见的硬件输入方式，其驱动实现涉及从硬件采样到用户空间事件上报的完整链路。本文将深入剖析RK3568平台上这一数据流的各个环节，帮助开发者理解背后的工作原理，而不仅仅是停留在配置层面。
1. RK3568 SARADC硬件架构与IIO子系统接口
RK3568内置的SARADC（Successive Approximation Register ADC）控制器支持多通道采样，精度可达10位。在Linux内核中，该硬件通过IIO（Industrial I/O）子系统暴露给上层使用。
1.1 SARADC硬件寄存器配置
SARADC控制器的主要寄存器包括：
- ADC_CTRL：控制ADC的使能、工作模式等
- ADC_DELAY：配置采样保持时间
- ADC_DATA：存储采样结果
典型的初始化代码如下：
static int rockchip_saradc_probe(struct platform_device *pdev) { /* 时钟配置 */ adc->clk = devm_clk_get(&pdev->dev, "saradc"); clk_prepare_enable(adc->clk); /* 寄存器映射 */ adc->regs = devm_platform_ioremap_resource(pdev, 0); /* 中断配置 */ ret = devm_request_irq(&pdev->dev, irq, rockchip_saradc_isr, 0, dev_name(&pdev->dev), adc); /* IIO设备注册 */ indio_dev->name = dev_name(&pdev->dev); indio_dev->info = &rockchip_saradc_iio_info; indio_dev->modes = INDIO_DIRECT_MODE; }1.2 IIO子系统的关键数据结构
IIO子系统通过以下结构体实现硬件抽象：
struct iio_dev { const struct iio_info *info; // 操作回调集合 struct device dev; // 设备模型 int modes; // 设备模式 struct iio_chan_spec *channels; // 通道描述 }; static const struct iio_info rockchip_saradc_iio_info = { .read_raw = rockchip_saradc_read_raw, };在设备树中，ADC通道通常这样定义：
adc: adc@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>; clock-names = "saradc", "apb_pclk"; resets = <&cru SRST_P_SARADC>; reset-names = "saradc-apb"; status = "disabled"; };2. ADC采样值到按键状态的转换机制
ADC按键驱动的核心是将连续的模拟量转换为离散的按键事件，这一过程涉及阈值判断和防抖处理。
2.1 设备树中的按键配置参数
关键参数及其作用：
| 参数名称 | 类型 | 说明 |
|---|---|---|
| press-threshold-microvolt | u32 | 按键按下时的电压阈值（微伏） |
| keyup-threshold-microvolt | u32 | 按键释放时的电压阈值 |
| poll-interval | u32 | 采样间隔（毫秒） |
| linux,code | u32 | 上报的按键键值（如KEY_VOLUMEUP） |
典型配置示例：
adc-keys { compatible = "adc-keys"; io-channels = <&adc 0>; io-channel-names = "buttons"; poll-interval = <100>; keyup-threshold-microvolt = <100000>; button-up { label = "Volume Up"; linux,code = <KEY_VOLUMEUP>; press-threshold-microvolt = <18000>; }; }2.2 adc-keys驱动的工作流程
驱动核心逻辑位于adc_keys_poll()函数：
- 通过IIO接口读取ADC原始值
- 将原始值转换为电压（微伏）
- 比较当前电压与配置阈值
- 确定按键状态变化
- 通过input子系统上报事件
关键代码片段：
static void adc_keys_poll(struct input_dev *input) { struct adc_keys_state *st = input_get_drvdata(input); int i, value, ret; u32 diff, closest = 0xffffffff; int keycode = 0; /* 读取ADC值 */ ret = iio_read_channel_processed(&st->channel, &value); /* 电压比较 */ for (i = 0; i < st->num_keys; i++) { diff = abs(value - st->map[i].voltage); if (diff < closest && diff < st->keyup_threshold) { closest = diff; keycode = st->map[i].keycode; } } /* 上报事件 */ if (keycode && keycode != st->last_key) { input_report_key(input, keycode, 1); input_sync(input); st->last_key = keycode; } else if (!keycode && st->last_key) { input_report_key(input, st->last_key, 0); input_sync(input); st->last_key = 0; } }3. Input Poller机制与定时采样
由于ADC按键没有硬件中断支持，内核采用轮询方式检测状态变化。
3.1 input-poller的实现原理
input-poller子系统主要包含以下组件：
- struct input_poller：维护轮询间隔和工作队列
- input_register_poller()：注册轮询设备
- input_poller_work()：实际执行轮询的回调函数
工作流程时序图：
- 驱动初始化时注册polling设备
- 内核调度器按配置间隔触发工作队列
- 工作队列执行adc_keys_poll()
- 检测到状态变化时上报事件
3.2 关键参数对性能的影响
poll-interval的配置需要考虑以下因素：
- 值太小会导致CPU负载过高
- 值太大会导致按键响应延迟
- 典型值范围：20-200ms
提示：在低功耗场景下，可以考虑动态调整poll-interval，当检测到按键按下时提高采样率，空闲时降低采样率。
4. Input子系统的事件上报链路
最终按键事件需要通过Input子系统传递到用户空间，这一过程涉及多个软件层次。
4.1 内核空间到用户空间的事件传递
完整的事件上报路径：
- 驱动调用
input_report_key()生成事件 - Input核心层处理事件过滤和分发
- 事件写入对应设备的evdev缓冲区
- 用户空间通过
read()系统调用获取事件
关键数据结构：
struct input_event { struct timeval time; __u16 type; __u16 code; __s32 value; };4.2 调试技巧与工具
常用的调试方法：
查看原始ADC值：
cat /sys/bus/iio/devices/iio:device0/in_voltage0_raw监控输入事件：
adb shell getevent -l查看设备信息：
ls /dev/input/ cat /proc/bus/input/devices
常见问题排查表：
| 现象 | 可能原因 | 检查点 |
|---|---|---|
| 按键无响应 | ADC通道配置错误 | 检查设备树io-channels |
| 按键状态不稳定 | 阈值设置不合理 | 测量实际电压并调整阈值 |
| 响应延迟大 | poll-interval过长 | 适当减小采样间隔 |
| 按键粘连 | 防抖逻辑缺失 | 检查驱动中的状态机实现 |
5. 高级调试技巧与性能优化
在实际项目开发中，ADC按键驱动可能会遇到各种边界情况。以下是几个实战中总结的经验：
5.1 动态阈值校准技术
对于环境变化较大的场景，可以采用动态阈值：
static void adc_keys_calibrate(struct adc_keys_state *st) { int i, value; /* 读取基准值 */ iio_read_channel_processed(&st->channel, &value); /* 计算动态阈值 */ for (i = 0; i < st->num_keys; i++) { st->map[i].voltage = value * calibration_factor[i]; } }5.2 低功耗优化策略
通过以下方式降低功耗：
- 在系统空闲时增大poll-interval
- 使用IIO的缓冲模式批量读取
- 合理配置ADC的采样时钟
adc-keys { poll-interval = <200>; low-power-poll-interval = <1000>; wakeup-source; };5.3 多按键组合检测
扩展驱动以支持组合键检测：
static void adc_keys_poll_combination(struct input_dev *input) { /* 检测多个ADC通道 */ for (i = 0; i < st->num_channels; i++) { iio_read_channel_processed(&st->channels[i], &values[i]); /* 组合键逻辑判断 */ if (values[0] > threshold0 && values[1] > threshold1) { input_report_key(input, KEY_COMBO, 1); } } }
)