AN41908聚焦驱动开发实战：从寄存器到设备树的完整指南

简介：AN41908自动聚焦芯片的SPI驱动源码，专为需要精确控制镜头对焦的嵌入式开发场景设计。该驱动承担操作系统与AN41908之间的指令翻译：初始化时配置SPI时钟频率与数据模式，运行中通过读写寄存器下发聚焦命令并解析位置反馈，同时处理通信异常与电机限位等边界情况。压缩包共9个文件，包含6个C语言源码、2个头文件和1个Makefile，整体仅16KB，模块划分清晰，核心通讯、变焦控制、聚焦执行等功能相互独立，头文件统一对外接口，便于按需修改与移植。已有1204人学习下载。通过研读这份源码，开发者可快速理解自动聚焦驱动的完整工作流，掌握寄存器级控制与SPI通讯调试技巧，并能基于现有代码扩展自定义聚焦策略，适合驱动开发入门及镜头模组调试场景。

1. AN41908 聚焦驱动：一包源码和一颗芯片，怎么把它跑成能用的镜头控制

拿到 an41908a.zip 的人，多半正被镜头聚焦折腾：电机有了，驱动芯片用的是 AN41908，厂商给了一个驱动源码包，但解压之后不知道先看哪个文件、改哪一行、怎么验证它真的在工作。这个包在聚焦方案里的角色一句话能讲清：主控通过 SPI 总线下发目标位置，AN41908 把位置指令转成聚焦电机上一段可控的电流，让镜头停在正确的焦点上。适合这几类人：做摄像头模组对焦的嵌入式工程师、调内窥镜光学系统的现场应用工程师，以及自动对焦镜头产线上要复测驱动一致性的人。下面按一线做法拆开讲：先看懂寄存器与时序，再把源码编进内核，理清位置写入路径，最后给出最常见的几种翻车现场和对应的验证手段。

2. 读懂 AN41908 的寄存器模型与 SPI 时序：写对第一帧前必须搞清的三件事

驱动源码能不能用，不取决于代码写得多漂亮，取决于你对你手上的这颗芯片理解到什么程度。SPI 驱动看起来就那一两百行，但如果寄存器模型理解错了，编进去之后电机只会抖动，甚至完全不动。所以先别急着编译，把三件事搞清楚：芯片在系统里的位置、寄存器怎么分类、SPI 帧怎么写。

2.1 聚焦驱动芯片在系统里的位置：主控、SPI 总线与电机的三角关系

这套系统的三角关系非常清晰：主控是 SPI Master，负责发命令；AN41908 是 SPI Slave，负责解析命令并驱动电机；电机是执行机构，把电流变成镜头位移。主控不直接操作电机功率线，而是通过 SPI 把目标位置写进芯片，芯片内部再做功率放大和电流控制。这个设计的好处是，主控的 GPIO 资源省下来了，而且功率部分离逻辑器件远，不会因为电机启停把主控拉复位。

选 SPI 而不是 I2C，对这个场景有实际理由：SPI 是全双工，能在一笔事务里同时完成“发命令”和“收状态”；帧结构灵活，寄存器地址和数据可以按芯片需求任意拼；速率高，写一次位置指令在微秒级完成，对聚焦这种需要频繁微调的场合更跟手。I2C 只有两根线，抗干扰要求高，速率还被上拉电阻卡住。当然这不是说 I2C 不能用，只是 AN41908 这类聚焦驱动，SPI 是更常见也更稳的选择。

调试时理解这层关系，能帮你快速定位问题。电机不动，先看 SPI 通没通；电机在动但位置不对，再看寄存器值换算；电机发热，查驱动电流配置。每一类现象都对应着三角关系里的一个具体环节，不会毫无头绪。

2.2 寄存器模型先分类：ID 寄存器、配置寄存器、位置与状态寄存器

