简介这份压缩包围绕TI CC1101无线收发器提供基于51单片机STC15系列的完整驱动与示例工程适合正在学习SPI通信或搭建短距离无线链路的开发者。包内同时给出IO模拟SPI与内部硬件SPI两套实现便于对比两种方式的时序差异与适用场景。资源共39个文件以C源码、H头文件、Keil工程文件为主另含Hex固件、备份文件及编译中间文件压缩后仅103KB轻量且结构清晰。目前已有176人学习下载。借助其中代码可快速完成CC1101寄存器配置、数据收发函数移植并结合发送/接收Demo验证无线链路对初学者而言还能通过实际工程理解SPI时序、射频参数设置及51单片机外设初始化流程为无线传感网络、遥控器等应用开发提供可直接参考的起点。 很多朋友拿到“CC1101程序.rar”这个压缩包之后下意识就是解压、编译、烧录然后对着串口等数据。这个流程我见过太多人卡住一卡就是一两周。CC1101这颗Sub-1G收发芯片的代码难度从来不在“写不出来”而在它的初始化顺序、状态机切换、FIFO读写只要有一处和手册拧着来现象就变成“代码跑起来了但两端死活不通”。这篇就顺着一个典型的CC1101程序压缩包从工程结构、寄存器配置、收发流程、板级调试一路拆到移植注意事项适合刚拿到现成工程想快速搬到STM32或51平台上的工程师也适合第一次把Sub-1G无线链路加进自己产品的朋友。1. 看到“CC1101程序.rar”之前先确认这颗芯片到底在解决什么问题CC1101是TI出的一款低频段无线收发芯片工作频率覆盖315/433/868/915MHz等典型Sub-1G频段最大输出功率可以配置到10dBm左右接收灵敏度能做到-110dBm量级。它解决的核心问题只有一个在比2.4G更低的频段上用更低的功耗把数据传得更远同时穿透能力还更强。你在智能家居网关、无线抄表模块、车库门遥控器、农业大棚传感器、无人机遥控链路里看到的“无线模块”相当一部分的主控就是这颗芯片。很多第一次用CC1101的人容易拿它和nRF24L01放在一起比。两者确实都是SPI接口、都有收发FIFO、都能用GDO引脚做中断但从选型逻辑上其实是两个物种。对比项CC1101nRF24L01典型频段433MHz / 868MHz / 915MHz2.4GHz空旷传输距离同功率更远绕射能力更强相对近直线视距优势穿透能力好低频优势一般功耗接收电流约15-20mA睡眠可做到微安级接收电流约12-14mA配置复杂度寄存器多状态机需要理解相对简单典型应用工业采集、远距离遥控、传感器网络鼠标、遥控器、短距透传如果你的项目要求“隔着几堵墙还能稳定收数据”那CC1101明显更合适如果只是桌面级短距离透传nRF24L01上手更快。这里插一句我常和同事说的话拿到一个“CC1101程序.rar”你先别急着看代码先回答三个问题——通信距离按多少米设计电池能不能撑住期望的待机时间数据是单向上报还是要双向握手这三个答案直接决定你后面怎么改寄存器、怎么配GDO中断、怎么设计收发状态机。很多人程序抄过来跑不通根子就在一开始没想清楚自己到底要什么。2. 解压之后不迷路一套CC1101工程的文件结构和硬件接线把“CC1101程序.rar”解压开你大概率会看到下面这类结构不同人整理的工程风格不同但骨架很相似CC1101_Demo/ ├─ App/ │ ├─ main.c // 主循环和收发逻辑 │ └─ cc1101_app.c // 应用层封装比如组包、拆包、重传 ├─ Drivers/ │ ├─ cc1101.c // CC1101驱动寄存器读写、收发控制 │ └─ cc1101.h ├─ Hardware/ │ ├─ spi.c // MCU的SPI底层 │ ├─ gpio.c // GDO0、GDO2、CSN引脚配置 │ └─ usart.c // 调试串口 └─ User/ ├─ config.h // 频点、速率、信道、引脚定义 └─ delay.c这里我先提醒一句不要指望这套工程解压出来就能在你的板子上编译通过。它多半对应某个具体开发板引脚号、SPI外设、晶振频率、甚至串口波特率都可能和你的硬件不一样。所以第一步不是看main.c里怎么收发而是先看config.h和Hardware目录把引脚映射摸清楚。CC1101的对外接口一共就那么几根搞清楚它们比读懂任何一行代码都重要引脚方向作用SCLK输入SPI时钟MOSI输入SPI主机到从机数据MISO输出SPI从机到主机数据CSN输入片选低电平有效GDO0输出通用数字输出可配置为TX/RX中断、FIFO状态等GDO2输出另一路数字输出可配置为时钟输出或者第二个状态指示CC1101的SPI从机特性比较“刚性”一次读写操作必须由CSN下降沿开始、上升沿结束中间时钟数目不能多也不能少。很多刚开始移植的朋友喜欢用软件翻转GPIO去模拟SPI时序不是不行但时序宽松度比较差稍微有点干扰就丢字节我建议直接上MCU硬件SPI把速度压在10MHz以内协议模式选SPI Mode 0CPOL0CPHA0。如果你手里的现成驱动是GPIO模拟先别扔验证硬件时它反而特别好用——每个字节的时钟都是手动给的逻辑分析仪上一眼就能看出时序对不对。GDO0这根引脚在大多数例程里被配置成中断输出发送完成时拉高、接收数据准备好时拉高。它可以直接接MCU的外部中断引脚实现“收发都不用轮询”的效果。我在实际项目里会把GDO0接到EXTI中断线上把GDO2空出来或者接到示波器上看内部时钟校准信号。3. 第一行代码为什么这么写初始化流程里那些“抄了就错”的细节很多搬过来的程序跑不通问题不在收发逻辑而在初始化。CC1101上电后不是直接就能收发数据的必须走完“写寄存器配置、设置频率字、校准、进入期望状态”这条固定链路。先看最底层的东西读版本号和复位。CC1101支持一个非常方便的寄存器回读操作SPI读PARTNUM寄存器地址0x30和VERSION寄存器地址0x31能分别读到芯片型号和版本信息。这是验证你的SPI底层通没通的黄金手段。比如版本寄存器读回来是0x04或0x14说明芯片响应正常如果读回来全是0xFF或者0x00基本就是SPI接线、CSN控制或者电源有问题不用继续往下查了。复位操作也值得说。CC1101提供了一个命令选通字节0x30也就是把SRES命令写到SPI总线上。这个命令会让芯片执行一次完整的复位和内部校准所有寄存器恢复默认值。注意很多程序在初始化之前不先发这个命令如果你手中的例程是从“上次跑过别的配置”的芯片上接着跑的残留寄存器状态可能导致后续配置全部错位。所以我的习惯是初始化第一步永远是// 拉低CSN写入SRES命令选通字节拉高CSN CSN_LOW(); spi_write_byte(0x30); CSN_HIGH(); // 芯片复位并进入IDLE状态等待内部校准完成 // 这里至少等待几百微秒再操作寄存器 delay_us(300);然后才是写寄存器组。CC1101的寄存器地址规则要注意地址最高位是0表示写操作是1表示读操作你想把配置连续写进多个寄存器可以用burst写模式但一定要把地址的低5位从起始地址开始连续递增。对于最常用的40多个配置寄存器地址0x00到0x2E附近TI官方工具SmartRF Studio可以生成一套完整配置许多例程里的CC1101_Init函数其实就是在刷这一大张表。但这里恰恰是很多人翻车的地方。SmartRF Studio生成的配置对应的是它界面里填的频率、数据速率、调制方式、信道间隔你把工具里的配置直接复制进你的程序却不看工具界面上填的是什么参数后面一旦要做频率、速率调整就完全抓瞎。所以我不建议把配置表只当“黑盒数据”用至少要吃透下面几个关键计算。先看频率字。CC1101的载波频率由FREQ2、FREQ1、FREQ0三个寄存器的23位值决定载波频率 (FREQ[22:0] / 2^16) × 晶振频率这里晶振频率通常是26MHz。举个例子如果我们希望工作在433.92MHz那么FREQ字 (433.92MHz / 26MHz) × 65536 ≈ 1092892转成十六进制就是0x10A6B3于是FREQ20x10、FREQ10xA6、FREQ00xB3。反过来拿到一份陌生例程里的0x10A6B3你也能立刻算出它的工作频点大约在433.92MHz附近。不同模块如果晶振不是26MHz而是24MHz或其他值同一个FREQ字对应的实际频点完全不同——这是两个“同一套CC1101程序”在两个板子上一个通一个不通的常见原因。再看数据速率。数据速率的配置分散在MDMCFG4的高4位DRATE_E指数和MDMCFG3的8位DRATE_M尾数里数据速率 (256 DRATE_M) × 2^DRATE_E / 2^28 × 晶振频率比如想配置2.4kbps对应DRATE_E大约是0x05、DRATE_M大约0x3A不同误差取舍略有差别。SmartRF Studio的好处在于它会直接给你算好这两个寄存器的值并且显示误差百分比你在工具里改一下速率它立刻重新计算比手算快得多。调制方式和包格式方面MDMCFG2寄存器决定了调制方式FSK、GFSK、OOK等和同步字检测模式PKTCTRL0和PKTCTRL1决定是否启用CRC、数据包长度模式、地址检查等。入门调试阶段我的建议是调制方式用GFSK或2-FSK同步字用默认的0xD391D391固定长度包模式先跑通再说。不要一上来就开WP白化、开地址过滤、开可变长包排查起来变量太多。4. 收发流程不是“发完就完”状态机与FIFO的正确配合方式CC1101内部是个有限状态机主要状态有IDLE、TX、RX、FSTXON、CALIBRATE等。你写的代码本质上就是“通过命令选通字节让芯片在这几个状态之间跳转”而状态切错是丢数据的最常见原因。发送侧的标准流程是这样的先确保芯片在IDLE然后往TX FIFO里写入应用层数据再发送STX命令选通字节让芯片进入TX状态。芯片会自动完成前导码、同步字、CRC的插入和发送发送完成后GDO0会产生一个发送结束中断。我写驱动时发送函数会带上一个状态机保护// 发送一包数据data为应用数据指针len为长度 uint8_t CC1101_SendPacket(uint8_t *data, uint8_t len) { // 先确保回到IDLE CC1101_CmdStrobe(CC1101_SIDLE); // 清空TX FIFO避免上次未发完的残余数据导致问题 CC1101_CmdStrobe(CC1101_SFTX); CC1101_WriteBurst(CC1101_TXFIFO, data, len); // 进入TX状态开始发送 CC1101_CmdStrobe(CC1101_STX); // 等待GDO0拉高或在此处做超时保护 while (!CC1101_GDO0_Read()) { if (timeout 0xFFFF) { // 超时处理回到IDLE清FIFO CC1101_CmdStrobe(CC1101_SIDLE); return 0; } } CC1101_GDO0_ClearFlag(); // 根据中断方式决定是否需要清标志 return 1; }这段代码里有一个非常容易被忽略的细节发送前一定要执行SFTX清空TX FIFO。很多人只是在初始化时清一次后面重复发送时上次的残留字节如果没发干净就会跟在这次数据后面一起发出去接收端看到的数据就“多了一段”。同理接收前执行SFRX清空RX FIFO也是避免读取到历史残留数据的必要操作。接收侧的标准流程则要注意数据读取时机。芯片处于RX状态后GDO0会在检测到完整数据包并写入RX FIFO时拉高MCU在中断里把RX FIFO里的数据读出来。读取时有一点非常关键不要只读数据字节还要把紧接着的第二个字节读地址0x3F时读出的最后一个字节作为“CRC状态和RSSI/LQI信息”一起读走否则下次接收时FIFO指针会错位。uint8_t CC1101_ReceivePacket(uint8_t *buf, uint8_t *rssi, uint8_t *lqi) { if (!CC1101_GDO0_Read()) return 0; // 无数据 if (CC1101_ReadReg(CC1101_RXBYTES) 0) { // 读取全部FIFO内容 最后两个状态字节 CC1101_ReadBurst(CC1101_RXFIFO, buf, pktLen); CC1101_ReadBurst(CC1101_RXFIFO, status, 2); *rssi status[0]; *lqi status[1] 0x7F; return pktLen; } return 0; }这里还有个状态机最容易被绕晕的地方如果你一直在等接收主循环或中断读完数据后芯片通常会自动回到RX状态继续监听前提是MCSM1寄存器里把RXOFF_MODE配成0x01接收完成后继续回到RX或0x10回到IDLE。很多例程里读完成功之后还会手动再发一次SRX命令问题也不大但性能会差一点因为中间多了一个IDLE→RX的切换可能漏掉紧接着的第二包数据。我在做数据量稍大的遥测链路时都倾向让芯片接收完成后自动回RX而不是靠MCU再次下发SRX。发送完成之后的处理也类似MCSM0寄存器的TXOFF_MODE如果配成0x01芯片发完会自动切回RX适合半双工对讲式应用配成0x10则回到IDLE适合“发完就睡”的低功耗场景。这块配置一定要和你的应用模型匹配否则省电效果和响应速度都会变差。5. 板子调不通别急着改程序一条五级定位法查透硬件和软件这个章节值得每一个正在“盲调CC1101”的人反复看。我见过太多人现象是“两端明明都在发数据就是收不到”于是开始疯狂改寄存器、换同步字、调数据速率最后发现只是天线没焊牢。所以当你遇到CC1101完全不通时先按下面这条链路逐级排查。级别检查对象判断方法常见故障1SPI通路读VERSION寄存器应返回0x04/0x14等接线、SCLK极性、电平不匹配2晶振与芯片复位用示波器看晶振引脚是否有26MHz波形晶振不起振、负载电容配错3载波发射TX时用频谱仪或另一块CC1101看射频端是否有信号频率字配置错误、PA表不对4空中协议确认两端频点、速率、同步字、调制方式完全一致参数不同最常见的“配置不一致”5天线与匹配网络检查天线焊盘、电容电感是否按参考设计天线脱落、阻抗失配导致距离极短第一级和第二级通常能排除绝大多数“板子级”问题。晶振这里要特别说一句CC1101的晶振要求26MHz而且负载电容不是随便选的。很多模块用了内部集成的负载电容但如果你自己画板子必须按参考设计把两只负载电容通常是十几pF级别放在晶振两边如果省略或者放太小晶振起振没问题但频偏会超出芯片自动校准范围后果就是接收灵敏度大幅下降明明面对面能通隔一面墙就掉线。第三级开始需要工具或者另一块已知正常的模块。我用得最笨也最有效的方法是把两块板子放在同一张桌上互相发数据一块只发、一块只收中间用逻辑分析仪抓GDO0引脚。发射端GDO0有正常的发送中断脉冲说明芯片配置和FIFO写入没问题接收端GDO0一直不拉高问题就在空中协议配置接收端GDO0拉高了但MCU没读到数据问题就在FIFO读取时序。这里分享一个我踩过的坑非常有代表性。有一次我调一对模块接收端显示RSSI很强但就是解不出数据包。我查了频点、速率、同步字全部一致最后用逻辑分析仪对比发射端和接收端的GDO0脉冲宽度发现接收端GDO0虽然有动作但非常短促连续抓包时不稳定。后来查到问题是MDMCFG2里的同步字模式不一致发射端用了30/32位同步字检测接收端被例程改成了16/16位芯片对前导码和同步字的判断标准完全不同导致明明看起来“能收到能量”却始终解不出有效包。从那以后我调CC1101的第一件事就是拿一张纸把两端的关键配置参数并排写下来逐项打勾。还有一个容易被忽略的干扰源是电源。CC1101发射瞬间电流会拉到20mA以上如果供电走线细、稳压器余量不足发射瞬间电压跌落就会导致频率合成器失锁表现为“发射时报错”或“接收端灵敏度飘忽”。调试时别光盯数字用示波器看芯片供电引脚发射瞬间掉压超过100mV就要先解决电源再去动代码。6. 移植到自己的板子上硬件、配置和实测三个维度的检查清单当你手里的“CC1101程序.rar”已经能在原开发板上跑通接下来就是移植到自己的板子。这一步很多人只改引脚和SPI忽略了硬件参数和运行策略的差异最后返工的事我见得太多了。先说硬件层面的检查清单。第一晶体频率必须是芯片设计对应的标称值绝大部分模块是26MHz但市面上也有24MHz版本RA改代码前先确认原理图第二天线匹配网络不要随手抄433MHz和868MHz的参考设计电容电感值不同混用会导致匹配严重失配本来应该能传几百米的距离缩水到几十米第三GDO0和CSN是否连到了MCU支持外部中断且支持快速电平翻转的引脚CSN翻转过慢会在SPI高速通信时引入意外片选脉冲。软件层面的修改清单同样不能省。确认SPI模式是Mode 0时钟不超过10MHz确认所有延时函数在新平台上的真实延时是否准确很多从STM32移植到别的MCU的程序直接在delay函数里踩坑延时短了芯片还没完成校准就下一个命令进来确认串口调试输出端口变更后波特率是否匹配最后把SmartRF Studio里的频率、速率、信道配置和新板子的晶振频率代入公式重新核算一遍不要觉得“原程序这么写肯定没问题”。移植完成后我强烈建议不要一口气把所有功能都打开而是分三步验证只做单包收发发射端按键触发一包固定内容接收端收到后点亮LED验证最基础链路。加入CRC校验和RSSI/LQI解析确认你读出来的状态字节符合预期。再开地址过滤、可变长包、低功耗唤醒等进阶功能每一步都要能单独验证。最后还有一个低功耗场景的经验分享。如果你的产品是电池供电CC1101的SPWD命令选通字节可以把它置入睡眠模式电流掉到微安级。但很多人在设计时忘了睡眠之后GDO0接的MCU外部中断引脚必须在芯片睡眠期间保持可控状态否则漏电会把省下的电流又还回去。我在一个项目里实测过芯片睡眠电流只有0.3uA左右但因为GDO0上拉电阻没做好整机待机电流反而多了4uA找了好久才发现问题出在引脚电平而不是芯片本身。这类细节正是“CC1101程序.rar”里看不到又决定项目成败的地方。本文还有配套的精品资源点击获取