LDC1000金属探测程序完整版：从驱动到滤波的工程实践

简介：这份资源是面向电子设计竞赛选手与嵌入式开发者的LDC1000金属探测完整程序，源自TI杯金属位置探测器项目。包内共40个文件，以C源码、头文件、Keil工程文件（uvproj/uvopt）、编译产物（hex/obj/lst/m51）及汇编启动文件为主，压缩包约101KB，结构紧凑，便于直接导入开发环境复现。代码围绕LDC1000低频电感耦合传感器展开，涵盖硬件接口寄存器配置、原始信号滤波与校正、目标检测阈值算法以及LCD显示等模块，完整呈现了从传感器驱动到结果输出的实现链路。目前已有670人学习下载，适合希望掌握非接触式金属检测原理、理解电感传感数据处理流程的读者参考。通过研读这套工程，可快速了解LDC1000在金属位置探测中的配置方法与算法组织方式，为竞赛备赛或类似嵌入式项目提供可复用的代码框架与调试思路。

1. 从一块 LDC1000 说起：这套金属探测程序到底能跑出什么效果

如果你手头正好有一块 TI 的 LDC1000 电感数字转换芯片，又不想从零去啃数据手册里那一堆寄存器，那这套「LDC金属探测程序完整版」基本就是拿来就能用的东西。它的核心场景很明确：驱动 LDC1000 完成金属接近检测，把原始电感量变化转成可判断的距离或有无信号，再通过串口把数据吐给上位机。整套代码围绕 TI 杯这类竞赛场景打磨过，采集、滤波、阈值判定、串口上报这条链路是通的，不是那种只点亮一个 LED 就结束的 Demo。

适合谁？一是准备电赛或者做课程设计的学生，二是想快速验证 LDC1000 方案可行性的硬件工程师。你不需要先成为电感传感专家，只要能把板子连上、把工程烧进去，就能看到金属靠近时数据曲线的变化。下面我按「能干什么 → 怎么跑 → 怎么改」的顺序，把这份代码拆开讲清楚。

2. 硬件链路与工程结构：LDC1000 到底怎么接、代码怎么分层

2.1 LDC1000 的通信方式和引脚连接

LDC1000 是 TI 出的电感数字转换器，它测量的是 LC 谐振回路的等效并联电阻和电感频率。芯片对外提供 SPI 接口，主控通过读写寄存器来配置转换参数、读取转换结果。常见做法是主控用硬件 SPI，LDC1000 的 SDO、SDI、SCLK、CS 四根线对应接好，再把 INTB 引脚接到主控的外部中断上，用来通知一次转换完成。

这里有个容易翻车的点：LDC1000 的 SPI 模式支持 CPOL=0/CPHA=0 和 CPOL=1/CPHA=1 两种，具体用哪种取决于你主控的 SPI 配置。代码里一般会封装一个LDC1000_WriteReg和LDC1000_ReadReg，把片选拉低、发地址、读写数据、拉高片选这套动作固定下来。如果你发现读回来的寄存器值全是 0xFF 或者 0x00，先别怀疑芯片坏了，八成是 SPI 模式或者片选时序对不上。

// LDC1000 寄存器读写封装（SPI 模式） // 地址字节最高位为 1 表示读，为 0 表示写 uint8_t LDC1000_ReadReg(uint8_t addr) { uint8_t val; LDC_CS_LOW(); // 片选拉低，开始通信 SPI_Transfer(addr | 0x80); // 发送读命令 + 地址 val = SPI_Transfer(0x00); // 读回一个字节 LDC_CS_HIGH(); // 片选拉高，结束通信 return val; } void LDC1000_WriteReg(uint8_t addr, uint8_t data) { LDC_CS_LOW(); SPI_Transfer(addr & 0x7F); // 发送写命令 + 地址 SPI_Transfer(data); // 写入数据 LDC_CS_HIGH(); }

逻辑说明：读操作时地址字节最高位置 1，写操作时最高位保持 0，这是 LDC1000 数据手册规定的协议格式。SPI_Transfer是主控的底层字节收发函数，不同平台实现不同，但语义就是「发一个字节，同时收一个字节」。参数addr是寄存器地址，data是要写入的值。片选信号必须严格在每次读写前后拉低拉高，否则芯片不会响应。

