简介AN41908自动聚焦芯片驱动源码包为嵌入式开发者提供一套基于SPI接口的完整控制实现覆盖芯片初始化、命令交互、传感器数据处理与镜头电机驱动等关键环节适合从事摄像头模组驱动、光学变焦与安防监控等对焦相关项目的开发或调试人员具备一定C语言和SPI协议基础即可快速上手。包内共9个文件包含6个C源文件、2个H头文件与1个MakefileC源文件负责底层SPI读写、寄存器配置、聚焦/变焦控制及读写辅助函数头文件用于接口和数据结构声明Makefile为编译构建提供模板整个压缩包仅16KB便于阅读和移植。目前已有1203人学习下载。通过研读源码可以理解聚焦算法的调用流程、异常恢复机制和时序处理细节当出现通信失败、聚焦偏差等问题时提供直接排查思路开发者还能根据具体硬件调整SPI参数、修改寄存器初值或增减命令处理分支为提升聚焦速度与精度预留了清晰的扩展空间。1. AN41908 这颗聚焦驱动芯片为什么值得自己重写一遍 SPI 驱动手机摄像头模组装到样机上预览画面始终发虚自动对焦来回扫也合不上焦。这种问题十有八九不在图像算法而在镜头马达驱动AN41908 是一颗通过 SPI 接口写入 DAC 值来控制音圈电机VCM位置的聚焦驱动芯片时序差一点镜头就停在错误位置。网络上流传的 an41908a.zip 驱动源码包给了一版参考实现但直接拷到自己的板子上经常跑不通——CS 引脚归属、SPI 时钟极性、上电顺序任何一个对不上芯片就静默无响应。下面按一线调试的顺序把 AN41908 的 SPI 驱动从协议结构、寄存器布局、STM32 HAL 库实现到波形验证完整走一遍。适合正在调摄像头模组对焦、或者想真正吃透一份 SPI 驱动源码的嵌入式工程师。2. AN41908 的 SPI 通信帧与寄存器布局先看时序再碰驱动源码2.1 引脚与最小硬件连接在写任何代码之前先确认板上 AN41908 的实际接线。常见参考设计里AN41908 对外连接包括 CS、SCK、SDI 三个控制信号加上 VDD、VM 和地。注意这颗芯片在很多方案里只写不读SDO 引脚要么不引出要么只用来做状态输出因此 SPI 可以按发送-only 模式处理这对 HAL 库配置有直接影响。引脚方向说明CS输入片选低有效一帧 16 bit 期间必须保持低电平SCK输入SPI 时钟空闲电平与采样沿由 CPOL/CPHA 决定SDI输入串行数据输入高位在前SDO/ST输出常见实现不读调试时可接逻辑分析仪观察状态VDD电源逻辑电源通常 1.8V~3.3V与 MCU 电平域一致VM电源马达电源VCM 驱动电压一个经常被忽略的点VDD 和 VM 的上电顺序没有严格要求时很多源码包里的初始化都默认 CS 在器件未上电时保持高。如果 MCU 先跑起来、CS 由 GPIO 控制但默认输出低AN41908 在电源爬坡阶段就可能被误选中把总线上的随机电平当命令吃进去之后表现就是怎么配置都不动。常见的做法是把 CS 设为推挽输出并默认拉高等 VDD 稳定之后再开始第一次通信。2.2 16 位通信帧6 位地址加 10 位数据AN41908 的控制接口按 16 bit 一帧组织CS 拉低后由 SCK 驱动SDI 上的第一位是地址最高位之后是数据位。参考驱动源码里最常见的帧结构是 6 位寄存器地址加 10 位 DAC 数据CS \______________________/ SCK _/\/\/\/\/\/\/\/\/\/\/\_ SDI A5 A4 A3 A2 A1 A0 D9 D8 D7 D6 D5 D4 D3 D2 D1 D0地址位共 6 bit最多寻址 64 个寄存器而 10 bit 数据位正好对应一颗 10 位 DAC 的输出范围。这样设计的好处是写 DAC 值只需要一帧不需要先传高字节再传低字节两次操作配合连续聚焦控制可以降低两次写之间的延迟。实际操作中要注意不同版本的驱动源码对数据位的位置定义可能有偏差常见的是地址在前数据在后但也存在部分器件把 16 bit 拆成两个 8 bit 寄存器、要求先写低字节后写高字节的格式。判断依据很简单看初始化序列里写控制寄存器时给的是不是带使能位语义的值比如0x0001或0x0003。2.3 控制寄存器与 DAC 数据寄存器怎么定AN41908 的寄存器布局以数据手册为准但参考驱动里通常能归纳出两组固定用途一组是控制/电源管理寄存器负责 DAC 使能、待机、保护状态另一组是 DAC 数据寄存器写入目标位置。下面列的是我在几种硬件上见过且能通用的语义寄存器常见地址位域说明控制0x00bit0 上电/待机bit1 DAC 使能先写使能位再操作数据寄存器DAC 数据0x02bit9:0 目标位置0 是行程一端1023 是另一端方向以模组绕线为准状态/保护0x03bit2 短路读不到时用电流钳测 VM 判断移植 an41908a.zip 里的源码时最需要核对的就是这两组地址。不同批次的模组有时候会用一个额外的 GPIO 做硬件使能这种情况下控制寄存器的使能位可以不写但千万不要省掉上电后的第一次写控制寄存器操作哪怕只是写回同一个值也能让内部状态机从未知状态恢复。驱动代码里直接搜0x00、0x02这两个地址配合初始化注释能很快确认这份源码对应的寄存器版本。2.4 时序参数哪些可以放宽哪些不能SPI 频率不是越快越好。规格书给出的最小 SCK 周期对应最高时钟频率但上拉电阻、走线长度和模组 FPC 的寄生电容会明显拉低实际可用的频率上限。驱动源码里如果写的是 10 MHz而你的 FPC 排线有十几厘米大概率在高温或低电压下偶发写失败。调试阶段先按 1 MHz 跑通再逐步提高。CS 释放后的保持时间一般没有严格下限但 CS 拉低到第一个 SCK 上升沿的建立时间需要留出GPIO 模拟 SPI 时容易在这两个时间上翻车。提示硬件 SPI 由外设产生 SCK建立时间通常足够用 GPIO 模拟时必须主动在 CS 拉低后延时几百纳秒再翻转时钟。协议和寄存器定清楚之后下一步就是把它落到 STM32 HAL 库的 SPI 外设上这也是标题里“SPI 驱动”的真正落地位置。3. 基于 STM32 HAL 库的 AN41908 SPI 驱动实现与移植3.1 CubeMX 里 SPI 外设的配置参数AN41908 的时序在 CubeMX 里对应一组明确参数。在 STM32F103 上用 SPI2 做发送-only 主机基本配置如下CubeMX 配置项推荐值说明ModeTransmit Only Master不需要 SDO省一根线Hardware NSSDisableCS 用普通 GPIO 手动控制避免片选自动翻转Data Size8 Bit16 bit 帧拆成两个字节发送First BitMSB First与帧格式一致CPOLLow空闲时钟为低按手册时序图确认CPHA1 Edge第一个边沿采样即 SPI Mode 0Prescaler32 或 6472 MHz 主频下对应 2.25 MHz 或 1.125 MHz关于 CPOL/CPHAAN41908 数据手册的时序图一般会画出“SCK 空闲低、SDI 在 SCK 上升沿被采样”的波形对应 Mode 0。如果抄来的源码里用软件 SPI 每次都成功而硬件 SPI 失败优先怀疑的就是这里配成了 Mode 3。注意 HAL 库对 Mode 0 的定义是SPI_POLARITY_LOW加SPI_PHASE_1EDGE两个参数在 CubeMX 下拉框里的名字不同但含义一致。3.2 最小驱动源码寄存器写入与初始化写寄存器是整份驱动的核心。下面的实现按 8 bit 数据宽度发送两个字节由 CS 引脚包住整个 16 bit 帧先拉低 CS发送高字节再发送低字节最后拉高 CS。// an41908.h #define AN41908_CS_PORT GPIOB #define AN41908_CS_PIN GPIO_PIN_12 #define AN41908_CS_LOW() HAL_GPIO_WritePin(AN41908_CS_PORT, AN41908_CS_PIN, GPIO_PIN_RESET) #define AN41908_CS_HIGH() HAL_GPIO_WritePin(AN41908_CS_PORT, AN41908_CS_PIN, GPIO_PIN_SET) static inline void an41908_write_reg(uint8_t addr, uint16_t data) { uint16_t frame ((uint16_t)(addr 0x3F) 10) | (data 0x03FF); uint8_t tx[2]; tx[0] (uint8_t)(frame 8); // 地址 6 bit 数据高 2 bit tx[1] (uint8_t)(frame 0xFF); // 数据低 8 bit AN41908_CS_LOW(); HAL_SPI_Transmit(hspi2, tx, 2, 10); AN41908_CS_HIGH(); }逻辑说明addr 0x3F把地址限制在 6 bit 内左移 10 位后与 10 位数据拼成 16 bit 帧。HAL_SPI_Transmit的最后一个参数 10 是超时毫秒数正常发送一帧只需要几十微秒超时只用于保护一旦出现超时返回值先查 SPI 外设有没有被其他任务占用再查 NSS 是不是被硬件控制反复拉低。CS 拉高放在发送完成之后是因为硬件 SPI 的发送完成标志表示移位寄存器已经吐完但最后一 bit 可能还在线上此时立刻拉高 CS 可能导致最后一位被截断。稳妥做法是发送后加一个极短的延时再拉高 CS或者依赖HAL_SPI_Transmit返回后的指令开销顶上。3.3 初始化序列与使能位初始化要做三件事确认 CS 初始为高、写入控制寄存器使能 DAC、把镜头摆到中间位置。中间位置用 DAC 值 512避免上电瞬间 VCM 被推到一端顶死。uint8_t an41908_init(void) { AN41908_CS_HIGH(); // 上电期间 CS 必须保持高 HAL_Delay(10); // 等 VDD 稳定 an41908_write_reg(0x00, 0x03); // 控制寄存器: DAC 使能 正常工作 HAL_Delay(1); an41908_write_reg(0x02, 512); // DAC 数据寄存器: 镜头回中 return 0; }初始化里的 10 ms 延时不是拍脑袋VCM 驱动芯片内部有基准电压和电荷泵VDD 稳定后还需要几个毫秒建立内部参考。如果上电后立刻写寄存器时序上命令已经发出但 DAC 输出可能仍是随机值。把0x03拆开看bit0 是上电/待机位bit1 是 DAC 输出使能位先把这两个位置 1 再写数据寄存器才能保证后续的聚焦命令真正作用到 VM 输出上。3.4 移植到其它 MCU 时保留哪一层an41908a.zip 这类源码包在移植时最容易犯的错误是把 SPI 外设的寄存器操作和驱动逻辑混在一起。我一般会保留三层结构最底层是an41908_write_reg这个单帧写函数它只依赖一个能发两字节的 SPI 接口中间层是初始化序列它只依赖底层写函数和延时最上层是聚焦控制 API。换平台时只改最底层把HAL_SPI_Transmit换成对应平台的发送函数或者换成 GPIO 模拟 SPI 的四条语句上层代码一行都不用动。// 没有硬件 SPI 时用 GPIO 模拟帧格式与硬件版完全一致 void an41908_write_reg_gpio(uint8_t addr, uint16_t data) { uint16_t frame ((uint16_t)(addr 0x3F) 10) | (data 0x03FF); AN41908_CS_LOW(); for (int i 15; i 0; i--) { HAL_GPIO_WritePin(AN41908_SCK_PORT, AN41908_SCK_PIN, GPIO_PIN_RESET); if (frame (1U i)) { HAL_GPIO_WritePin(AN41908_SDI_PORT, AN41908_SDI_PIN, GPIO_PIN_SET); } else { HAL_GPIO_WritePin(AN41908_SDI_PORT, AN41908_SDI_PIN, GPIO_PIN_RESET); } HAL_GPIO_WritePin(AN41908_SCK_PORT, AN41908_SCK_PIN, GPIO_PIN_SET); } AN41908_CS_HIGH(); }这段模拟代码的好处是每一位的时序都透明可调调试初期可以用它排除“硬件 SPI 配置不对”这个变量。注意循环里先拉低 SCK、再摆数据、再拉高 SCK保证数据在 SCK 上升沿之前已经建立正好对应 Mode 0 的采样时刻。模拟方式下 CS 拉低到第一个上升沿之间有天然的数据建立时间前面提到的截断问题在这段代码里反而不容易出现。4. AN41908 聚焦控制实战DAC 数值、镜头位置与扫焦流程4.1 10 位 DAC 与镜头行程的换算AN41908 的 10 位 DAC 输出 0~1023 共 1024 个位置对应的 VM 电压从接近 0 到接近 VM 电源。镜头位移与 DAC 值在 VCM 的线性区基本成比例但不建议直接用“位移 DAC × 步长”做闭环。原因有两个一是 VCM 存在磁滞正向走到 512 和反向走到 512 对应的镜头位置不完全相同二是模组弹簧有回差运动方向改变时先要克服静摩擦。因此驱动层只负责把位置值转换成 DAC 值校准由模组厂在产线上做。uint16_t an41908_pos_to_dac(uint16_t pos_um, uint16_t max_um) { uint32_t dac; if (pos_um max_um) { return 1023; // 限幅到行程终点 } dac ((uint32_t)pos_um * 1023U) / max_um; return (uint16_t)dac; }参数说明pos_um是目标位移微米数max_um是该模组的最大行程两个值都来自模组规格书。换算公式是线性的但计算时必须用 32 位中间变量否则pos_um * 1023在 16 位 MCU 上会溢出。4.2 积分式移动从当前值走到目标值直接写目标 DAC 值会让 VCM 瞬间加电镜头猛冲到目标位置后震荡照片拍出来是糊的。比较好的做法是分成几十个小步每步写一次 DAC 寄存器并做短暂延时。这个延时就是 VCM 的机电响应时间通常每步 0.5 ms~2 ms具体值要看镜头整个行程走完需要多久。void an41908_focus_move(uint16_t target, uint16_t step_ms) { uint16_t current; int16_t diff; int16_t step; current an41908_current_dac; // 驱动层维护的当前位置 diff (int16_t)target - (int16_t)current; while (diff ! 0) { step (diff 8) ? 8 : ((diff -8) ? -8 : diff); current (uint16_t)step; an41908_write_reg(0x02, current); HAL_Delay(step_ms); diff (int16_t)target - (int16_t)current; } an41908_current_dac target; }逻辑说明每次最多移动 8 个 LSB避免单帧写入造成的电压跳变。真正起作用的是diff的符号和大小判断目标值大于当前值时diff为正、向前走反之向后走。驱动层维护的an41908_current_dac必须在初始化时同步为 512否则首次移动会从 0 开始推镜筒会先撞向远端。step_ms在 0.5 到 2 之间取扫焦模式下应改为不延时版本交给上层算法控制节奏。4.3 扫焦与回中和寄存器写入的顺序自动对焦算法经常要执行“回中 → 扫焦 → 定位”三段动作。回中不是直接写 512 就完事VCM 靠弹簧回位方向不同回位特性不同。常见做法是先向当前方向的相反方向多走一段比如 32 个 LSB再回到中间位置这样弹簧受力方向一致回位更稳定。扫焦时则要连续改变 DAC 值并读取图像清晰度评价函数驱动层只需要提供一个无延时的写位置接口void an41908_scan_step(int16_t offset) { uint16_t pos an41908_center_dac offset; an41908_write_reg(0x02, pos); // 立即生效无内部延时 }这一层交给对焦算法后驱动代码本身已经完整。剩下的关键是验证用逻辑分析仪看实际波形确认每一帧都按预期落在 AN41908 的采样沿上。5. 用逻辑分析仪对照 AN41908 SPI 波形排除无响应的三个高频原因5.1 抓一帧写寄存器波形不管驱动代码写得再小心最后都要用逻辑分析仪确认实际时序。最低采样率按 SCK 频率的 10 倍以上选比如 SCK 配置 1 MHz采样率至少设 16 MHz 或 24 MHz。接三根线CS 到通道 0、SCK 到通道 1、SDI 到通道 2触发条件设为 CS 下降沿。以 sigrok-cli 为例sigrok-cli -d fx2lafw -c samplerate24m -t 0r \ -A spics:0,sck:1,mosi:2 -o an41908.sr -a参数说明-d fx2lafw是逻辑分析仪的驱动名按实际设备替换-t 0r表示在通道 0 的下降沿触发-A附加 SPI 协议解码器把 SDI 上的比特流解析成地址和数据省去手工数 16 个 bit 的工作。抓完一帧后对照手册时序图先看 CS 是否包住了全部 16 个 SCK 沿再看解码器输出的值是否和代码里写入的 frame 一致。5.2 无响应的三个高频原因第一个原因是 CPOL/CPHA 与实际采样沿不匹配。波形上表现为 SDI 数据变化点紧贴着 SCK 采样沿解码器偶尔解出正确值、偶尔差一位。解决办法是直接改 CubeMX 里的 CPOL 和 CPHA两个配置各试一次能稳定解码出使能值和目标位置值的那组就是对的。第二个原因是 CS 提前释放。波形图上如果看到 CS 在 SCK 最后一个下降沿之后立即拉高而且发送函数用的 DMA 或中断模式最后一位很可能没发完。硬件 SPI 发送函数返回时移位寄存器已空但 SCK 的最后一个边沿可能还在线上加一个 1 us 左右的延时再拉 CS。第三个原因是写入顺序不对DAC 命令先于使能位到达。逻辑分析仪上能看到正确的帧寄存器地址也对但 VM 输出始终不变。此时在初始化序列里把控制寄存器写入提前、延长 HAL_Delay或者把写0x00的操作重复一次。AN41908 内部状态机上电后并不总是处于默认态重复写一次使能位是成本最低的收敛手段。最后再给一个排查建议把 CS 和 SCK 两根线在探头端分别就近接地避免 FPC 上的串扰让逻辑分析仪看到假的毛刺。波形干净了驱动源码和硬件电路才能对应上聚焦控制才算真正闭环。本文还有配套的精品资源点击获取