从零到一：STM32驱动LoRa模块的实战配置与数据传输解析

1. 开篇：为什么选择STM32和LoRa？

如果你手头正好有一块STM32开发板，比如常见的F103C8T6“蓝色药丸”，或者F407 Discovery，又或者任何一款STM32 Nucleo板，然后想玩点远距离、低功耗的无线通信，那么LoRa技术绝对是你的菜。我自己在好几个物联网项目里都用过，比如远程环境监测、农业传感器数据回传，实测下来，在开阔地带传个一两公里轻轻松松，而且功耗低到可以用电池供电跑上好几年。这可比传统的Wi-Fi或者蓝牙的覆盖范围大多了，特别适合那些需要“广撒网”但又不想频繁换电池的应用场景。

LoRa本身是一种物理层的调制技术，它厉害的地方在于，能用很低的功耗，把数据传得很远。而我们常说的“LoRa模块”，比如亿佰特的E22系列、RAK的RA-01/02，或者Semtech原厂的SX1278模组，就是把LoRa射频芯片、必要的电路和天线集成在一起，留出UART串口给我们用。对我们开发者来说，最爽的一点就是：你不用去啃复杂的射频电路和通信协议，把它当成一个“增强版的串口”来用就行了。你通过串口发给它的数据，它自动帮你用无线电发出去；它从空中收到的数据，也通过串口吐给你。STM32最不缺的就是UART串口，所以这两者搭配，简直是天作之合。

这篇文章，我就以一个嵌入式老鸟的身份，带你从零开始，把手里的STM32和LoRa模块连起来，配通参数，最后实现一个互相打招呼的“Hello LoRa”测试。我会把过程中容易踩的坑、需要注意的细节都掰开揉碎了讲，保证你跟着做一遍就能跑通。咱们不搞虚的，直接上干货。

2. 硬件连接：给STM32和LoRa模块“牵线搭桥”

拿到LoRa模块，第一步肯定是看引脚。别被模块上那一排排的引脚吓到，对于最基础的透传功能（就是你发什么它无线发什么），我们真正需要接的线其实很少。以常见的E22-400T30S模块为例，我们重点关注以下五个引脚：

1. M0： 工作模式选择引脚0。
2. M1： 工作模式选择引脚1。
3. AUX： 模块状态指示引脚，输出高电平时表示模块就绪。
4. TXD： 模块的串口发送引脚（对应MCU的RXD）。
5. RXD： 模块的串口接收引脚（对应MCU的TXD）。
6. VCC和GND： 电源，注意电压范围，常见的是3.3V或5V，务必核对模块手册。

这里有个关键点，也是新手最容易接错的地方：电平匹配。STM32的IO口通常是3.3V电平。如果你的LoRa模块是5V供电且其UART是5V TTL电平，直接连接可能会损坏STM32。稳妥起见，我强烈建议所有模块都使用3.3V供电，这样电平直接兼容，省去电平转换的麻烦。确认好电平后，连接就很简单了：

• STM32的3.3V->LoRa模块的VCC
• STM32的GND->LoRa模块的GND
• STM32的某个UART_TX引脚（比如PA9） ->LoRa模块的RXD
• STM32的某个UART_RX引脚（比如PA10） ->LoRa模块的TXD
• STM32的两个普通GPIO（比如PB12, PB13） ->LoRa模块的M0和M1
• STM32的一个GPIO输入引脚（比如PC2） ->LoRa模块的AUX（可选，但建议连接）

为什么AUX建议连接呢？这个引脚是个“忙”指示灯。当模块内部在处理命令或切换模式时，AUX会输出低电平；处理完毕进入就绪状态后，AUX变为高电平。在代码里读取这个引脚的状态，可以确保我们的操作时序是准确的，避免在模块忙的时候发命令导致失败。这是写出稳定驱动的一个小秘诀。

硬件连接好后，先别急着写代码。用杜邦线连接时，务必插紧，尤其是电源线，接触不良会导致模块反复复位，现象诡异。最好能用万用表量一下供电电压是否稳定。我吃过亏，调试了半天发现是3.3V电源线虚接，电压只有2.5V，模块工作不正常。

3. 理解LoRa模块的“工作模式”与配置逻辑

线接好了，相当于给两个设备拉好了电话线。但现在电话还没拨号，不知道以什么规则通话。LoRa模块有几种工作模式，由M0和M1这两个引脚的电平组合决定，通常有四种：