AN41908 这类芯片的寄存器看着一大堆，实际按功能分四类就够用，不必一上来就把每个地址背下来。这四类分别是 ID 与版本类、控制类、配置类、位置与状态类。它们各自的读写属性和调试作用完全不同。

我拿到一个驱动包，第一步永远是找 ID 寄存器。因为 SPI 驱动最怕的就是“看起来在通信，实际上全是错的数据”，ID 寄存器只读且内容是固定的，只要主控能把这个值读回来，就说明硬件连接、SPI 模式、帧格式、片选时序全都对了。这一步验证通过，后面才值得往下调。

位置与状态寄存器是聚焦控制的核心。目标位置寄存器负责接收新的位置指令，状态寄存器里的 BUSY 位告诉主控上一次移动是否结束。这两个寄存器配合不好，就会出现命令被吞、镜头原地不动或者走到一半停住的问题，后面第 4 章会详细说。

2.3 第一帧怎么写：SPI 模式、帧长度与片选时序

写第一帧之前，必须先确认三个参数：SPI 模式、帧长度、片选时序。这三个参数任何一个不对，写进去的寄存器全部无效。而且它们不是靠猜的，要从数据手册的时序图里读，或者直接拿逻辑分析仪抓另一块已知正常的板子。

SPI 模式由 CPOL 和 CPHA 决定，也就是时钟空闲电平和数据采样沿。AN41908 这类芯片常见的是 Mode 0 或 Mode 3，但不同批次封装可能不同。设备树里对应spi-cpol和spi-cpha两个属性，如果驱动源码里硬编码了 mode，要在probe里设置spi->mode。这里我吃过亏：Mode 0 能读回 0xFF，看着没反应，换成 Mode 3 帧全乱了，最后用逻辑分析仪对时序才确定芯片实际是按 Mode 0 采样。

帧长度多数是 16 位或 24 位。16 位帧常见于地址 8 位、数据 8 位的简单封装；24 位帧则是地址 8 位、数据 16 位，聚焦位置分辨率超过 8 位时必然用这个。驱动源码里的buf[0]、buf[1]、buf[2]三段就是典型的 24 位帧，高字节先发，片选拉低后依次移出。

片选时序也有讲究：CS 拉低后要留出建立时间再送时钟，传输结束后 CS 拉高，两次 CS 之间要有足够的释放时间。有些初学者直接连着发多帧，帧与帧之间 CS 没拉高，芯片会把两帧当成一帧解析。这个问题在低速时钟下不明显，把 SPI 时钟提上去之后立刻暴露。

提示：如果数据手册暂时不在手边，先按 1MHz 时钟、Mode 0、24 位帧起步，然后用“读 ID 是否成功”来验证，不要盲目调参数。

3. 把 an41908a.zip 变成可加载驱动：源码结构、设备树与最小编译路径

原理看完了，接下来要动真格。这一章的目标是让你拿到 an41908a.zip 之后，能在一个小时内在自己的板子上把驱动加载起来。不需要先看懂全部源码，只需要确认三件事：这个源码是给哪个内核准备的、设备树节点怎么加、编译加载后怎么确认 probe 成功。

3.1 解压后先别急着编译：看 Makefile 和头文件判断源码给哪个环境准备的

拿到驱动源码第一件事，不是打开.c文件从头读，而是先看构建方式。有的大型驱动源码包走 CMake 或脚本生成，比如 USRP UHD 驱动源码要先跑 bootstrap 再 cmake 生成构建系统；AN41908 这类单芯片驱动基本就是一个朴素 Makefile，直接看它引用了哪个内核头文件路径就行。

先执行tar -tzf an41908a.zip或直接解压，看目录里有什么。一个典型的源码包会包括：芯片数据手册 PDF、.c驱动文件、.h头文件、Makefile，有时还有设备树示例片段和应用层测试代码。如果你的包里没有数据手册，先去把手册补上，没有手册继续往下走就是盲调。

