简介这份资源是面向嵌入式开发者的LT8920 2.4G无线模块测试程序基于STM8微控制器实现适合正在学习短距离无线通信、需要快速验证LT8920收发功能的初学者与工程师。压缩包共62个文件约825KB以c与h源码文件为主涵盖LT8920驱动、SPI通信、时钟配置、中断与延时等模块另含o、cout等编译中间文件及pbi、ewp、ewd等IAR工程配置hex可直接烧录验证。资源围绕STM8控制LT8920完成初始化、参数配置与数据收发读者可借此理解GFSK调制下的通信流程并在此基础上修改数据帧格式、调整发射功率与接收灵敏度。目前已有1056人学习下载工程结构完整便于在IDE中直接打开调试是掌握2.4GHz无线通信与STM8编程的实用参考。1. 从一块 LT8920 说起为什么 STM8 是它最省事的搭档手上拿到一块 LT8920 无线模块第一反应往往是找例程。但市面上大多数示例要么跑在 STM32 上要么用 Arduino 封装好的库真正用 STM8 裸机驱动 LT8920 的完整测试程序反而不多。LT8920 是一颗 Sub-1GHz 频段的射频收发芯片常见工作在 315/433/868/915MHzSPI 接口配置寄存器配合 STM8S 系列这种便宜、够用、外设刚好对得上的 MCU是低成本无线数传方案里非常经典的一套组合。这篇笔记要解决的就是怎么用 STM8 把 LT8920 跑通从 SPI 时序、寄存器配置、收发切换到实际测试时怎么判断模块到底有没有工作。适合正在做无线遥控、无线传感器节点、低功耗数传的嵌入式工程师也适合刚接触 Sub-1GHz 射频、想找一个能复现的最小系统的朋友。整套测试程序的核心不在代码量而在几个关键寄存器和时序细节上踩过一遍坑之后后面换频点、改速率都是改参数的事。2. LT8920 与 STM8 的硬件连接和 SPI 底层驱动2.1 先搞清楚 LT8920 的引脚和 STM8 的对应关系LT8920 模块通常引出 8 个左右的引脚核心是 SPI 四线加两个控制脚。SPI 的 SCS、SCK、SDIO 三根线负责寄存器读写另外还有两个关键控制引脚一个是 CSN片选低有效一个是 PKT中断/状态指示收发完成或收到数据时拉低或拉高具体看配置。有些模块把 CSN 和 SCS 合并有些分开接线前一定要看模块丝印或规格书。STM8S103F3 这类芯片的 SPI 引脚是固定的PC5 是 SCKPC6 是 MOSIPC7 是 MISO。但 LT8920 的 SDIO 是双向单线不是标准四线 SPI 的 MOSI/MISO 分离结构。这一点是第一个容易翻车的地方——LT8920 用的是三线 SPI 模式SDIO 在写寄存器时是输出读寄存器时是输入需要 MCU 在读写之间切换引脚方向。我一般这样接LT8920 引脚STM8 引脚说明VCC3.3V供电注意模块是否耐 5VGNDGND共地SCSPC4片选软件控制SCKPC5SPI 时钟SDIOPC6双向数据PKTPC3中断输入接外部中断GIO悬空或接 LED可选这里没有用 STM8 硬件 SPI 的 MISO因为 LT8920 的 SDIO 是单线双向硬件 SPI 的 MOSI 和 MISO 分开反而不好处理。常见做法是用 GPIO 模拟三线 SPI时序完全自己控制反而更稳。2.2 用 GPIO 模拟三线 SPI 的读写函数LT8920 的 SPI 时序不复杂但有几个细节数据在 SCK 上升沿采样命令字节先发然后是地址或数据。读寄存器时SDIO 要在命令字节发完后切换为输入模式。下面是我常用的读写函数// LT8920 三线 SPI 读写基于 STM8 GPIO // PC4 SCS, PC5 SCK, PC6 SDIO #define SCS_L() (PC_ODR ~(14)) #define SCS_H() (PC_ODR | (14)) #define SCK_L() (PC_ODR ~(15)) #define SCK_H() (PC_ODR | (15)) #define SDIO_IN() (PC_DDR ~(16), PC_CR1 ~(16)) #define SDIO_OUT() (PC_DDR | (16), PC_CR1 | (16)) #define SDIO_H() (PC_ODR | (16)) #define SDIO_L() (PC_ODR ~(16)) #define SDIO_READ() ((PC_IDR (16)) ? 1 : 0) // 写一个字节MSB 先出 void LT8920_WriteByte(uint8_t data) { uint8_t i; SDIO_OUT(); for(i 0; i 8; i) { SCK_L(); if(data 0x80) SDIO_H(); else SDIO_L(); data 1; SCK_H(); // 上升沿写入 } SCK_L(); } // 读一个字节MSB 先入 uint8_t LT8920_ReadByte(void) { uint8_t i, data 0; SDIO_IN(); for(i 0; i 8; i) { data 1; SCK_H(); if(SDIO_READ()) data | 0x01; SCK_L(); } return data; }逻辑说明写字节时先把 SDIO 设为输出每个 bit 在 SCK 低电平期间准备好上升沿被 LT8920 采样。读字节时先把 SDIO 设为输入在 SCK 高电平期间读取电平。参数上唯一需要调的是延时——如果 STM8 主频较高比如 16MHzGPIO 翻转太快可能导致 LT8920 采样不稳可以在 SCK 翻转之间加几个nop()。我一般先在 8MHz 下跑通再往上调。2.3 寄存器读写命令格式LT8920 的寄存器操作有固定格式写寄存器是 0x00 开头加 7 位地址读寄存器是 0x80 开头加 7 位地址。地址是 7 位所以命令字节的高位区分读写。下面是对外封装的两个函数// 写寄存器命令字节 地址bit70然后写数据 void LT8920_WriteReg(uint8_t addr, uint8_t value) { SCS_L(); LT8920_WriteByte(addr 0x7F); // 写命令bit70 LT8920_WriteByte(value); SCS_H(); } // 读寄存器命令字节 地址 | 0x80然后读数据 uint8_t LT8920_ReadReg(uint8_t addr) { uint8_t val; SCS_L(); LT8920_WriteByte(addr | 0x80); // 读命令bit71 val LT8920_ReadByte(); SCS_H(); return val; }这里有个容易忽略的点SCS 拉低后不要立刻发命令最好等几个微秒让模块准备好。另外读操作时命令字节发完后SDIO 要立刻切为输入中间不能有额外的 SCK 脉冲否则会多读一个 bit。我一般在LT8920_WriteByte返回后直接调SDIO_IN()中间不加延时。3. 寄存器配置让 LT8920 真正进入收发状态3.1 上电后的初始化顺序LT8920 上电后不能直接发数据必须先配置几个关键寄存器。顺序错了模块可能完全不响应。我一般按这个流程走拉低 SCS发软复位命令如果有配置频点寄存器配置数据速率和调制方式配置发射功率配置包格式和同步字切换到接收或发射模式频点配置是最核心的。LT8920 的频点由一个 16 位寄存器决定常见公式是Freq (RF_CH 8) | RF_CH_L实际频率和晶振、分频比有关。以 433MHz 为例常见配置值是 0x0A5C 左右但不同模块的晶振可能不同最好用频谱仪或已知模块对测。// LT8920 初始化示例433MHz 频点 void LT8920_Init(void) { // 配置 PC4/PC5/PC6 为输出PC3 为输入 PC_DDR | (14) | (15) | (16); PC_CR1 | (14) | (15) | (16); PC_DDR ~(13); // PKT 输入 PC_CR1 ~(13); SCS_H(); SCK_L(); // 软复位如果模块支持 LT8920_WriteReg(0x00, 0x80); delay_ms(10); // 频点设置433MHz 附近 LT8920_WriteReg(0x06, 0x0A); // 频点高字节 LT8920_WriteReg(0x07, 0x5C); // 频点低字节 // 数据速率比如 10kbps LT8920_WriteReg(0x08, 0x02); // 发射功率最大 LT8920_WriteReg(0x09, 0x1F); // 包格式同步字 数据 LT8920_WriteReg(0x0A, 0x40); // 切换到接收模式 LT8920_WriteReg(0x01, 0x01); }参数说明频点寄存器 0x06 和 0x07 的具体值需要根据模块晶振计算上面给的 0x0A5C 是常见 433MHz 模块的经验值不一定通用。数据速率寄存器 0x08 的值和速率对应关系要看规格书一般值越小速率越高。发射功率寄存器 0x09 不是所有模块都支持可调有些固定最大功率。3.2 收发切换和中断处理LT8920 的收发切换靠模式寄存器。发数据前切到发射模式发完切回接收。PKT 引脚在收到数据或发送完成时会翻转可以接 STM8 的外部中断。我一般用 PKT 下降沿触发中断在中断里读状态寄存器判断是收还是发完成。// 发送一个包 void LT8920_SendPacket(uint8_t *buf, uint8_t len) { uint8_t i; // 切到发射模式 LT8920_WriteReg(0x01, 0x00); delay_us(200); // 写数据到 FIFO SCS_L(); LT8920_WriteByte(0x20); // FIFO 写命令 for(i 0; i len; i) LT8920_WriteByte(buf[i]); SCS_H(); // 触发发送 LT8920_WriteReg(0x02, 0x01); delay_ms(5); // 等发送完成 // 切回接收 LT8920_WriteReg(0x01, 0x01); } // PKT 中断处理PC3 下降沿 #pragma vector EXTI3_IRQHandler __interrupt void EXTI3_IRQHandler(void) { uint8_t status LT8920_ReadReg(0x03); if(status 0x01) { // 收到数据读 FIFO uint8_t len LT8920_ReadReg(0x04); // ... 读数据 } // 清中断标志 LT8920_WriteReg(0x03, 0x00); }逻辑说明发送时先切模式再写 FIFO最后触发。FIFO 写命令 0x20 是常见值具体看规格书。中断里一定要读状态寄存器并清标志否则会反复进中断。PKT 引脚的电平极性可以通过寄存器配置如果中断一直触发先检查极性设置。3.3 用寄存器回读验证配置是否生效配置完不要急着发数据先回读几个关键寄存器确认写入的值能读回来。如果读回来全是 0 或全是 0xFF说明 SPI 时序有问题。我一般写一个简单的自检函数// 自检写一个测试值到测试寄存器再读回 uint8_t LT8920_SelfTest(void) { LT8920_WriteReg(0x1F, 0xA5); // 假设 0x1F 是可读写测试寄存器 if(LT8920_ReadReg(0x1F) ! 0xA5) return 0; // SPI 通信失败 return 1; }注意不是所有寄存器都可读写有些是只读状态寄存器。选一个规格书里标注可读写的寄存器做测试。如果读回值不对先查 SCK 和 SDIO 的接线再查时序延时。4. 避坑记录LT8920 调试中最容易翻车的五个点4.1 现象SPI 读回全是 0xFF写寄存器没反应原因SDIO 方向切换时机不对。LT8920 在读命令字节发完后SDIO 必须立刻从输出切为输入如果切换晚了模块已经把数据驱动到 SDIO 上MCU 还在输出会打架。另外SCK 空闲电平如果是高也可能导致模块误采样。解决在LT8920_WriteByte返回后立刻调SDIO_IN()中间不加任何延时。SCK 空闲时保持低电平。如果还不行把 SCK 频率降到 100kHz 以下试。4.2 现象模块能读回寄存器但发数据对方收不到原因频点配置不对。LT8920 的频点寄存器值和实际频率的关系受晶振影响不同批次的模块晶振可能有偏差。另外数据速率和频偏设置不匹配也会导致收不到。解决用两个模块对测一个发一个收先用默认频点确认能通后再改。如果没有频谱仪可以用一个已知能工作的模块做参考逐步调整频点寄存器值。数据速率先设低一点比如 2kbps容错更高。4.3 现象PKT 中断一直触发进不去主循环原因中断标志没清或者 PKT 极性配置反了。LT8920 的 PKT 引脚在收发完成时会翻转如果配置成高电平触发但实际是低电平有效就会一直进中断。解决在中断里先读状态寄存器确认是什么事件然后写寄存器清标志。PKT 极性通过配置寄存器设置一般有专门的位控制。如果还不行先把 PKT 中断关掉用轮询方式读状态寄存器确认模块工作正常后再开中断。4.4 现象发射时电流很大但通信距离很短原因发射功率寄存器没配对或者天线匹配没做好。LT8920 的发射功率不是所有模块都可调有些模块固定最大功率但天线端的匹配网络如果没调好大部分功率反射回来实际辐射很小。解决先确认发射功率寄存器是否写进去了回读确认。天线端如果是 PCB 天线检查匹配电容电感是否按模块规格书推荐值。如果是外接天线确认阻抗是 50 欧姆。测试时把两个模块靠近先确认能通再拉距离。4.5 现象低功耗模式下电流降不下来原因LT8920 的休眠模式配置不对或者 STM8 的 GPIO 没设成低功耗状态。模块在休眠时如果 SCS、SCK 还有电平变化会额外耗电。解决休眠前把 SCS 拉高SCK 拉低SDIO 设成输入。STM8 这边把不用的 GPIO 设成输出低或输入上拉避免浮空。LT8920 的休眠命令写完后等一段时间再测电流有些模块需要几十毫秒才能进入低功耗状态。5. 进阶技巧用 RSSI 和误包率快速判断链路质量跑通收发只是第一步实际部署时更关心链路稳不稳。LT8920 有一个 RSSI 寄存器可以读出当前接收信号的强度虽然精度不高但用来判断“有没有信号”和“信号大概多强”足够了。我一般会在接收端加一个统计每收 100 个包记录 RSSI 平均值和丢包数这样不用频谱仪也能大致判断距离和干扰情况。// 读取 RSSI 并统计误包率 uint8_t rssi_val; uint16_t rx_count 0, lost_count 0; void LT8920_OnPacketReceived(void) { rssi_val LT8920_ReadReg(0x05); // 假设 0x05 是 RSSI 寄存器 rx_count; // 如果包序号不连续说明丢包 // ... } // 每 100 个包打印一次 void LT8920_PrintStats(void) { if(rx_count 100) { printf(RSSI: %d, Lost: %d\r\n, rssi_val, lost_count); rx_count 0; lost_count 0; } }RSSI 寄存器的地址和换算关系要看规格书不同模块可能不一样。我一般先近距离测一个基准值然后拉远看 RSSI 下降趋势结合丢包率判断临界距离。如果 RSSI 还很高但丢包严重多半是干扰或频点冲突如果 RSSI 很低且丢包多就是距离或天线问题。另一个实用技巧是动态改速率。近距离时用高速率远距离时切到低速率容错更高。LT8920 的速率寄存器可以在运行时改但改完要重新初始化收发模式。我一般设两档10kbps 和 2kbps根据 RSSI 和丢包率自动切。这个逻辑不复杂但能明显提升实际可用距离。最后说一个我自己的习惯每次改完寄存器配置一定先回读确认再发数据。很多“模块坏了”的情况其实只是某个寄存器没写进去。调试射频模块示波器看 SPI 波形、万用表测供电、两个模块对测这三样比任何高级工具都管用。希望帮到你。本文还有配套的精品资源点击获取