对于我们的初次实战，你只需要牢牢记住两个模式：模式0（00）用于正常通信，模式3（11）用于配置参数。99%的时间，模块都处在模式0。当我们需要修改地址、信道、波特率等参数时，才切换到模式3，发完配置命令后再切回模式0。

这里有一个至关重要的细节，也是原始代码里体现出来的：模式切换的时序。你不能粗暴地直接改变M0/M1的电平然后立刻发命令。模块内部需要时间来处理状态切换。正确的做法是：

1. 设置M0/M1引脚电平，切换到目标模式（比如从模式0切换到模式3）。
2. 等待一小段时间（比如2ms），让模块内部稳定。
3. 读取AUX引脚，等待其变为高电平（如果连接了的话），这表示模块“准备好了”。
4. 现在才可以发送UART数据（普通数据或配置命令）。

原始代码中的Lora_Set_Mode函数结尾的while(GPIO_ReadInputDataBit(GPIOC,GPIO_Pin_2) == RESET); delay_ms(2);就是在做这件事：死等AUX变高，再额外等2ms确保稳定。这个等待是必须的，我试过不加等待，配置命令有一半的概率会失败。

4. 核心配置：地址、信道与波特率详解

配置模式（M1=1, M0=1）下，我们通过串口向模块发送特定的指令帧来修改其内部寄存器。这些寄存器决定了通信的关键属性。最主要的就是三个：地址、信道、串口波特率/空中速率。

地址（Address）： 相当于设备的“门牌号”。在定点传输时，发送方会在数据包前带上目标地址，只有地址匹配的接收模块才会处理这个数据包。地址范围一般是0x0000到0xFFFF。假设你有三个节点A、B、C，你可以把A的地址设为0x0001，B设为0x0002，C设为0x0003。A发给B的数据，C就不会理会。这实现了简单的网络寻址。

信道（Channel）： 相当于通信的“频率车道”。不同信道的中心频率不同。例如，信道0x17对应433.125MHz（以E22-433T30S为例）。所有需要互相通信的模块，信道必须设置为相同的值，否则就像调到了不同的广播电台，互相听不见。信道参数也提供了一定的抗干扰能力，如果你的环境中有其他同频段设备干扰，可以尝试切换到一个空闲的信道。

串口波特率与空中速率（UART Baudrate & Air Data Rate）： 这是两个容易混淆的概念。

• 串口波特率： 是你STM32的UART与LoRa模块通信的速率，比如9600、115200。这个值两边（STM32和LoRa模块）必须设置成一样，否则串口通信就会乱码。
• 空中速率： 是LoRa模块之间通过无线电波传输数据的符号速率，比如0.3kbps, 2.4kbps, 9.6kbps等。空中速率直接影响通信距离和抗干扰能力。速率越低，传输距离越远，抗干扰性越强，但单位时间能发送的数据量也越少。这是一对需要权衡的参数。在项目初期，我建议使用较低的空中速率（如2.4kbps）来获得最远的通信距离和稳定性。

配置命令的格式通常是固定的。以亿佰特模块常用的命令格式为例，它是一个字节数组：

• 头字节： 固定为0xC0，表示这是一条配置命令。
• 寄存器地址高位： 要操作的寄存器地址的高字节。
• 寄存器地址低位： 要操作的寄存器地址的低字节。
• 数据长度： 要写入的数据的字节数。
• 数据内容： 要写入的具体值。

例如，设置地址寄存器（假设地址为0x0001）的命令可能就是{0xC0, 0x00, 0x02, 0x02, 0x00, 0x01}。具体的寄存器地址和格式，一定要查阅你所使用的LoRa模块的官方数据手册或用户手册，不同厂家、不同型号的命令集可能有差异。切忌照搬代码而不看手册。

5. 软件驱动编写：从初始化到收发数据

理论懂了，现在我们来写代码。我会用STM32标准外设库（虽然现在HAL库更流行，但标准库代码更直观，原理相通）来演示，并解释每一部分的作用。

5.1 GPIO与UART初始化

首先，我们需要初始化连接M0、M1、AUX的GPIO，以及与模块通信的UART。