接着打开 Makefile 看这几行：

obj-m += an41908.o KDIR := /lib/modules/$(shell uname -r)/build

obj-m表示源码是作为外部模块编译的，不修改内核主树；KDIR指向的是目标板内核的构建目录。如果板子上是 5.10 内核，而包里的头文件还在用 3.x 时代的宏，你要么自己改一些兼容宏，要么换一个与内核版本匹配的 SDK。我遇到过源码在 4.19 上好好的，换到 6.1 内核编译直接报错，原因是旧版 SPI API 的spi_master结构体成员变了，这类兼容问题几乎每个老驱动包都会碰到。

再看.c文件里的compatible字符串，比如vendor,an41908这类，把它记下来。这个字符串要和设备树里的完全一致，否则of_match_table匹配不上，probe 根本不会被调用。

3.2 设备树节点：让 SPI 控制器知道 AN41908 挂在哪、怎么挂

如果你手上的板子已经有空闲的 SPI 控制器和片选引脚，那设备树只需要在对应 SPI 节点下加一个子节点。关键信息有三个：挂在哪个 SPI 控制器、用第几路片选、SPI 工作模式是什么。下面是实际使用中最常见的设备树写法：

&spi0 { status = "okay"; pinctrl-names = "default"; pinctrl-0 = <&spi0_pins>; cs-gpios = <&gpio1 7 GPIO_ACTIVE_LOW>; an41908@0 { compatible = "vendor,an41908"; /* 必须与驱动中的 of_match_table 一致 */ reg = <0>; /* 0 表示使用第 0 路片选 */ spi-max-frequency = <1000000>; /* 1MHz 起步，稳定后再提速 */ enable-gpios = <&gpio1 8 GPIO_ACTIVE_HIGH>; /* 如果芯片实际工作在 Mode 3，追加 spi-cpol 和 spi-cpha 两个属性 */ }; };

这里每个属性都有实际含义。cs-gpios指定片选引脚，可能是 GPIO 也可能是 SPI 控制器内部片选，看硬件原理图；子节点的reg = <0>表示它占用第 0 路片选，和cs-gpios里的第一个&gpio1 7对应。spi-max-frequency直接决定 SPI 时钟源的分频结果，聚焦芯片对速率要求不高，1MHz 起步是稳妥选择。enable-gpios是芯片的使能脚，如果硬件上把它直接接死了，这行可以删掉。

有一个常见错误：只改兼容字符串，忘了核对spi-cpol和spi-cpha。设备树里这两个属性不追加，SPI 核心默认按 Mode 0 工作；而驱动源码里如果已经执行了spi->mode = SPI_MODE_3，两者就会冲突，最终以最后一次设置为准，问题非常隐蔽。我的建议是，设备树不写模式属性，模式完全由驱动源码设置，这样只维护一处。

3.3 最小编译与加载路径：insmod 之后怎么确认 probe 成功

设备树改好并编进内启动之后，开始编驱动模块。交叉编译时 Makefile 要带上架构和交叉编译工具链前缀，否则你 x86 电脑编出来的.ko在 ARM 板子上是加载不了的。一个可用的最小 Makefile 如下：

# 目标板交叉编译示例 obj-m += an41908.o KDIR := /home/work/linux-build # 指向目标板内核的 build 目录 CROSS_COMPILE := arm-linux-gnueabihf- ARCH := arm all: $(MAKE) -C $(KDIR) M=$(PWD) ARCH=$(ARCH) CROSS_COMPILE=$(CROSS_COMPILE) modules clean: $(MAKE) -C $(KDIR) M=$(PWD) ARCH=$(ARCH) CROSS_COMPILE=$(CROSS_COMPILE) clean

KDIR不是只填一个路径，它必须指向目标板内核源码经过配置和编译后生成的 build 目录，里面要有Module.symvers和.config。如果你只在刷固件时拿到过 zImage，手上没有完整内核源码树，那这个模块是编不出来的——这也是驱动源码落地中最常卡住的一步。解决方法是找 BSP 厂商要对应版本的 kernel source，而不是自己瞎猜路径。