2.2 工程目录的分层思路

这份完整版工程一般会分成三层：底层驱动层、数据处理层、应用逻辑层。底层驱动层就是上面说的 SPI 封装和 LDC1000 寄存器操作；数据处理层负责把原始转换值做滑动平均或者中值滤波，去掉抖动；应用逻辑层做阈值比较、状态机切换、串口上报。

常见做法是建一个ldc1000.c/h放驱动，一个filter.c/h放滤波算法，主文件里只写业务逻辑。这样你换主控平台的时候，只需要改 SPI 底层，驱动和滤波不用动。目录结构大概长这样：

project/ ├── drivers/ │ ├── ldc1000.c # LDC1000 寄存器读写 │ └── spi_soft.c # SPI 底层（硬件或软件模拟） ├── middlewares/ │ └── filter.c # 滑动平均、中值滤波 ├── app/ │ └── main.c # 主循环、阈值判定、串口上报 └── config/ └── ldc_config.h # 阈值、采样率、滤波窗口等参数

把参数集中到ldc_config.h是个好习惯，调阈值的时候不用满工程找。我一般会把接近阈值、远离阈值、滤波窗口长度、串口波特率都放这里，改起来一目了然。

2.3 初始化流程和寄存器配置

LDC1000 上电后需要配置几个关键寄存器才能正常工作。最核心的是转换频率、响应时间、以及电感测量的相关参数。代码里通常会有一个LDC1000_Init函数，按顺序写入配置值，最后读回来校验一遍。

