简介这份资源是面向嵌入式开发者的PCAP01芯片SPI主设备编程代码包适合正在使用或评估ACAM公司PCAP01芯片、需要快速打通SPI通信链路的工程师与电子爱好者。压缩包内共1个文件为C语言源码整体约8KB核心内容围绕SPI初始化、数据读写、错误检查与芯片寄存器配置等关键环节展开可直接作为项目移植与二次开发的起点。该代码由ACAM公司提供并经使用者验证具备良好的可用性能帮助读者省去从零摸索协议细节的时间快速理解PCAP01的通信时序与命令格式并在此基础上完成数据采集或信号处理功能的对接。目前已有2040人学习下载说明其在同类芯片开发中具有较高的参考价值适合作为SPI驱动调试与芯片功能验证的实用素材。1. 拿到 PCAP01_SPI_main 编程代码压缩包先别急着解压如果你手里正好有一个PCAP01_SPI_main编程代码.zip大概率你正在做电容式传感器采集或者更具体一点——用 PCAP01 这颗芯片测微小电容变化再通过 SPI 把数据读回主控。这个压缩包名字里的三个信息点很关键PCAP01 是那颗电容数字转换芯片SPI 是它和 MCU 之间的通信方式main 说明里面至少有一份主程序入口。很多人拿到这类代码包的第一反应是直接解压、打开 IDE、点编译然后被一堆寄存器配置和时序注释劝退。我一般会先做三件事确认芯片固件版本、确认主控平台、确认 SPI 模式。因为 PCAP01 的 SPI 不是标准四线全双工那么简单它涉及固件加载、SRAM 读写、中断状态轮询顺序错了读回来的就是一堆 0x00 或 0xFF。这篇笔记就按「先看懂代码结构、再跑通最小读写、最后调参数和排错」的路径走适合刚接触 PCAP01 的嵌入式工程师也适合已经能跑但数据不稳、想回头查配置的人。2. PCAP01_SPI_main 代码包的结构与启动链路2.1 压缩包里通常有哪些文件各自负责什么一个典型的 PCAP01 SPI 主程序包解压后不会只有一份 main.c。常见结构是一份主程序文件、一份 PCAP01 驱动文件、一份 SPI 底层接口文件、一份固件数组头文件外加一个工程文件或 Makefile。主程序负责初始化顺序和主循环调度驱动文件里是寄存器读写、固件下载、结果读取这些函数SPI 接口文件负责把主控的 SPI 收发封装成驱动能调用的形式固件数组头文件是一长串十六进制数对应 PCAP01 内部 DSP 要跑的固件。很多人编译报错「undefined reference」就是因为固件数组没被正确包含或者驱动里引用的 SPI 函数名和底层实现不一致。我一般会先看主程序里的初始化顺序因为 PCAP01 的上电流程有硬性要求。典型顺序是主控时钟和 GPIO 初始化、SPI 外设初始化、PCAP01 复位引脚拉低再拉高、等待固件加载完成、配置测量模式、开中断或开始轮询。如果复位和固件加载之间插入太多延时或顺序颠倒芯片不会进入正常测量状态。代码包里如果有一份pcap01_config.h里面通常定义了测量范围、转换速率、触发方式这些宏先扫一眼这些值后面调参才有方向。2.2 从 main 入口看 PCAP01 的 SPI 启动时序下面这段是常见的主程序骨架我按可复现的方式写出来芯片型号和引脚名用通用写法你对照自己的代码包替换即可。#include pcap01_driver.h #include spi_interface.h int main(void) { /* 1. 主控底层初始化时钟、GPIO、调试串口 */ board_init(); /* 2. SPI 外设初始化模式、速率、片选引脚 */ spi_init(SPI_MODE_1, 1000000); /* PCAP01 常用模式 1速率先降到 1MHz */ /* 3. PCAP01 硬件复位拉低至少 100us 再拉高 */ pcap01_reset_pin_low(); delay_us(200); pcap01_reset_pin_high(); delay_ms(5); /* 等待内部上电稳定 */ /* 4. 加载固件到 PCAP01 内部 SRAM */ if (pcap01_load_firmware(firmware_array, FIRMWARE_SIZE) ! 0) { debug_print(firmware load failed\r\n); while (1); /* 固件加载失败后续无意义 */ } /* 5. 配置测量模式单次或连续量程和转换速率 */ pcap01_config_measurement(MEAS_MODE_CONTINUOUS, RANGE_10PF, RATE_10KHZ); /* 6. 主循环轮询中断状态并读取结果 */ while (1) { if (pcap01_data_ready()) { uint32_t cap_raw pcap01_read_result(); float cap_pf pcap01_raw_to_pf(cap_raw); debug_print_float(cap_pf); } } }这段代码的逻辑说明第一步board_init是主控自己的事和 PCAP01 无关但必须最先做否则 SPI 引脚可能没被正确复用。第二步spi_init里模式选 1 是常见做法因为 PCAP01 在 SCLK 上升沿采样、下降沿移出具体以你手上的数据手册为准。速率先给 1MHz 是为了排错等通信稳定后再往上提。第三步复位脉冲宽度不能太短200us 是保守值太短芯片可能没识别到复位。第四步固件加载是 PCAP01 和普通 SPI 从机最大的区别它内部没有 ROM必须由主控把固件写进 SRAM写完后还要回读校验。第五步配置测量模式量程和速率直接决定后面读回来的原始值怎么换算。第六步主循环里pcap01_data_ready通常是读状态寄存器或查中断引脚不要用固定延时去读否则会读到旧数据。参数说明SPI_MODE_1对应 CPOL0、CPHA1如果你的主控库用 0/1/2/3 编号要确认映射关系。1000000是 SPI 时钟频率单位 HzPCAP01 支持更高但排错阶段建议不超过 2MHz。FIRMWARE_SIZE是固件数组长度必须和头文件里定义的一致少一个字节都会导致校验失败。RANGE_10PF和RATE_10KHZ是示例宏实际可选范围看驱动头文件量程选小了会饱和选大了分辨率下降。2.3 固件数组和寄存器读写PCAP01 不是普通 SPI 从机普通 SPI 从机你发命令它回数据PCAP01 不是。它上电后是一块「空白的 DSP」必须先通过 SPI 把固件写进去写完后它才开始按固件逻辑工作。固件数组通常是一个const uint8_t或const uint16_t的大数组长度从几千到上万不等。加载过程一般是拉低片选、发写 SRAM 命令、发地址高字节、发地址低字节、连续发固件数据、拉高片选。每发一批还要回读校验校验不过就重来。寄存器读写也分页。PCAP01 内部寄存器地址空间不是线性的常见做法是先写页选择寄存器再写目标寄存器。如果你发现读回来的值总是某个固定值先检查页选择有没有配对。我见过一个血泪经验驱动里读结果函数先读了结果寄存器但忘了切回测量页下一次配置就写到了错误页现象是第一次测量正常第二次开始全是 0。这种问题看代码很难一眼发现只能靠打印页寄存器和目标寄存器地址来定位。3. 用最小 SPI 读写把 PCAP01 跑通3.1 先写一个只读芯片 ID 的测试函数在跑完整测量之前先确认 SPI 物理层是通的。PCAP01 一般有芯片 ID 或版本寄存器读它不需要加载固件只要上电和复位正确就能读。下面是一个最小测试函数。uint16_t pcap01_read_chip_id(void) { uint8_t tx_buf[4]; uint8_t rx_buf[4]; /* 命令格式读寄存器地址为芯片 ID 寄存器 */ tx_buf[0] 0x40; /* 读命令操作码具体值查手册 */ tx_buf[1] 0x00; /* 地址高字节 */ tx_buf[2] 0x00; /* 地址低字节 */ tx_buf[3] 0x00; /* 占位用于移出数据 */ spi_cs_low(); spi_transfer(tx_buf, rx_buf, 4); spi_cs_high(); /* 返回值通常在 rx_buf[2] 和 rx_buf[3] 拼起来 */ return ((uint16_t)rx_buf[2] 8) | rx_buf[3]; }逻辑说明tx_buf[0]是操作码读和写的操作码不同具体值必须查你手上那份数据手册不同固件版本可能不一样。tx_buf[1]和tx_buf[2]是地址芯片 ID 寄存器地址通常是 0x0000 或某个固定值。tx_buf[3]是占位字节因为 SPI 是全双工你要移出从机的数据就必须给主机发一个字节。返回值拼接位置取决于芯片是 8 位还是 16 位数据宽度PCAP01 常见是 16 位所以取 rx_buf[2] 和 rx_buf[3]。参数说明spi_transfer是阻塞式收发发一个字节收一个字节。如果你的主控库只有spi_send和spi_receive分开的接口要自己拼一个。片选spi_cs_low和spi_cs_high必须包住整个 4 字节传输中间不能拉高否则 PCAP01 会认为命令结束。读回来的 ID 如果全是 0xFF先查 MISO 有没有接反或上拉如果全是 0x00查 MOSI 和时钟有没有输出。3.2 固件加载的四个关键参数固件加载是 PCAP01 最容易翻车的一步。下面这张表是我一般会核对的四个参数。参数常见值作用设错的现象复位脉冲宽度100us 以上让芯片进入已知状态太短则固件加载命令无响应固件分块大小32 或 64 字节每次连续写入的长度太大则校验失败太小则加载慢校验方式回读比对确认 SRAM 写入正确不校验则后面测量全错加载后延时1ms 以上等 DSP 启动太短则第一次配置无效固件加载函数一般长这样int pcap01_load_firmware(const uint8_t *fw, uint32_t len) { uint32_t offset 0; uint8_t chunk[64]; while (offset len) { uint32_t remain len - offset; uint32_t n (remain 64) ? 64 : remain; /* 发写 SRAM 命令和起始地址 */ pcap01_write_sram_start(offset); /* 连续写 n 个字节 */ for (uint32_t i 0; i n; i) { chunk[i] fw[offset i]; } pcap01_write_sram_data(chunk, n); /* 回读校验 */ if (pcap01_verify_sram(offset, chunk, n) ! 0) { return -1; } offset n; } return 0; }逻辑说明pcap01_write_sram_start负责发命令和地址pcap01_write_sram_data负责连续写数据。每写一块就回读校验校验不过立即返回错误不要继续往下写。chunk大小选 64 是折中太小加载慢太大有些主控的 SPI 缓冲区放不下。回读校验函数里要注意读 SRAM 和读寄存器的命令可能不同别混用。参数说明len必须和固件数组实际长度一致用sizeof(firmware_array)时注意数组是不是uint8_t如果是uint16_t要乘 2。offset是字节偏移不是字偏移PCAP01 的 SRAM 地址通常按字节编。校验失败时先看是固定位置失败还是随机失败固定位置失败多半是固件数组本身有问题随机失败多半是 SPI 速率太高或电源不稳。3.3 测量结果读取与原始值换算固件加载成功、配置写完后就可以读结果了。PCAP01 的结果寄存器通常是 24 位或 32 位读回来是原始码值要换算成电容值需要知道参考电容和量程。常见换算方式是线性映射cap_pf (raw / full_scale) * range_pf。但实际芯片内部可能有增益和偏移所以更可靠的做法是两点校准测一个已知电容 C1 得到 raw1测 C2 得到 raw2然后线性拟合。float pcap01_raw_to_pf(uint32_t raw) { /* 两点校准示例C11pF 对应 raw1C210pF 对应 raw2 */ const float C1 1.0f, C2 10.0f; const uint32_t raw1 120000, raw2 980000; float slope (C2 - C1) / (float)(raw2 - raw1); return C1 slope * (float)(raw - raw1); }逻辑说明raw1和raw2是你实测得到的原始值不是手册上的典型值。slope是每单位原始码值对应的电容变化。这个函数假设线性度足够好如果非线性明显就要分段拟合或查表。参数说明C1和C2选你实际能拿到的标准电容差距不要太小否则斜率误差大。raw1和raw2要在同一量程和同一转换速率下测中途改配置会失效。4. PCAP01 SPI 编程的避坑与排查4.1 固件加载后读回全是 0xFF现象固件加载函数返回成功但读结果寄存器全是 0xFF或者读芯片 ID 也变成 0xFF。原因SPI 模式不对或者片选在传输中间被拉高。PCAP01 对时钟极性和相位敏感模式 0 和模式 1 读出来的数据可能完全相反。解决先用示波器看 SCLK 和 MOSI 的相位关系确认 CPOL 和 CPHA 设置和手册一致。片选要用 GPIO 手动控制不要用硬件自动片选因为固件加载是多字节连续传输硬件片选可能在字节间拉高。4.2 第一次测量正常第二次开始数据不变现象上电后第一次读结果正常之后每次读都是同一个值。原因结果寄存器没有更新或者中断标志没清。PCAP01 在连续测量模式下每次转换完成会置中断标志如果你不读状态寄存器或不清标志它可能不再更新结果寄存器。解决在pcap01_data_ready里先读状态寄存器确认有新数据标志读完结果后再清标志。有些驱动把清标志放在读结果函数里顺序不能反。4.3 量程选小了导致数据饱和现象电容稍微变大原始值就到顶不再变化。原因测量量程设置小于实际电容变化范围。PCAP01 的量程和内部参考电容有关选小了会饱和选大了分辨率下降。解决先估算你的电容变化范围比如基线 5pF、变化 ±2pF那量程至少选 10pF 或 15pF。如果不知道范围先用最大量程跑一遍看原始值占满量程的百分比再往下调。4.4 SPI 速率提高后数据偶发错误现象1MHz 时正常提到 5MHz 或 10MHz 后偶尔读到错误值。原因信号完整性或从机建立时间不够。PCAP01 的 SCLK 最高频率有上限而且和电源电压、走线长度有关。解决先降回 1MHz 确认功能正常再逐步提高每提一档跑长时间测试。如果必须高速缩短 SPI 走线、加地线隔离、在 SCLK 上串小电阻。另外注意主控 SPI 分频系数有些库的「10MHz」实际是 9MHz 或 12MHz要看时钟树。4.5 固件数组编译后占用空间过大现象编译报错 region overflow或者链接后固件数组占了大部分 Flash。原因固件数组用const uint8_t定义但没放到只读段或者数组被复制到了 RAM。解决确认数组定义前有const并且在链接脚本里把只读数据放到 Flash。如果主控 RAM 小不要在运行时把固件数组拷到 RAM 再加载直接通过 SPI 从 Flash 读一块发一块。有些驱动为了「方便」先把固件读到缓冲区结果 RAM 不够这种要改成分块流式加载。5. 把 PCAP01 测量做稳的几个进阶习惯5.1 用状态机替代主循环里的阻塞延时很多示例代码在主循环里用delay_ms等转换完成这在低速率下能用但速率一高就丢数据。我一般会写一个简单状态机空闲态检查数据就绪标志就绪后读结果、换算、存缓冲区然后回到空闲。这样主循环里没有长延时还能同时处理串口打印和按键。状态机不需要复杂框架一个switch加一个静态变量就够。5.2 原始值先做滑动平均再换算PCAP01 的原始码值即使静止也会有几十到几百的跳动直接换算成电容值会看到明显噪声。我习惯在原始值层面做 8 点或 16 点滑动平均再送换算函数。滑动平均窗口不要太大否则响应变慢。如果被测电容变化很慢可以用 32 点如果要抓快速变化用 4 点或不做平均改在后续做数字滤波。5.3 保留一份「已知良好」的配置备份调参过程中很容易把某个寄存器改乱然后忘了原来值。我的习惯是一旦跑通一个稳定配置就把所有寄存器值打印出来存成一份头文件或数组。后面再调参时先加载这份备份再改要动的那个寄存器。这样即使改坏了也能快速回到已知良好状态。这个习惯帮我省过很多次「后悔药」尤其是页选择寄存器和量程寄存器改错一个后面全乱。5.4 用串口打印关键中间值而不是只打印最终电容排错时只打印最终电容值信息不够。我一般会在固件加载后打印校验结果在配置后回读关键寄存器并打印在每次读结果时打印原始码值和状态寄存器。这样一旦数据异常能快速判断是固件没加载好、配置没写进去还是结果读取时序有问题。打印会占用时间所以只在排错阶段开稳定后关掉或降频。5.5 注意电源和参考电容的稳定性PCAP01 测的是微小电容变化电源纹波和参考电容温漂都会直接反映到数据里。如果发现数据缓慢漂移先查电源是不是用了开关电源且纹波较大再查参考电容是不是温度系数高的类型。我一般会在 PCAP01 电源引脚附近放 1uF 和 100nF 并联参考电容用 C0G 或 NP0 材质。这些是硬件的事但软件调参前先排除硬件问题否则会在代码里白折腾很久。最后说一个我自己的教训刚接触 PCAP01 时我以为 SPI 通了就能读数据结果卡在固件加载上一整天后来发现是复位脉冲太短芯片根本没进入加载模式。从那以后我拿到任何带固件的传感器代码包第一件事就是拿示波器看复位和片选波形确认时序对了再调软件。希望帮到你。本文还有配套的精品资源点击获取