编译通过后拷贝到目标板，按下面的顺序加载并确认：

insmod an41908.ko dmesg | tail -20 ls /sys/bus/spi/devices/

加载后看dmesg：如果出现an41908 spi0.0: probe success或类似日志，说明驱动和设备树已经对上了。然后看/sys/bus/spi/devices/下有没有spi0.0这个目录，有就代表 SPI 控制器注册了这个设备。如果 dmesg 里没有任何和 an41908 相关的输出，先确认设备树有没有编进内核，再确认compatible字符串和驱动of_match_table是否一字不差。这里对不上的情况占了 probe 失败原因的七成以上。

4. 聚焦位置怎么从寄存器走到镜头：初始化序列与位置写入的实现拆解

驱动能加载、probe 成功，只是打开了门。真正让镜头动起来，需要理解聚焦控制的两条路径：一条是上电初始化，把芯片从默认状态带到可工作状态；另一条是位置写入，把应用层算好的目标位置经 SPI 送进芯片。这一章拆开讲这两条路径的代码实现与参数选择。

4.1 内核态 SPI 读写封装：spi_message 与 spi_transfer 的用法

在 Linux 内核里，SPI 从设备驱动的读写最后都要落到struct spi_transfer和struct spi_message上。一个spi_message里可以挂多个spi_transfer，内核保证一次spi_sync调用中整个 message 的片选不会被其他事务打断，这个特性对读操作至关重要，因为读操作必须“先发地址、再收数据”且中途片选不能释放。

实际封装时，我一般用spi_write_then_read这个快捷函数，它在内部完成 message 和 transfer 的组装，代码更少，行为也更安全。写寄存器函数如下：

static int an41908_write_reg(struct an41908_dev *dev, u8 reg, u16 val) { u8 buf[3]; /* 帧格式：地址字节（最高位为写标志）+ 数据高字节 + 数据低字节 * 地址偏移和标志位位置以数据手册为准，这里是通用占位写法 */ buf[0] = reg | AN41908_SPI_WR; buf[1] = (val >> 8) & 0xff; buf[2] = val & 0xff; /* spi_write_then_read 在内部把 txbuf 发出去，CS 自动管理 */ return spi_write_then_read(dev->spi, buf, sizeof(buf), NULL, 0); }

读寄存器用的是同一个函数的双向版本。重点在于tx和rx在同一个spi_message里，片选全程不释放，否则芯片会认为一次传输已经结束：

static int an41908_read_reg(struct an41908_dev *dev, u8 reg, u16 *val) { u8 tx[3], rx[3]; int ret; tx[0] = reg | AN41908_SPI_RD; /* 读标志，具体位置看手册 */ tx[1] = 0; tx[2] = 0; ret = spi_write_then_read(dev->spi, tx, 3, rx, 3); if (ret) return ret; *val = (rx[1] << 8) | rx[2]; return 0; }

注意spi_write_then_read的txbuf和rxbuf长度相等，都是 3 字节。有的芯片读操作在发完地址字节后需要额外的时钟才能移出数据，你的帧长度就要按手册把这两个 3 改成实际值。另外，回调函数里要避免频繁动态分配，短帧直接在栈上建缓冲区就够，实时性要求高的地方可以考虑用spi_async走中断完成路径，但聚焦这种毫秒级运动根本不需要那么激进。

4.2 聚焦初始化的先后顺序：上电稳定与寄存器配置

上电后直接写目标位置，这是新手最容易犯的错。AN41908 上电后内部 LDO、振荡器、驱动级都需要时间稳定，寄存器处于默认态，待机可能还没解除。此时写任何位置命令，芯片要么忽略，要么按错误的驱动电流执行，电机会抖动甚至过流。初始化顺序必须按“稳定 → 确认身份 → 配置 → 回零”来：