void LDC1000_Init(void) { LDC1000_WriteReg(0x01, 0x02); // 设置转换频率分频 LDC1000_WriteReg(0x02, 0x0A); // 设置响应时间 LDC1000_WriteReg(0x03, 0x00); // 配置测量模式 LDC1000_WriteReg(0x04, 0x00); // 设置阈值相关 // 读回校验，确认写入成功 if (LDC1000_ReadReg(0x01) != 0x02) { // 初始化失败处理，通常是 SPI 通信问题 } }

逻辑说明：每个寄存器的具体值需要根据你的 LC 谐振回路参数来调，不能照抄。0x01寄存器控制转换频率，值越大转换越快但噪声也越大；0x02控制响应时间，影响的是数据更新速率。参数说明：如果你发现数据跳变厉害，先把响应时间调大一点，牺牲速度换稳定。初始化后的读回校验很重要，能帮你快速定位是通信问题还是配置问题。

3. 数据采集与滤波：从原始值到可用信号的完整链路

3.1 原始数据的读取和转换

LDC1000 输出的不是直接的「距离值」，而是与电感量相关的 24 位数据。代码里需要把三个字节拼成一个完整的转换结果，再根据你的标定曲线换算成实际物理量。常见做法是读0x21、0x22、0x23三个寄存器，拼成 24 位有符号数。

int32_t LDC1000_ReadProximity(void) { uint8_t msb = LDC1000_ReadReg(0x21); // 高字节 uint8_t mid = LDC1000_ReadReg(0x22); // 中字节 uint8_t lsb = LDC1000_ReadReg(0x23); // 低字节 int32_t raw = ((int32_t)msb << 16) | ((int32_t)mid << 8) | lsb; // 处理符号位，24 位有符号数扩展到 32 位 if (raw & 0x00800000) { raw |= 0xFF000000; } return raw; }

逻辑说明：LDC1000 的转换结果是 24 位，高字节在前。拼装时注意移位顺序，先左移 16 位再或上中字节和低字节。符号位处理是必须的，因为接近和远离金属时数据可能往两个方向变化。参数说明：raw就是原始电感相关值，后续滤波和阈值判定都基于它。如果你读出来的值一直不变，检查一下 INTB 中断有没有正常触发，或者是不是在读之前没有等待转换完成。

3.2 滑动平均滤波的实现和参数选择

原始数据抖动是电感式传感的通病，不做滤波直接判阈值，你会看到状态疯狂闪烁。滑动平均是最简单也最实用的方案，维护一个环形缓冲区，每次新数据进来就替换最老的数据，然后求平均。

#define FILTER_WINDOW 8 // 滤波窗口长度，必须是 2 的幂次方便于优化 static int32_t filter_buf[FILTER_WINDOW]; static uint8_t filter_idx = 0; static int32_t filter_sum = 0; int32_t Filter_Update(int32_t new_val) { // 减去最老的值，加上最新的值 filter_sum -= filter_buf[filter_idx]; filter_buf[filter_idx] = new_val; filter_sum += new_val; filter_idx = (filter_idx + 1) & (FILTER_WINDOW - 1); // 环形索引 return filter_sum / FILTER_WINDOW; }

逻辑说明：这个实现没有每次重新遍历求和，而是维护了一个累加和，效率更高。filter_idx用位与运算代替取模，前提是窗口长度是 2 的幂。参数说明：FILTER_WINDOW越大数据越平滑但响应越慢，8 到 16 是比较常用的范围。如果你检测的是快速移动的金属，窗口别开太大，否则会感觉「迟钝」。我一般会先用 8 试，不够稳再加到 16。

3.3 阈值判定和状态机

滤波后的数据要转成「有金属 / 无金属」的判断，最直接的方式是设两个阈值：一个接近阈值，一个远离阈值，中间留回差防止在边界抖动。状态机在两个状态之间切换，只有跨过对应阈值才改变状态。

#define THRESHOLD_NEAR 1200 // 接近阈值 #define THRESHOLD_FAR 1000 // 远离阈值 typedef enum { STATE_IDLE, STATE_DETECTED } DetectState; DetectState state = STATE_IDLE; void Detect_Update(int32_t filtered_val) { switch (state) { case STATE_IDLE: if (filtered_val > THRESHOLD_NEAR) { state = STATE_DETECTED; // 触发检测到金属的动作 } break; case STATE_DETECTED: if (filtered_val < THRESHOLD_FAR) { state = STATE_IDLE; // 触发金属离开的动作 } break; } }

逻辑说明：回差设计是关键，THRESHOLD_NEAR和THRESHOLD_FAR之间的差值就是回差带。如果没有回差，数据在阈值附近波动时状态会反复横跳。参数说明：两个阈值的具体数值需要根据你的实际标定来定，先打印滤波后的数据，观察金属靠近和远离时的数值范围，再取中间值。一般回差带取满量程的 5% 到 10% 比较合适。

4. 避坑与常见问题：调试 LDC1000 时最容易翻车的几个点

4.1 读回数据全是 0xFF 或 0x00

现象：初始化后读任何寄存器都返回固定值，写进去再读出来对不上。原因：SPI 模式不匹配或者片选时序不对。LDC1000 对 SPI 时钟极性和相位有要求，如果你的主控配置成 CPOL=0/CPHA=1，通信就会失败。解决：把 SPI 改成 CPOL=0/CPHA=0 或者 CPOL=1/CPHA=1 试一下，同时用示波器看片选和时钟的时序，确认片选拉低后时钟才开始翻转。

4.2 数据跳变严重、无法稳定判定

现象：金属静止不动，但读回来的数值上下跳动几百甚至上千。原因：转换频率设太高、响应时间太短，或者电源纹波太大。解决：先把响应时间寄存器调大，降低数据更新率；再检查 LDC1000 的模拟电源有没有加足够的去耦电容，通常 100nF 加 10uF 是标配。如果还不行，加大滤波窗口。

4.3 检测距离远小于预期

现象：金属要贴得很近才能触发，稍微远一点就没反应。原因：LC 谐振回路的电感值或电容值选得不对，导致灵敏度不够。解决：LDC1000 的检测距离和线圈直径、匝数直接相关。常见做法是增大线圈直径，或者调整谐振电容让谐振频率落在芯片推荐的范围内。代码层面可以适当降低接近阈值，但根本解决还是要改硬件参数。

4.4 串口上报数据丢包或乱码

现象：上位机收到的数据偶尔错位或者出现乱码。原因：串口波特率不匹配，或者发送时没有做忙判断导致数据覆盖。解决：确认主控和上位机波特率一致；发送函数里加一个等待发送完成的判断，别在发送寄存器还忙的时候硬塞下一个字节。如果数据量大，考虑加一个简单的帧头和校验。

4.5 中断触发但读不到新数据

现象：INTB 中断进了，但读回来的转换结果和上次一样。原因：中断标志没有清除，或者读数据太慢导致下一次转换已经覆盖了当前值。解决：确认中断服务函数里有没有清除 LDC1000 的中断标志位；如果主循环处理太慢，考虑在中断里只置标志，把读数据放到主循环做，或者提高主循环的响应速度。

5. 二次开发与参数调优：把这套代码改成你自己的检测方案

5.1 标定曲线的建立方法

这套代码默认输出的是原始电感相关值，如果你需要显示实际距离，得自己做标定。具体做法：把金属片固定在位移台上，每隔一毫米记录一次滤波后的数值，然后拟合一条曲线。常见做法是用分段线性插值，简单且够用。代码里加一个LDC_ValueToDistance函数，把原始值映射成毫米数。

// 分段线性标定表：原始值 -> 距离(mm) typedef struct { int32_t raw; float mm; } CalibPoint; static const CalibPoint calib_table[] = { {1500, 0.0f}, {1200, 5.0f}, {900, 10.0f}, {600, 20.0f}, {300, 35.0f}, }; float LDC_ValueToDistance(int32_t raw) { // 在标定表中查找区间并做线性插值 for (int i = 0; i < sizeof(calib_table)/sizeof(calib_table[0]) - 1; i++) { if (raw <= calib_table[i].raw && raw >= calib_table[i+1].raw) { float ratio = (float)(raw - calib_table[i+1].raw) / (calib_table[i].raw - calib_table[i+1].raw); return calib_table[i+1].mm + ratio * (calib_table[i].mm - calib_table[i+1].mm); } } return -1.0f; // 超出标定范围 }

逻辑说明：标定表按原始值从大到小排列，查找时找到 raw 落在哪个区间，然后做线性插值。参数说明：calib_table里的数据必须是你自己实测的，不同线圈、不同金属材质结果差别很大。如果你检测的是铁磁性金属，曲线形状会和非铁磁金属不一样，需要分别标定。

5.2 多阈值分级检测的改造思路

如果你需要的不只是「有 / 无」，而是「远 / 中 / 近」三档，可以在状态机基础上扩展。定义三个阈值，状态机在四个状态之间切换。改造的时候注意回差要设在每两个相邻档位之间，避免档位边界抖动。

表格里的数值只是示例，实际用的时候换成你自己的标定值。改造完记得在每个状态切换的边界加回差，否则会在档位边界反复跳。

5.3 从裸机到 RTOS 的移植注意点

如果你要把这套代码放到 RTOS 上跑，最大的变化是中断和任务的分工。常见做法是：INTB 中断只做一件事，给一个信号量或者置一个事件标志；一个独立任务等这个信号量，然后去读 LDC1000 数据、滤波、更新状态。这样不会在中断里做耗时操作，也不会因为主循环里其他任务阻塞导致数据丢失。

移植的时候注意 SPI 操作的互斥，如果多个任务都要用 SPI 总线，得加互斥锁。另外滤波器的状态变量如果被多个任务访问，也要保护。我一般会把整个 LDC1000 相关的操作都放在一个任务里，对外只暴露一个「获取当前检测状态」的接口，这样最省心。

5.4 一个我踩过的坑：别在中断里读 SPI

早期调试的时候，我图省事直接在 INTB 中断服务函数里读 LDC1000 的转换结果。单次测试没问题，但连续跑几分钟后偶尔会死机。查了很久才发现，SPI 读写本身耗时不短，在中断里做这么长的操作，容易和其他中断嵌套冲突，尤其是 systick 中断被延迟后整个系统的时间基准都乱了。后来改成中断只置标志，主循环里读数据，再也没出过这个问题。从那以后我每次用外部中断触发传感器读取，都强制走一遍「中断置标志、主循环处理」的流程，不管传感器读起来有多快。希望这个习惯也能帮到你。

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