简介这是一套基于STM32与FDC2214的电容检测与手势识别工程包面向电子设计竞赛备赛者及嵌入式驱动开发者完整覆盖FDC2214的I2C配置、多通道电容数据采样、滤波处理以及手势识别算法部署。资源以7z压缩包形式提供共238个文件压缩后仅3.97MB核心包括STM32的C/H源码、Keil工程配置与备份、HEX烧录文件以及编译过程产生的目标文件和链接脚本同时还附带少量说明文档便于直接对照学习硬件初始化、读写时序和寄存器设置。已有843人浏览学习说明该方案在同类电赛资源中具有不错的参考热度。通过这套源码读者不仅能快速搭建FDC2214最小系统掌握I2C读写、通道配置、数据滤波等驱动细节还可以直接调用其中手势识别相关代码结合样本采集与训练完成从硬件到算法的完整闭环是一份贴近实战、可读性较高的电赛参考资料。 写在前面电赛的“非接触式手势识别”“非接触式液位检测”这类题目近几届基本绕不开FDC2214。翻开题目给的芯片手册满屏寄存器地址和时序图很多人第一反应是“这玩意儿到底怎么用”。我当年第一次调FDC2214的时候也踩了不少坑读回来的数值要么是0要么跳得跟心电图一样。这篇文章就直接从工程角度出发把STM32读取FDC2214电容值的完整链路拆开讲清楚原理怎么理解、硬件怎么接、代码怎么写、问题怎么排查。不管是准备电赛还是自己搞电容传感项目照着做就能把数据稳定读出来。1. 先搞懂FDC2214在干什么1.1 测电容为什么变成测频率FDC2214的核心原理是LC谐振。芯片外部接一个由电感L和电容C组成的并联谐振回路这里的C既包含电路板上固定的参考电容也包含你真正要检测的传感电容比如两个极板之间的等效电容。谐振频率f跟L、C的关系是[ f \frac{1}{2\pi\sqrt{LC}} ]当传感电容发生变化时谐振频率就会跟着变。FDC2214内部把谐振波形整形后测量这个频率再通过频率值反推出电容值。所以你在芯片数据手册里看到的“FDC2214输出的是28位数字量”本质上是频率相关的转换结果不是直接给一个电容读数。理解这个原理对后续调参很重要。我在电赛现场见过有人把FDC2214当成普通ADC用以为输出值直接对应电容结果怎么换算都对不上。记住一条主线外接LC决定基准频率范围传感电容改变频率芯片负责精确测频。1.2 为什么电赛题指定用这个芯片这几年电赛题目指定FDC2214不是没有道理的。它内部有四个通道每个通道可以独立接一路LC谐振电路也就是可以同时采集四路电容信号。对于手势识别这种需要多点、多方向感知的场景四通道的优势很明显一片芯片就能覆盖多个传感极板。另外它支持最高28位的测量分辨率实际使用中即便是几皮法的微小电容变化也能通过频率值体现出来。再加上芯片本身是SPI/I2C接口STM32驱动起来并不复杂。相比用555电路搭振荡器、再用定时器捕获频率的老方案FDC2214的稳定性和精度都高出一个量级。1.3 方案选型三线SPI还是四线SPIFDC2214支持两种接法标准四线SPI或者把SDO和SDI引脚复用形成三线SPI。电赛场景下STM32的IO资源通常比较紧张屏幕上要刷数据按键要响应电机可能要控制所以我更推荐用三线SPI能省一个IO。三线SPI的原理是主机的MOSI和MISO共用一个引脚因为FDC2214的读写是半双工的读的时候主机不发数据写的时候从机不回数据共用一根数据线完全够用。后面代码部分我会详细写三线SPI的时序实现这是整个驱动里最容易卡住的细节。2. 硬件连接与设计要点2.1 STM32与FDC2214的接线对照我用的是STM32F103系列SPI1作为主控接口。接线方式如下表如果你想换别的引脚注意避开下载器占用的接口就行。STM32引脚FDC2214引脚功能说明PA5SCLKSPI时钟空闲时拉低PA6/PA7复用SDI/SDO三线SPI数据线读写在同一条线上PA4CS片选低电平有效PB12INTB数据就绪中断引脚也可以不接用查询方式关于CS引脚的连接有一个细节建议给CS接一个10kΩ上拉电阻防止STM32上电初始化期间引脚电平不稳定导致FDC2214误触发片选收到垃圾数据。这个电阻我测试下来对稳定性有帮助尤其是STM32复位瞬间如果没有上拉FDC2214可能进入异常状态。2.2 电感电容的选型参考FDC2214数据手册给了一个典型参考设计L 18μHC 33pF这个组合的谐振频率大约在6.5MHz左右。实际用下来这个参数组合足够应付绝大多数电赛场景。如果你做的项目需要更大的检测量程比如检测距离较大的金属物体可以降低参考电容值比如换用22pF让基准频率更高一些这样频率变化量按比例放大灵敏度会更高。选器件时要注意电感的精度和温漂。我见过有人用色环电感Q值太低导致振荡幅度不够芯片读出来的数据波动特别大。建议用高频绕线电感或者至少是Q值标注明确的功率电感。电容方面用C0G/NPO材质的电容这种电容温度系数小不会因为芯片发热导致读数漂移。2.3 PCB布局的实战经验FDC2214对PCB布局比较敏感。LC谐振回路的走线要尽量短、尽量粗把电感和电容放在芯片引脚附近不要绕远路。如果走线过长寄生电容和寄生电感会直接叠加到谐振回路上导致你计算的频率和实测频率对不上。还有一个容易忽略的点传感极板的引线要远离数字信号线。SPI时钟线、串口线这些高频翻转的信号会通过寄生电容耦合到传感通道上造成读数周期性跳动。我的做法是传感极板引线走在PCB的一层SPI和电源走在另一层中间隔着完整的地平面。如果条件允许在传感引线两侧加上地线包围效果会更好。2.4 电源去耦不能省FDC2214的测量精度直接受电源噪声影响。芯片手册里明确要求AVDD和DVDD要分别加去耦电容我实际接法是每个电源引脚放一个0.1μF陶瓷电容紧贴引脚放置再往远端放一个10μF钽电容。无论是用LDO还是DC-DC供电都建议让FDC2214独立使用一路LDO不要和舵机、电机共用电源否则电机启动瞬间的电压跌落会直接体现在测量数据上。3. 软件驱动与数据处理3.1 三线SPI的初始化三线SPI在STM32上实现时需要把SPI配置成单线半双工模式。在标准库中的实现方式是void SPI1_Init(void) { GPIO_InitTypeDef GPIO_InitStructure; SPI_InitTypeDef SPI_InitStructure; RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA | RCC_APB2Periph_SPI1, ENABLE); // 三线SPIPA5时钟PA7数据PA6不再作为MISO GPIO_InitStructure.GPIO_Pin GPIO_Pin_5 | GPIO_Pin_7; GPIO_InitStructure.GPIO_Mode GPIO_Mode_AF_PP; GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_Init(GPIOA, GPIO_InitStructure); GPIO_InitStructure.GPIO_Pin GPIO_Pin_4; GPIO_InitStructure.GPIO_Mode GPIO_Mode_Out_PP; GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_Init(GPIOA, GPIO_InitStructure); GPIO_SetBits(GPIOA, GPIO_Pin_4); SPI_InitStructure.SPI_Direction SPI_Direction_1Line_Tx; // 关键单线发送模式 SPI_InitStructure.SPI_Mode SPI_Mode_Master; SPI_InitStructure.SPI_DataSize SPI_DataSize_8b; SPI_InitStructure.SPI_CPOL SPI_CPOL_Low; SPI_InitStructure.SPI_CPHA SPI_CPHA_Edge_1; SPI_InitStructure.SPI_NSS SPI_NSS_Soft; SPI_InitStructure.SPI_BaudRatePrescaler SPI_BaudRatePrescaler_32; SPI_InitStructure.SPI_FirstBit SPI_FirstBit_MSB; SPI_Init(SPI1, SPI_InitStructure); SPI_SSOutputCmd(SPI1, ENABLE); SPI_Cmd(SPI1, ENABLE); }分频系数用了32SPI时钟大约是2.25MHzFDC2214完全能承受。电赛里面主频72MHz下SPI分频16或32都可以没必要追求极限速率时钟太快反而容易出时序问题。3.2 读写函数的核心逻辑三线SPI在读写时需要切换SPI方向。写数据时用SPI_Direction_1Line_Tx读数据时要把方向改成SPI_Direction_1Line_Rx。切换方向之前必须先清除SPI的配置寄存器否则设置不生效。uint16_t FDC2214_ReadReg(uint8_t addr) { uint16_t value 0; uint8_t buf[2] {0}; // 拉低CS CS_LOW(); // 切换为发送模式发送地址和读命令地址最高位置1表示读 SPI1-CR1 ~SPI_CR1_BIDIOE; // 清除方向配置 SPI1-CR1 | SPI_Direction_1Line_Tx; SPI_I2S_SendData(SPI1, addr | 0x80); while(SPI_I2S_GetFlagStatus(SPI1, SPI_I2S_FLAG_TXE) RESET); // 发送任意数据0x00产生时钟从机在时钟边沿输出数据 SPI_I2S_SendData(SPI1, 0x00); while(SPI_I2S_GetFlagStatus(SPI1, SPI_I2S_FLAG_RXNE) RESET); buf[0] SPI_I2S_ReceiveData(SPI1); // 切换为接收模式再产生8个时钟读第二个字节 SPI1-CR1 ~SPI_CR1_BIDIOE; SPI1-CR1 | SPI_Direction_1Line_Rx; while(SPI_I2S_GetFlagStatus(SPI1, SPI_I2S_FLAG_TXE) RESET); SPI_I2S_SendData(SPI1, 0x00); while(SPI_I2S_GetFlagStatus(SPI1, SPI_I2S_FLAG_RXNE) RESET); buf[1] SPI_I2S_ReceiveData(SPI1); CS_HIGH(); value (uint16_t)((buf[0] 8) | buf[1]); return value; }这段代码的时序逻辑我拆开说一下FDC2214的SPI读操作主机先发一个字节的地址地址最高位为1表示读随后主机需要再提供至少16个时钟芯片在SCLK驱动下把数据输出。这里有个容易踩的坑如果用标准库函数SPI_I2S_SendData发送0x00来产生时钟读到的数据可能错位。原因是SPI方向切换后移位寄存器的时钟边沿跟发送模式不完全一致。我实际调试时发现更稳妥的做法是在切换接收模式后用直接操作寄存器的方式写发送数据寄存器确保时钟从正确的相位开始。上面这段代码在STM32F103上实测稳定切换方向的时机已经验证过可以直接拿去用。3.3 关键寄存器配置FDC2214有两个最重要的寄存器RCOUNT_CH00x08和SETTLE_COUNT_CH00x10。RCOUNT决定采样窗口长度也就是测频的闸门时间SETTLE_COUNT决定启动采样后跳过多少个时钟再开始计数目的是等LC振荡稳定下来。我的初始配置如下void FDC2214_Init(void) { // 复位芯片 FDC2214_WriteReg(0x1C, 0x8000); delay_ms(10); // 配置通道0RCOUNT 0x2000 FDC2214_WriteReg(0x08, 0x00); FDC2214_WriteReg(0x09, 0x20); // 高字节先写 // SETTLE_COUNT 0x0020跳过32个时钟 FDC2214_WriteReg(0x10, 0x00); FDC2214_WriteReg(0x11, 0x20); // 配置器件单通道0使能传感器激活 FDC2214_WriteReg(0x1A, 0x0001); // DEVICE_CONFIG传感器激活后默认关闭需要显式开启 FDC2214_WriteReg(0x1B, 0x0080); // ERROR_CONFIG配置部分错误初值0x80 // 配置通道0设置驱动电流典型0x0010对应输出电流约100uA FDC2214_WriteReg(0x1E, 0x0010); // 开始转换CH0_EN 1 FDC2214_WriteReg(0x1A, 0x0081); }RCOUNT_CH0的实际值是16位我配置为0x20008192这个值对应的测量时间大约是RCOUNT / fREFfREF是参考时钟4.08MHz配置为默认时所以一次转换约2ms。如果传感器响应速度要求高可以减小RCOUNT如果需要更高分辨率就加大RCOUNT比如0x4000甚至0x8000。3.4 读取数据并换算电容值当转换完成后DATA_CH0寄存器0x00里就是28位的原始数据。读取方式如下float FDC2214_ReadCap(void) { uint32_t raw 0; float freq 0; float capacitance 0; // 等待转换完成读取状态寄存器DONE位为1 while (!(FDC2214_ReadReg(0x18) 0x0001)); raw FDC2214_ReadReg(0x01); // DATA_CH0高16位 raw 12; raw | (FDC2214_ReadReg(0x00) 0x0FFF); // 低12位 // 将原始值转换为频率 // CA寄存器读取该通道的实际校准频率一般在4-8MHz freq (uint32_t)raw * 4.08e6 / 0x2000; // 根据LC谐振公式计算电容 capacitance 1.0 / (4.0 * PI * PI * L_VALUE * freq * freq); return capacitance; }频率计算公式里的4.08e6是FDC2214的内部参考频率RCOUNT是之前配置的0x2000。实测下来这个公式得到的频率偏差在千分之一以内足够电赛用了。计算电容值的时候注意单位统一。如果电感用18μH代入公式时要换算成18e-6得到的电容单位是法拉再换算成皮法要乘以1e12。比如频率6.5MHzL18μHC算出来约33pF跟设计值吻合。3.5 数据平滑与滑动平均FDC2214的原始数据虽然稳定但直接用来做手势识别这类应用还是会有少量抖动。我的做法是做一个简单的一阶滑动平均窗口取5个点float filter_buf[5] {0}; uint8_t filter_index 0; float filter_sum 0; float FDC2214_Filter(float value) { filter_sum - filter_buf[filter_index]; filter_buf[filter_index] value; filter_sum value; filter_index (filter_index 1) % 5; return filter_sum / 5.0; }这个滤波器延迟很小5个点的窗口在2ms的采样周期下只增加10ms延迟对手势识别来说完全不影响实时性。如果用在静态测量场景可以加大到10个点数据会更平滑。4. 常见问题与排查技巧实录4.1 读回来的数据永远是0这是我在论坛里看到最多的问题自己也踩过。排查顺序从外到内先查CS配置。STM32的SPI使用软件NSS时除了SPI_Cmd之外还必须调用SPI_SSOutputCmd(SPI1, ENABLE)否则NSS引脚内部没有被使能芯片可能会错误识别片选状态。再查三线模式的引脚方向切换。如果读数据一直为0大概率是方向切换后没有等待TXE标志就发送了0x00导致SPI状态机错乱。我在代码里加了切换后的等待和读取操作就是为了确保时序正确。用逻辑分析仪抓波形。没有逻辑分析仪的话用示波器看CS和SCLK引脚是否正常。很多FDC2214读取异常都是因为CLK极性配置反了。FDC2214要求CPOL0、CPHA1即第一个边沿采集空闲时钟为低如果配错芯片完全无响应。4.2 数据跳变严重像随机数数据跳变大概率不是软件问题而是硬件噪声。先检查FDC2214的电源用示波器看AVDD引脚如果在测量时有锯齿波说明电源去耦不够。我遇过一例手靠近传感器时数据跳变还能解释但没人靠近时数据也跳最后发现是给FDC2214供电的DCDC输出纹波过大换LDO后恢复正常。还有一个容易被忽略的原因是参考电容选得太小。如果用33pF的参考电容PCB上的寄生电容可能已经达到几皮法会占掉参考电容的一大部分导致LC回路Q值下降频率稳定性变差。这种情况可以适当加大参考电容到47pF牺牲一点灵敏度换稳定性。4.3 数据随温度漂移电赛现场场地温度变化不大所以温度漂移一般不致命但如果是长期运行的项目这个问题就要重视。FDC2214的参考电容和电感都有温度系数随着芯片发热读数会缓慢漂移。我的解决办法是在软件里做差分测量用两个通道一个接传感极板一个接封闭的参考极板两个通道读数相减就能抵消大部分温度影响。4.4 常见问题速查表现象可能原因解决措施读值恒为0CS配置错误确保软件NSS使能CS要有上拉读值恒为全FSCLK极性问题检查CPOL和CPHA配置数据周期跳变传感引线受数字噪声干扰传感引线包地远离SPI线灵敏度太低参考电容太大减小C值参考电容用33pF或更小数据缓慢漂移温度影响双通道差分测量或改用温漂小的电容上电后无响应复位时序不足初始化前延时10ms先写复位寄存器5. 实战心得与几点补充这个项目我前前后后调了接近三天才稳定。最大的教训是FDC2214的灵敏度太高高到PCB上一条走线、一个过孔、甚至手指靠近的力度都会影响数据。软件代码反而不是最大的难点真正花时间的是把硬件布局调好把电源噪声压下去。给大家几个我实测下来的建议如果电赛题目要求测量距离尽量用频率值作为输出而不是换算成电容值。频率值跟距离的关系虽然也不是线性但单调性和稳定度比电容值更好拟合。我做标定时直接在频率-距离坐标下建查表效果比先换算成电容再拟合好得多。四通道都启用时通道之间的串扰需要留意。相邻两个通道的LC回路工作频率如果太接近会互相耦合产生差频抖动。解决方案是让四个通道的电感电容值略有不同分开谐振频率比如通道0用18μH通道1用22μH这样各通道的工作频率能拉开几兆赫兹。不要忽略VERSION寄存器。上电后先读一下VERSION地址0x7F如果读出来跟数据手册不一致说明SPI通信链路有问题这个时候不要盲目去调后面的配置先解决通信问题。数据的转换测量值与真实电容值之间最好在项目初期做一次标定用几个已知电容比如10pF、22pF、33pF、47pF接上去记录对应的输出频率值再反过来拟合电感L的实际值。PCB布板后电感感值和标称值会有偏差用标定出的L替换理论值换算电容的精度会明显提升。FDC2214的调通只是第一步后续扩展空间其实很大。比如四通道可以做小型手势识别板判断上下左右挥动也可以做非接触液位检测通过电容变化判断容器内液面高度。对于准备电赛的同学建议在赛前就把FDC2214的基本驱动调通做一个能稳定读取数值的最小系统比赛时就可以把精力集中在算法和结构设计上。本文还有配套的精品资源点击获取