static int an41908_hw_init(struct an41908_dev *dev) { int ret; u16 chip_id; /* 1. 上电后等电源和内部 LDO 稳定 */ usleep_range(10000, 20000); /* 2. 读 ID，确认 SPI 通路和帧格式正确 */ ret = an41908_read_reg(dev, AN41908_REG_ID, &chip_id); if (ret) return ret; if (chip_id != dev->expected_id) dev_warn(&dev->spi->dev, "ID mismatch: 0x%04x\n", chip_id); /* 3. 解除待机，写入驱动电流和衰减模式配置 */ ret = an41908_write_reg(dev, AN41908_REG_CTRL, AN41908_CTRL_STANDBY_OFF); if (ret) return ret; ret = an41908_write_reg(dev, AN41908_REG_DRIVE_CFG, dev->drive_cfg); if (ret) return ret; /* 4. 等待内部状态机就绪 */ usleep_range(5000, 10000); /* 5. 位置回零，后续应用从已知起点开始对焦 */ return an41908_set_focus(dev, 0); }

这里有几个参数要说明。usleep_range(10000, 20000)给的是 10 到 20 毫秒的窗口，内核会在这个范围内安排睡眠，比msleep(20)更高效。dev->drive_cfg是驱动电流配置，需要根据你镜头模组的直流电阻和工作电压来调：电流太小镜头推不动，太大电机会发烫。AN41908_CTRL_STANDBY_OFF是解除待机的标志，不要省这一步，有的芯片出厂默认就是待机态。

初始化完成后，建议做一次位置回零。如果镜头没有机械限位开关，回零就是把位置寄存器写成 0；如果有光耦或者霍尔传感器，要加一段专门的归零算法。这一步不做，应用层的对焦逻辑就无法保证起点一致性，产线上十台设备十种起点，全乱套。

4.3 位置码换算、写入与回读确认：内核驱动和 spidev 怎么选

位置写入看起来只是把目标值写进寄存器，但实际有三个容易被忽略的动作：等待 BUSY 清零、位置码限幅、写后回读。把这三个动作做全，聚焦控制的可靠性才会真正上来。下面是一个可用的set_focus实现：

static int an41908_set_focus(struct an41908_dev *dev, u16 position) { u16 status, value; int timeout = 50; int ret; /* 上一次移动还没结束，新命令可能被丢弃，必须等待 */ do { ret = an41908_read_reg(dev, AN41908_REG_STATUS, &status); if (ret) return ret; if (!(status & AN41908_STATUS_BUSY)) break; usleep_range(2000, 5000); } while (--timeout); if (!timeout) return -EBUSY; /* 位置寄存器是 10bit 分辨率，超出上限直接限幅 */ if (position > AN41908_FOCUS_MAX) position = AN41908_FOCUS_MAX; ret = an41908_write_reg(dev, AN41908_REG_FOCUS, position); if (ret) return ret; /* 写后回读，确认芯片真的收到目标值 */ return an41908_read_reg(dev, AN41908_REG_FOCUS, &value); }

timeout = 50是循环次数的上限，每次循环最多睡 5 毫秒，所以最坏情况等 250 毫秒就会返回-EBUSY。这个值要看你镜头从一端走到另一端实际需要多久，如果镜头行程很长，50 次可能不够，直接调大。位置码的限幅用的是AN41908_FOCUS_MAX，对应芯片位置寄存器的最大分辨率值，比如 10bit 就是 1023。如果上层传了 1500，直接写进去会溢出到低 10 位，镜头会诡异地在另一个位置停下来。

写到这一步会有一个选型问题：到底用内核驱动，还是直接在用户态用 spidev 控制？这个选择值得展开，两类方案各有各的适用场景。