// lora.h 部分定义 #ifndef __LORA_H #define __LORA_H #include "stm32f10x.h" #define LORA_M0_GPIO_PORT GPIOB #define LORA_M0_GPIO_PIN GPIO_Pin_12 #define LORA_M1_GPIO_PORT GPIOB #define LORA_M1_GPIO_PIN GPIO_Pin_13 #define LORA_AUX_GPIO_PORT GPIOC #define LORA_AUX_GPIO_PIN GPIO_Pin_2 #define LORA_UART USART3 #define LORA_UART_IRQn USART3_IRQn #define LORA_UART_BAUDRATE 9600 void Lora_GPIO_Init(void); void Lora_UART_Init(uint32_t baudrate); void Lora_Set_Mode(uint8_t mode); #endif

// lora.c - GPIO和UART初始化 void Lora_GPIO_Init(void) { GPIO_InitTypeDef GPIO_InitStructure; // 初始化M0, M1为推挽输出 RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB, ENABLE); GPIO_InitStructure.GPIO_Pin = LORA_M0_GPIO_PIN | LORA_M1_GPIO_PIN; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP; // 推挽输出 GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(LORA_M0_GPIO_PORT, &GPIO_InitStructure); // 初始化AUX为上拉输入（用于检测模块状态） RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOC, ENABLE); GPIO_InitStructure.GPIO_Pin = LORA_AUX_GPIO_PIN; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IPU; // 上拉输入 GPIO_Init(LORA_AUX_GPIO_PORT, &GPIO_InitStructure); // 默认先设置为模式0（传输模式） GPIO_SetBits(LORA_M0_GPIO_PORT, LORA_M0_GPIO_PIN); // 根据你的模块逻辑，可能是置0 GPIO_ResetBits(LORA_M1_GPIO_PORT, LORA_M1_GPIO_PIN); // 请务必查阅手册确认高低电平定义！ // 上面两行是示例，具体M0/M1的电平要根据你的模块手册来设置 } void Lora_UART_Init(uint32_t baudrate) { GPIO_InitTypeDef GPIO_InitStructure; USART_InitTypeDef USART_InitStructure; NVIC_InitTypeDef NVIC_InitStructure; // 使能UART和对应GPIO的时钟 RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB, ENABLE); // USART3在PB10, PB11 RCC_APB1PeriphClockCmd(RCC_APB1Periph_USART3, ENABLE); // 配置TX引脚为复用推挽输出 GPIO_InitStructure.GPIO_Pin = GPIO_Pin_10; // TX GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP; GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(GPIOB, &GPIO_InitStructure); // 配置RX引脚为浮空输入 GPIO_InitStructure.GPIO_Pin = GPIO_Pin_11; // RX GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IN_FLOATING; GPIO_Init(GPIOB, &GPIO_InitStructure); // 配置UART参数 USART_InitStructure.USART_BaudRate = baudrate; USART_InitStructure.USART_WordLength = USART_WordLength_8b; USART_InitStructure.USART_StopBits = USART_StopBits_1; USART_InitStructure.USART_Parity = USART_Parity_No; USART_InitStructure.USART_HardwareFlowControl = USART_HardwareFlowControl_None; USART_InitStructure.USART_Mode = USART_Mode_Rx | USART_Mode_Tx; USART_Init(LORA_UART, &USART_InitStructure); // 使能UART接收中断（用于接收数据） USART_ITConfig(LORA_UART, USART_IT_RXNE, ENABLE); // 配置UART中断 NVIC_InitStructure.NVIC_IRQChannel = LORA_UART_IRQn; NVIC_InitStructure.NVIC_IRQChannelPreemptionPriority = 1; NVIC_InitStructure.NVIC_IRQChannelSubPriority = 1; NVIC_InitStructure.NVIC_IRQChannelCmd = ENABLE; NVIC_Init(&NVIC_InitStructure); // 使能UART USART_Cmd(LORA_UART, ENABLE); }

这段代码完成了硬件底层配置。Lora_GPIO_Init里初始化了控制引脚，Lora_UART_Init配置了串口并开启了接收中断。特别注意：M0和M1引脚的电平设置，必须严格按照你的模块手册来。有些模块是低电平有效，有些是高电平有效，这里写错会导致模式切换完全失效。

5.2 模式切换与配置函数

接下来是核心的模式切换函数和配置函数。这里我结合时序和AUX检测，写一个更健壮的版本。

