简介基于STM8的LT8920无线模块测试程序面向嵌入式无线通信开发者和STM8初学者旨在解决LT8920芯片与STM8单片机的快速联调与数据收发问题。资源共62个文件压缩包仅825KB主要包含c/h源码、IAR工程文件ewp/ewd/eww、十六进制固件hex及编译输出文件out/o等可直接导入STM8开发环境查看、编译与烧录。目前已有1054人学习下载源码中涵盖了LT8920驱动、SPI通信、数据打包解包以及发送接收示例便于对照理解2.4G无线链路的工作流程。通过修改工程可实现自定义帧格式、调整发射功率与接收灵敏度适应不同距离和场景需求配套的工程配置和驱动代码也可作为二次开发的基础模板为后续项目提供参考。 我接触LT8920这块2.4GHz无线芯片是因为一个无线鼠标项目。原本方案用的是nRF24L01但采购拿到LT8920的样品价格更低仓库里也有现成模块让我先写个测试程序看看能不能替代。于是就有了这套基于STM8的LT8920无线模块测试程序折腾了大概两个晚上自己搭了一套可复用的收发测试代码。LT8920是一颗2.4GHz GFSK收发芯片SPI接口控制常用于无线鼠标、无线音频、遥控器这类短距离无线产品。和nRF24L01那种“寄存器预定义好、基本照抄就行”的芯片不同LT8920的寄存器配置灵活发射频率、数据速率、发射功率、PLL参数这些都要自己计算和写入所以测试程序的“桥梁”作用特别明显。STM8则是小家电、低成本无线产品里很常见的8位MCU开发环境成熟外设够用用它来驱动LT8920既适合快速验证模块也方便后面直接移植到正式固件。这篇内容写给谁看给那些和我一样手头刚拿到LT8920模块或者已经焊好板子但不知道寄存器该怎么配、硬件该怎么连的开发者。我会把硬件接线、开发环境、初始化流程、收发测试代码和测试中踩过的坑全部写出来内容偏向实操看完照着做基本能跑通一轮最简单的收发。1. 测试程序的定位不是量产固件是“芯片能不能用”的判官写LT8920测试程序之前先得想清楚一个问题这个测试程序到底要回答什么很多人拿到模块就直接去翻数据手册想把每个寄存器都弄明白结果陷进去出不来。我自己的经验是测试阶段最重要的是建立几个明确的“验收指标”程序只要能回答这几个问题就算完成使命。1.1 测试程序要回答的四个问题第一个问题模块通电后能不能正常响应SPI命令这里面包含芯片本身的供电、地线连接、SPI引脚是否焊好等。第二个问题寄存器读写是否正确如果写进去的值和读出来的值不一致后面的配置全都不作数。第三个问题芯片能不能进入发射/接收状态GIO引脚能不能给出正确的状态变化。第四个问题两块模块之间能不能正常收发数据误码率在可接受范围内。这四个问题层层递进从“芯片活着”到“芯片能用”每一层都可能卡住。我看过不少同事拿模块不先做寄存器回读上来就配置发射结果信号那边怎么都收不到最后排查半天发现是写寄存器时字节顺序反了。所以这套测试程序的第一个模块就是SPI读写回环测试把全部关键寄存器读出来和写进去的值比对再把结果通过串口打印出来。1.2 为什么用STM8而不是直接拿上位机USB转SPI可能有人会问测试LT8920用USB转SPI工具接上位机写脚本不也挺方便确实可以但有几个问题一是很多上位机工具模拟的SPI时序和MCU实际跑出来的时序有差异LT8920这类芯片对时序还是有要求的特别是片选和SCK的配合二是最后产品固件肯定要跑在MCU上直接用STM8来测后面代码可以无缝迁移不用二次开发。用STM8还有一个好处它的GPIO中断和定时器资源足够处理LT8920的GIO状态检测也能方便地加软件延时。测试程序里我用了一个普通的按键触发发射接收端用串口打印收到的数据整个调试过程非常直观。STM8的串口、SPI、GPIO这些外设的库函数现在也比较成熟写测试程序不用自己从头造轮子。我在工程里直接用了寄存器操作加少量库函数这样代码量可控核心逻辑清晰。2. 硬件连线STM8与LT8920的SPI接线说完了测试程序的定位接下来讲硬件。LT8920模块一般会做成一个小的PCB模块引脚包括VCC、GND、CS、SCK、SI、SO、GIO1、GIO2之类的。拿到模块后先看清楚丝印找手册确认每个引脚的功能再决定怎么接到STM8上。2.1 引脚对应与最小电路我用的主控是STM8S103F3P6这个芯片算是STM8家族里的入门型号Flash有8KBRAM有1KB对于跑一个无线模块测试程序来说绰绰有余。LT8920模块与STM8的接线如下表所示LT8920模块引脚连接到STM8说明VCC3.3V注意模块供电电压范围通常3.3VGNDGND共地CS(片选)PC3低电平有效控制SPI通信开始/结束SCK(时钟)PC5SPI时钟SI(主出从入)PC6SPI数据输入到LT8920SO(主入从出)PC7LT8920数据输出到STM8GIO1PB4状态引脚检测收发状态GIO2PB5可选用于RX/TX切换等如果直接用STM8的硬件SPI也有办法但我更推荐测试程序里用软件模拟SPI。原因很简单软件SPI引脚选择自由代码逻辑可以直接看到每一位的电平变化一旦通信不正常比较容易定位是时钟极性、相位问题还是引脚接错问题。硬件SPI虽然速度更快但在测试阶段反而是个“黑盒”出了问题不好查。2.2 供电与去耦一个容易被忽略的坑LT8920在发射状态下电流会瞬间变化如果供电走线太细或者去耦电容不足电源电压会产生比较大的纹波严重时会导致芯片PLL失锁、发射距离忽远忽近。我第一次测试时直接用杜邦线从STM8开发板的3.3V引脚取电结果接收端偶尔能收到数据但距离稍微拉远一点就掉包后来加了一颗10uF钽电容和一颗100nF陶瓷电容靠近模块引脚放置问题明显改善。另外一个经验是如果LT8920模块上有独立的射频VCC引脚最好和数字VCC分开走线并且在模块底部铺完整地平面。测试阶段虽然不用追求射频性能极致但至少要把去耦和地线做好否则后面所有测试结论都可能被供电问题污染。3. STM8开发环境从安装到点灯STM8的开发环境选择网上说法比较多。有人用IAR for STM8有人用STVD搭配Cosmic编译器还有人用PlatformIO。我这次用的是STVDCosmic的组合因为它在STM8的开发中免费且足够用但有一个限制Cosmic免费版对代码大小有32KB的限制对测试程序和一般产品固件来说完全够用除了偶尔遇到寄存器结构体对齐问题其他都还好。3.1 安装流程与环境变量第一步安装STVD第二步安装Cosmic编译器第三步安装ST-LINK驱动。这三步的顺序其实无所谓但要注意STVD和Cosmic是两套独立软件STVD是IDECosmic是编译器工具链两者装完后要在STVD的Project-Settings里把Cosmic工具链路径配置正确否则编译时会报找不到编译器。ST-LINK驱动方面Windows 10以上系统通常能自动识别但建议去ST官网装最新的ST-LINK驱动这样连接SWIM调试时更稳定。开发板烧录接口用的SWIM只需要SWIM、RST、GND三根线配合ST-LINK就能下载和在线调试这一点比51单片机用串口下载要方便不少。3.2 新建工程与第一个测试代码STVD新建工程的向导逻辑比较老派第一步选择芯片型号时要注意选对具体型号比如STM8S103F3P6要选STM8S103F3P。如果选错型号Link时会出现地址空间不匹配的报错。创建工程后main.c里默认什么都没有可以从最简单的GPIO翻转开始验证环境。#include stm8s.h void delay(unsigned long cnt) { while(cnt--); } void main(void) { GPIO_Init(GPIOD, GPIO_PIN_0, GPIO_MODE_OUT_PP_LOW_FAST); while(1) { GPIO_WriteReverse(GPIOD, GPIO_PIN_0); delay(100000L); } }这个点灯程序烧进去之后如果LED能闪烁说明编译、烧录、硬件都没问题接下来就可以写SPI通信代码了。这里多说一句STM8的库函数版本有好几个我用的是STM8S标准外设库网上也能找到老的库版本建议直接用官网最新版函数命名和兼容性都更好。4. LT8920初始化寄存器配置流程拆解LT8920的初始化是整个测试程序的核心。这颗芯片几乎所有射频参数都通过SPI寄存器配置而且一大特点是寄存器长度多为48位6字节这和很多SPI芯片一个寄存器就8位/16位完全不同。刚开始做这个项目时我不小心把寄存器按16位来算结果写到哪里都是错的后来仔细看手册才发现问题。4.1 理解LT8920的SPI读写协议LT8920的SPI通信可以理解为一个命令字节包含读/写标志和寄存器地址 N个数据字节。命令字节的最高位用于区分读写通常1表示写0表示读。具体到代码上我封装了下面两个函数#define LT8920_CS_LOW() GPIO_WriteLow(GPIOC, GPIO_PIN_3) #define LT8920_CS_HIGH() GPIO_WriteHigh(GPIOC, GPIO_PIN_3) static void SPI_GPIO_Init(void) { GPIO_Init(GPIOC, GPIO_PIN_3, GPIO_MODE_OUT_PP_HIGH_FAST); GPIO_Init(GPIOC, GPIO_PIN_5, GPIO_MODE_OUT_PP_LOW_FAST); GPIO_Init(GPIOC, GPIO_PIN_6, GPIO_MODE_OUT_PP_LOW_FAST); GPIO_Init(GPIOC, GPIO_PIN_7, GPIO_MODE_IN_PU_NO_IT); } static unsigned char SPI_ReadWriteByte(unsigned char byte) { unsigned char i; for (i 0; i 8; i) { if (byte 0x80) GPIO_WriteHigh(GPIOC, GPIO_PIN_6); else GPIO_WriteLow(GPIOC, GPIO_PIN_6); GPIO_WriteLow(GPIOC, GPIO_PIN_5); GPIO_WriteHigh(GPIOC, GPIO_PIN_5); byte 1; if (GPIO_ReadInputPin(GPIOC, GPIO_PIN_7)) byte | 0x01; } return byte; }上面的代码里我在SCK上升沿之前更新SI在SCK上升沿之后读取SO这样对应SPI Mode 0CPOL0, CPHA1的常见习惯。如果你的模块手册指定其他模式只要调整这几行的顺序即可。写寄存器函数很直接void LT8920_WriteReg(unsigned char reg, unsigned char *dat, unsigned char len) { unsigned char i; LT8920_CS_LOW(); SPI_ReadWriteByte(0x80 | reg); for (i 0; i len; i) { SPI_ReadWriteByte(dat[i]); } LT8920_CS_HIGH(); }读寄存器函数类似只是命令字节不带0x80然后用SPI_ReadWriteByte(0xFF)来得到SO上返回的数据。4.2 初始化序列频率、数据速率、发射功率、校准LT8920的寄存器配置虽然灵活但初始化基本有一个固定套路先配置频率字再配置数据速率、发射功率等参数然后启动校准最后进入待机或收发状态。频率字一般通过公式计算载波频率对应的寄存器值不同寄存器位的含义要按手册查表这一块没法偷懒必须认真对照。我测试时用的是2.405GHz频点数据速率配置为1Mbps。发射功率方面测试程序里先用了中等功率验证链路通断后再调大。注意每次修改发射功率后最好回读一下寄存器确认写入是有效的。校准这一步特别容易漏。有几次我把寄存器配置写完后直接进入发射模式结果GIO引脚完全没有反应后来在数据手册里查到芯片上电后需要依次触发VREG校准、XTAL校准和PLL校准没有一个状态寄存器专门汇报校准完成所以要在每个校准命令后面加固定延时给芯片留出足够的处理时间。5. 收发测试流程从按键触发到串口打印初始化写好后收发流程就相对简单了。整个测试程序的核心逻辑是发射端按下按键把一串固定数据通过LT8920发出去接收端一旦检测到前导码和数据包就把收到的内容通过串口打印出来。5.1 发射端的软件流程发射端的流程如下首先调用LT8920_Init()完成上电初始化然后进入一个大循环检测按键是否按下。按键按下后把要发送的数据填充到发送缓冲区然后调用LT8920_TX_Packet()进入发射状态。发送完成后LT8920自动回到待机状态等待下一次触发。实际代码里我预留了一个测试帧格式包括前导码固定字段、长度字段、数据字段和简单的8位校验。这样接收端在判断“收到数据”时可以先用校验做一次过滤避免环境噪声导致的误判。// 发送一帧数据的简化流程 unsigned char tx_buf[16] LT8920 TEST; LT8920_SetFrequency(2405); // 设置载波频率为2405MHz LT8920_SetDataRate(1); // 1Mbps LT8920_SetTxPower(LT8920_PWR_0dBm); LT8920_Init(); while (1) { if (KEY_IS_PRESSED()) { LT8920_TX_Packet(tx_buf, 12); delay_ms(100); } }这里要提醒一下发射结束后不能立刻连续发下一帧最好加一点延时给接收端留出处理时间。测试程序里我用了100ms间隔实际产品可以根据空中帧长和ACK超时来压缩。5.2 接收端的软件流程接收端的流程和发射端类似初始化之后一直保持在RX模式。LT8920的GIO1引脚在检测到有效前导码时会发生变化所以接收端可以配置GIO1为输入配合查询或中断方式判断是否有数据到达。测试程序里我简单用查询方式每隔一小段时间读取一次GIO1如果发现状态变化再去读寄存器或FIFO区域获得实际数据。数据拿到后通过STM8的UART串口打印到电脑终端。串口波特率我配了115200测试时用串口助手接收每一帧前面加上“RX:”前缀收到一帧打一行非常直观。接收端有一个需要注意的点如果长时间收不到数据GIO1可能会一直处于某种电平这时候最好能判断“是否超时”——如果一段时间内没有新的数据包就重新初始化一次接收状态。测试环境里射频干扰不大但工业现场就不好说了加上超时重收机制会让程序更耐用。5.3 实测结果与简单的信号判断我在办公室实测两块模块距离大概5米中间隔了一堵石膏墙。发射端用2.405GHz频点1Mbps数据速率中等发射功率接收端几乎每次都能在按键后100ms以内收到数据串口打印连续且稳定。然后把距离拉到15米左右隔了一堵混凝土墙开始出现丢包这基本符合LT8920在这种低成本模块加PCB天线条件下的典型表现。测试程序除了收发数据还能做一个简单的信号质量判断接收端统计收到的帧数和CRC错误数通过串口打出来。这样在调天线匹配或调整发射功率时不用靠耳朵听或者看信号灯直接看误码率数字变化比什么都直观。6. 踩坑记录模块测试阶段最容易忽略的三件事这部分我单独拿出来讲因为整个测试过程中遇到的三个问题几乎每一个都会让新手折腾半天而这些问题在数据手册里写得并不明显。6.1 坑一片选时序和SPI模式的搭配LT8920的CS引脚在SPI通信开始时拉低结束时拉高这个大家都懂。但容易忽略的是CS信号要和SCK的第一拍保持足够的时间关系。我用软件SPI时最开始在CS拉低后立刻发送命令字节结果偶尔出现第一次通信失败后来发现是因为CS刚拉低芯片内部还没准备好需要加一点延时再开始SCK。解决办法很简单在CS拉低后加几个空操作或者放入一个多余的SPI时钟周期。这个延时大约几微秒就够了不会影响整体速度。6.2 坑二GIO引脚的配置和电气特性LT8920的GIO引脚功能需要通过寄存器配置不是上电默认就是理想的状态。我一开始以为GIO1上电后就是数据接收指示输出直接拿它做中断触发结果发现上电后它一直不变查了手册才知道要先把对应寄存器位设成正确的工作模式。另外GIO引脚的输出类型也需要和主控匹配有些模块上拉了上拉电阻有些没有和STM8的输入模式搭配不对时会导致电平判断不稳。6.3 坑三频率字配置对实际频率的影响LT8920的频率字不是简单的十进制频率值而是载波频率和参考频率通过特定公式算出来的寄存器值。如果参考频率算错实际发出的频率会偏离目标频点接收端灵敏度会大幅下降甚至完全收不到。测试时我专门用一个频谱仪看过配置目标是2405MHz实际发出来却偏了大概2MHz就是参考频率参数填错了。对于没有频谱仪的开发者最简单的办法是让发射端和接收端使用完全相同的频率配置代码只要两边认的“频道”一致即使绝对频率有所偏差通信仍然能通。结尾这个测试程序做完之后LT8920最终没有用在那款无线鼠标里主要是产品经理觉得换芯片的测试周期太长了。但这次调试过程让我把LT8920的寄存器体系、SPI时序、频率计算这些关键点都摸了一遍。后来另一款无线遥控器项目直接用上了这套代码从拿到模块到完成整机联调比第一次省了差不多一半时间。最后再分享一个小技巧如果你手头没有频谱仪又想快速确认LT8920是不是真的在发射可以找一台带FM解调或者频谱扫描的软件定义接收机拉远一点看频段能量变化。或者更简单一点用另一块正常的LT8920模组做接收端配合串口打印在近距离下先验证链路通断再慢慢拉大距离看衰减特性。这套“先通断、后距离、再误码”的测试方法我认为是最省时间的。这个项目后续还可以扩展加上数据包重传、ACK机制或者用STM8的定时器做一个自动的心跳包测试检查长时间连续运行下模块的性能稳定性。测试程序说白了就是“把不确定变成确定”的过程把LT8920每个寄存器都调明白后面产品固件怎么写都不慌。本文还有配套的精品资源点击获取