我的习惯是：第一块样板用 spidev 快速验证芯片能不能工作，确定寄存器配置后再写内核驱动。如果一开始就全文在内核态调，每改一个寄存器值都要重新编译模块，调试效率太低。

5. AN41908 驱动上机排查：四个典型故障的现象、根因与解决

这一章是把之前踩过的坑集中摆出来。每一类故障我都按“现象 → 原因 → 解决”来写，这些基本都是 SPI 聚焦驱动上机时最高频的问题，值得收藏下来对照排查。

5.1 电机只抖动不转动：SPI 模式与帧格式是头号嫌疑

现象：给驱动写了一个目标位置，镜头没有移动，只是原地轻微抖动，像被卡住或者在挣扎。电压和电流都测了，供电没问题。

原因：SPI 模式或帧格式不对，芯片收到了数据但解析不出来。最常见的情况是 CPOL、CPHA 配置错误，导致数据在错误的时钟沿被采样，地址和数据位全部错位；另一种常见原因是帧长度设错，寄存器地址被当成数据的一部分，芯片内部状态机完全错乱。驱动电流配置大幅偏小也会表现为抖动，但概率低一些。

解决：先用逻辑分析仪抓 MOSI 和 SCLK，把你的帧和手册时序图逐位对照。重点看数据在时钟上升沿还是下降沿被采样，空闲时时钟是高还是低。确定完 SPI 模式后，回到设备树里把spi-cpol和spi-cpha改对，或者直接在内核驱动的probe里覆盖spi->mode。如果时序完全正确仍然抖动，再检查驱动电流寄存器，逐步往上加，别一次跳到最大。

5.2 能读回 ID 却写不进位置：先查写保护和帧方向位

现象：读 ID 寄存器返回值正常，说明 SPI 通信基本通了；但写位置寄存器后，镜头纹丝不动，读回目标位置寄存器还是原来的值。

原因：读通路正常不代表写通路正常。这类芯片的写操作往往有保护机制，比如需要在控制寄存器里先解除写保护，或者帧地址字节的最高位不是读写标志位，而是一个单独的方向位。方向位写错，芯片会把数据当成非法命令拒绝。还有一种是写时序要求更严格，CS 释放时间不够，芯片没有锁存数据。

解决：重点检查两处。第一，看驱动源码里的写标志值AN41908_SPI_WR和读标志值AN41908_SPI_RD是否和手册一致，确认方向位到底是高电平写还是低电平写；第二，查手册里有没有 unlock 或“写保护”寄存器，如果需要先解锁，必须在每次初始化或目标位置写入前补一条命令。spi_write_then_read已经保证了 CS 不会提前释放，所以时序问题通常只剩帧格式和标志位这两个嫌疑。

5.3 跑一段时间位置丢失或芯片失联：寄存器被复位，缺周期刷新

现象：设备正常对焦几分钟或几十分钟后，镜头突然回到某个固定位置，或者芯片不再响应 SPI 命令，必须重新初始化才能恢复。

原因：芯片触发了掉电复位或看门狗复位。聚焦电机启动瞬间的电流尖峰如果没做好滤波，会把芯片电源拉到复位门限以下；或者驱动电流配置过高，长时间运行导致芯片温度保护触发；还有一类更容易被忽略的因素，就是寄存器本身是易失的，掉电后恢复默认值，而你的驱动只在 probe 时初始化过一次，没有定期刷新。

解决：先用示波器挂在芯片电源引脚上看有没有瞬间跌落，有跌落就加大储能电容或者调整电机电流斜坡。排除硬件后，在驱动里加一个周期刷新任务，比如用内核delayed_work每 500 毫秒重新写一次关键配置寄存器，读一次状态寄存器，如果发现状态异常就主动重新初始化。这个刷新任务不用很复杂，但它能把寄存器复位问题兜住，让设备在无人值守时也能自恢复。

5.4 用户态 spidev 测试通过，应用一跑就卡死：并发访问与片选复用