// 设置工作模式，并等待模块就绪 void Lora_Set_Mode(uint8_t mode) { // 1. 根据模式设置M0, M1引脚 switch(mode) { case 0: // 传输模式 GPIO_ResetBits(LORA_M0_GPIO_PORT, LORA_M0_GPIO_PIN); GPIO_ResetBits(LORA_M1_GPIO_PORT, LORA_M1_GPIO_PIN); break; case 3: // 休眠/配置模式 GPIO_SetBits(LORA_M0_GPIO_PORT, LORA_M0_GPIO_PIN); GPIO_SetBits(LORA_M1_GPIO_PORT, LORA_M1_GPIO_PIN); break; // 其他模式可以在此补充 default: GPIO_ResetBits(LORA_M0_GPIO_PORT, LORA_M0_GPIO_PIN); GPIO_ResetBits(LORA_M1_GPIO_PORT, LORA_M1_GPIO_PIN); break; } // 2. 等待一小段时间让模块响应电平变化 Delay_ms(2); // 3. 等待AUX引脚变为高电平（模块就绪） // 如果没接AUX引脚，可以注释掉这个while循环，但务必保留足够的延时 while(GPIO_ReadInputDataBit(LORA_AUX_GPIO_PORT, LORA_AUX_GPIO_PIN) == Bit_RESET) { // 可以加个超时退出机制，避免死循环 } // 4. 额外再给一点稳定时间 Delay_ms(2); }

配置函数，比如设置地址，就需要先切换到模式3，发送命令，再切回模式0。

// 设置模块地址（示例，具体命令格式请查手册） void Lora_Set_Address(uint16_t addr) { uint8_t cmd_buf[6]; // 假设命令格式：C0 00 02 02 [AddrHigh] [AddrLow] cmd_buf[0] = 0xC0; // 帧头 cmd_buf[1] = 0x00; // 寄存器地址高字节 cmd_buf[2] = 0x02; // 寄存器地址低字节 cmd_buf[3] = 0x02; // 数据长度（2字节） cmd_buf[4] = (addr >> 8) & 0xFF; // 地址高字节 cmd_buf[5] = addr & 0xFF; // 地址低字节 // 切换到配置模式 Lora_Set_Mode(3); // 通过UART发送配置命令 for(int i=0; i<6; i++) { USART_SendData(LORA_UART, cmd_buf[i]); while(USART_GetFlagStatus(LORA_UART, USART_FLAG_TC) == RESET); } // 短暂延时，等待命令处理 Delay_ms(10); // 切换回传输模式 Lora_Set_Mode(0); }

设置信道、波特率等函数结构类似，只是命令帧的内容不同。务必、务必、务必找到你模块的官方指令集文档，照着里面的寄存器地址和格式来写。这是成功配置的前提。

5.3 数据发送与接收

配置好后，模块就工作在模式0（传输模式）。此时的数据收发变得极其简单：

发送数据： 直接把要发送的字节数组通过UART发给LoRa模块即可。模块会自动加上同步字、CRC等，通过无线电发出去。

void Lora_Send_Data(uint8_t *pData, uint16_t len) { for(uint16_t i=0; i<len; i++) { USART_SendData(LORA_UART, pData[i]); while(USART_GetFlagStatus(LORA_UART, USART_FLAG_TC) == RESET); } } // 例如发送 "Hello LoRa!" uint8_t test_data[] = "Hello LoRa!"; Lora_Send_Data(test_data, sizeof(test_data)-1); // 减1是为了去掉字符串结尾的'\0'

接收数据： 配置好UART接收中断。当LoRa模块从空中收到数据后，会通过串口转发给STM32，触发UART的RXNE（接收寄存器非空）中断。我们在中断服务函数里把数据读出来就行。

// 在stm32f10x_it.c中 extern uint8_t lora_rx_buffer[256]; extern uint16_t lora_rx_index; extern volatile uint8_t lora_rx_flag; // 接收完成标志 void USART3_IRQHandler(void) { if(USART_GetITStatus(USART3, USART_IT_RXNE) != RESET) { uint8_t rx_data = USART_ReceiveData(USART3); // 简单的处理：将数据存入缓冲区 if(lora_rx_index < 256) { lora_rx_buffer[lora_rx_index++] = rx_data; // 可以在这里判断帧结束符，比如遇到换行符'\n'认为一帧结束 if(rx_data == '\n') { lora_rx_buffer[lora_rx_index] = '\0'; // 添加字符串结束符 lora_rx_flag = 1; // 设置标志位 lora_rx_index = 0; // 重置索引（注意：这不是线程安全的，仅作示例） } } else { // 缓冲区溢出处理 lora_rx_index = 0; } USART_ClearITPendingBit(USART3, USART_IT_RXNE); } }

