RK3588安卓12平台Camera对焦调试：手把手搞定DW9763 VCM马达驱动移植与DTS配置
RK3588安卓12平台Camera对焦调试：DW9763 VCM马达驱动移植与DTS配置实战指南
在嵌入式Android平台的Camera开发中，VCM（Voice Coil Motor）马达驱动的移植与调试是一个关键环节。作为自动对焦功能的核心执行部件，VCM马达的性能直接影响着Camera模组的对焦速度和精度。本文将基于Rockchip RK3588平台（内核5.10）和Android 12系统，深入讲解DW9763这款常见VCM马达的驱动移植过程，从硬件原理到DTS配置，从驱动实现到上层适配，提供一套完整的实战解决方案。
1. VCM马达基础与DW9763特性
VCM马达本质上是一种基于电磁感应原理的直线电机，其工作原理类似于扬声器的音圈。当电流通过线圈时，在永磁场中产生洛伦兹力，带动镜头组件直线移动。DW9763作为一款典型的数字控制VCM驱动器，具有以下核心特性：
- 控制模式：支持Direct Mode和SAC（Smooth Auto-focus Control）模式
- 分辨率：10位DAC输出，提供1024级位置控制
- 电流范围：最大驱动电流120mA，启动电流可配置
- 通信接口：标准I2C协议，地址0x0C
关键寄存器功能：
| 寄存器地址 | 名称 | 功能描述 |
|---|---|---|
| 0x02 | SAC模式控制 | 设置SAC模式等级（1-4） |
| 0x03 | 位置控制 | 10位DAC值，控制马达位置 |
| 0x04 | 周期控制 | 设置SAC模式下的移动时间 |
| 0x05 | 状态寄存器 | 包含忙状态位 |
在实际应用中，SAC模式因其平滑的运动特性而被广泛采用。DW9763支持多种SAC等级：
- SAC1：最平缓的运动曲线，适合精细对焦
- SAC2：平衡速度与平稳性
- SAC3/SAC4：更快的响应速度，适合快速对焦场景
2. 驱动移植关键步骤
2.1 硬件抽象层设计
在Linux内核中，VCM驱动通常实现为V4L2子设备。对于DW9763，我们需要重点关注以下几个核心结构：
static const struct v4l2_subdev_ops dw9763_subdev_ops = { .core = &dw9763_core_ops, }; static const struct v4l2_subdev_core_ops dw9763_core_ops = { .ioctl = dw9763_ioctl, }; static const struct v4l2_ctrl_ops dw9763_ctrl_ops = { .g_volatile_ctrl = dw9763_get_ctrl, .s_ctrl = dw9763_set_ctrl, };关键实现点：
- 位置映射算法：将逻辑位置（0-1023）转换为实际DAC值
static int dw9763_position_to_dac(struct dw9763_device *dev_vcm, u32 pos) { u32 dac; /* 线性映射：pos=0对应最大电流，pos=1023对应最小电流 */ dac = dev_vcm->start_ma * DW9763_DAC_PER_MA; dac += (DW9763_MAX_DAC - dac) * pos / DW9763_MAX_POS; return clamp_val(dac, 0, DW9763_MAX_DAC); }- 运动控制状态机：确保马达运动完成后再接受新指令
static int dw9763_wait_idle(struct i2c_client *client) { int ret; u8 status; int timeout = 100; /* 最大等待10ms */ do { ret = i2c_smbus_read_byte_data(client, DW9763_REG_STATUS); if (ret < 0) return ret; if (!(ret & DW9763_STATUS_BUSY)) return 0; udelay(100); } while (--timeout); return -ETIMEDOUT; }2.2 DTS节点配置详解
RK3588平台对VCM驱动提供了丰富的DTS属性支持，以下是DW9763的典型配置：
dw9763: dw9763@0c { compatible = "dongwoon,dw9763"; reg = <0x0c>; rockchip,vcm-max-current = <120>; /* 单位mA */ rockchip,vcm-start-current = <20>; /* 启动电流 */ rockchip,vcm-rated-current = <90>; /* 额定工作电流 */ rockchip,vcm-step-mode = <3>; /* SAC3模式 */ rockchip,vcm-t-src = <0x20>; /* 运动时间参数 */ rockchip,vcm-t-div = <1>; /* 时钟分频 */ rockchip,camera-module-index = <0>; /* 对应摄像头模组索引 */ };关键参数说明：
vcm-step-mode：SAC模式选择，值1-4对应SAC1-SAC4vcm-t-src：控制马达运动时间，值越大运动越慢vcm-t-div：时钟分频系数，影响运动曲线平滑度
注意：启动电流不宜设置过大，否则可能导致马达启动过冲。建议根据模组规格书中的推荐值设置。
2.3 与Sensor的绑定配置
VCM需要与对应的Camera Sensor绑定才能正常工作，绑定方式如下：
ov13855: ov13855@36 { compatible = "ovti,ov13855"; reg = <0x36>; ... lens-focus = <&dw9763>; /* 关键绑定语句 */ ... };绑定后，Camera HAL层可以通过media controller框架查询到VCM与Sensor的关联关系。
3. Android上层适配
3.1 HAL层配置
在Android的Camera HAL中，需要正确配置AF（Auto Focus）支持模式。修改camera3_profiles.xml：
<Settings> <SupportedHardwareLevel> <level>FULL</level> </SupportedHardwareLevel> <Control> <afAvailableModes> <value>OFF</value> <value>AUTO</value> <value>MACRO</value> <value>CONTINUOUS_VIDEO</value> <value>CONTINUOUS_PICTURE</value> </afAvailableModes> </Control> </Settings>3.2 效果文件配置
在ISP效果配置JSON文件中，需要启用AF相关参数：
{ "af": { "enable": true, "scan_range": [0, 1023], "step_size": 10, "settle_time_ms": 50 } }4. 调试技巧与问题排查
4.1 常用调试命令
- 手动控制马达位置：
# 将马达移动到中间位置 v4l2-ctl -d /dev/v4l-subdev3 --set-ctrl focus_absolute=512- 查询当前状态：
v4l2-ctl -d /dev/v4l-subdev3 --get-ctrl focus_absolute- I2C寄存器调试：
# 读取状态寄存器(0x05) i2cget -y 3 0x0c 0x054.2 常见问题解决方案
问题1：马达无反应
- 检查I2C通信是否正常
- 确认电源供电（通常需要2.8V-3.3V）
- 验证DTS中的reg地址是否正确
问题2：对焦不准确
- 调整
vcm-t-src参数，优化运动曲线 - 检查
start-current和rated-current是否匹配模组规格 - 确认镜头移动范围与逻辑位置映射关系
问题3：马达运动有噪声
- 尝试降低SAC模式等级（如从SAC3改为SAC2）
- 增加
vcm-t-div值，平滑运动曲线 - 检查机械结构是否有干涉
在实际项目中，DW9763的移植往往需要结合具体摄像头模组进行参数微调。建议在初期调试时，先用示波器观察VCM驱动波形，确保电流变化符合预期。同时，不同批次的马达可能存在个体差异，量产时需要做好参数容差设计。