现象：单独用 spidev 写寄存器一切正常，镜头转向精准；但应用程序一跑起来，要么写寄存器超时，要么 SPI 设备和 GPIO 报 busy，严重时整个应用直接卡住。

原因：应用层和测试脚本同时打开了/dev/spidevX.X，两个进程没有任何互斥，SPI 帧互相穿插，芯片被截断的帧搞懵。另一个隐藏原因是片选引脚被设备树里其他节点也声明了，SPI 控制器加锁时发现 GPIO 已经被占用，直接返回-EBUSY。

解决：应用层所有访问 SPIDEV 的地方统一走一个带mutex的封装模块，每次传输都加锁，传输完立即释放。同时在设备树里全局搜一遍片选 GPIO 是否被复用，别只看 SPI 节点，有时候一个 LED 节点或按键节点悄悄把它占用了。如果你发现应用层加锁后还有偶发卡顿，建议直接迁移到内核驱动，用内核的spi_lock和原子操作替代用户态锁，这才是量产该有的稳定级别。

提示：以上四个故障有一个共同的排查前提——先确认 SPI 通路正常。我见过有人为了“寄存器写不进”折腾了两天，最后发现是 MISO 引脚焊盘虚焊。先把 ID 读回来，再谈其他。

6. 验证 AN41908 聚焦驱动是否真的在工作：抓波形、回读寄存器与位置往返自测

驱动写完、能 probe、能初始化，最后一步是系统性地验证它确实在工作，而不是碰巧动了。我每次都做三件事：抓波形、回读寄存器、位置往返自测。这三步做完，驱动才算真正交付。

第一步是抓波形。逻辑分析仪接四根线：CS、SCLK、MOSI、MISO，采样率调到 10MS/s 以上，用 SPI 协议解码器配置好模式。抓一段初始化序列，确认第一帧确实是读 ID，地址字节方向位正确。再抓一次set_focus写位置寄存器，确认帧里的数据位和你要写的目标值一致。这一步能发现所有设备树参数和源码帧格式方面的问题。

第二步是回读寄存器。驱动里把snprintf开一个 debugfs 节点，或者直接通过应用层 ioctl 回读关键寄存器。系统跑起来后，读目标位置寄存器，确认写入值和读回值一致；再读状态寄存器，确认 BUSY 位随电机运动变化。回读过程中如果看到某个寄存器值无端跳变，优先查电源噪声和 SPI 线缆长度。

第三步是位置往返自测。用 spidev 或应用层接口写一个循环，让镜头在近端、远端、中间几个位置往返走，每个位置停留一会儿。下面是一个简洁的 Python 自测脚本：

import spidev import time spi = spidev.SpiDev() spi.open(0, 0) # 按实际节点调整 /dev/spidevX.X spi.max_speed_hz = 1_000_000 REG_FOCUS = 0x20 # 占位值，按手册替换 WR = 0x80 positions = [0, 256, 512, 768, 1023, 512, 0] for pos in positions: tx = [REG_FOCUS | WR, (pos >> 8) & 0xFF, pos & 0xFF] spi.xfer2(tx) time.sleep(0.2) # 留出电机移动时间 # 这里可配合图像清晰度统计，形成“位置-清晰度”曲线

脚本里spi.xfer2保证一次事务内多字节不被打断，替代内核态spi_write_then_read对应的用户态 API。跑完这个循环，听电机声音是否平滑，看镜头是否每次都停在同一位置。有条件的话，配合摄像头抓帧做清晰度评分，把位置码和清晰度画成曲线，能直观看到对焦峰值在哪一档。

做完整套验证，我会顺手把初始化序列和验证命令固化成脚本放进工程目录，方便产线复测时直接跑。以后换镜头型号或复现现场问题，先跑这套脚本就能分清是驱动问题还是机构问题，不用每次都拆机抓波形。希望帮到你。

本文还有配套的精品资源，点击获取