在主循环里，检查lora_rx_flag，如果为1，就处理lora_rx_buffer里的数据。这就是从另一个LoRa模块发来的信息。

6. 实战测试：搭建“Hello LoRa”点对点通信

现在，我们有了所有拼图。假设你有两个完全一样的STM32+LoRa模块套件（A和B）。我们来让它们互相打招呼。

步骤一：硬件连接与基础代码。 分别给两个开发板接好线，烧录相同的程序。程序里包含上述的GPIO初始化、UART初始化、模式设置函数。

步骤二：配置相同的通信参数。 在A和B的main函数初始化部分，调用配置函数，确保它们使用相同的信道和相同的串口波特率。地址可以不同，因为我们先测试广播。

int main(void) { SystemInit(); Delay_Init(); Lora_GPIO_Init(); Lora_UART_Init(9600); // 串口波特率9600 // 配置LoRa模块参数（在模式3下进行） Lora_Set_Mode(3); // 进入配置模式 Delay_ms(100); // 假设设置信道为0x17 (433.125MHz) Lora_Set_Channel(0x17); // 设置空中速率为2.4kbps（具体函数需根据手册实现） Lora_Set_AirRate(LORA_AIR_RATE_2K4); // 设置串口参数为8N1（默认，通常无需设置） Lora_Set_Mode(0); // 回到传输模式 Delay_ms(100); // 其他初始化... while(1) { // 主循环 } }

步骤三：编写测试逻辑。 我们让模块A每隔5秒发送一次“Hello from A!”，模块B收到后，除了自己打印出来，也回复一条“Hi A, I‘m B!”。

// 在模块A的主循环中 if(tick_counter - last_send_time > 5000) { // 5秒 last_send_time = tick_counter; // 发送广播数据（目标地址设为0xFFFF） uint8_t send_buf[] = {0xFF, 0xFF, 'H','e','l','l','o',' ','f','r','o','m',' ','A','!'}; // 注意：前两个字节0xFFFF是广播地址，具体是否需要加地址头，取决于模块的固件设置，有些是透明传输，有些需要手动加。 // 最保险的方式是查阅手册，看模块在“透明传输”模式下是否自动处理地址。 // 这里假设是透明传输模式，直接发数据内容。 Lora_Send_Data((uint8_t*)"Hello from A!\n", 14); } // 在模块A的中断或主循环中处理接收 if(lora_rx_flag) { lora_rx_flag = 0; printf("Received: %s", lora_rx_buffer); // 通过串口打印到电脑 // 判断是否是B的回复，这里简单处理 if(strstr((char*)lora_rx_buffer, "Hi A")) { printf("Got reply from B!\n"); } }

模块B的代码类似，只是发送和接收的内容反过来。注意：在实际测试中，两个模块要离得稍微远一点（比如隔一个房间），避免因为信号太强导致接收机饱和。同时，确保天线已安装好。

步骤四：上电与调试。 给两个模块上电，打开串口调试助手观察打印信息。你应该能看到A和B交替发送和接收信息。如果收不到，按以下顺序排查：

1. 电源：用万用表测模块VCC电压是否稳定达标。
2. 接线：TXD/RXD是否交叉连接？M0/M1电平是否正确？
3. 参数：两个模块的信道、空中速率、串口波特率是否100%相同？
4. 模式：发送和接收时，模块是否都处于模式0（传输模式）？
5. 天线：天线是否拧紧？没有天线或天线接触不良，通信距离会急剧缩短。
6. 环境：初始测试最好在开阔无遮挡环境进行。

当你看到串口里打印出“Hello from A!”和“Hi A, I‘m B!”时，恭喜你，你的第一个STM32 LoRa点对点通信链路就成功建立了！这个过程虽然会遇到一些小波折，但每一步的排错都是宝贵的经验。从这开始，你可以尝试修改地址进行定点通信，增加数据校验，设计简单的通信协议，甚至组建星型网络。LoRa的世界大门，已经向你敞开。