AS32 TTL-100 LoRa模块与STM32实战：从硬件连接到FreeRTOS任务调度全解析

最近在做一个智慧农业的监测节点项目，需要把几十个传感器数据汇总到一个网关，Wi-Fi覆盖不了那么远，4G模块功耗和成本又太高，最后把目光投向了LoRa。在众多LoRa模块里，AS32 TTL-100以其简单的串口透传特性和不错的性价比，成了我的首选。但真上手把玩，特别是想把它嵌入到基于STM32和FreeRTOS的复杂应用框架里时，发现网上资料要么太零碎，要么就是简单的点对点测试，关于如何在实时操作系统里优雅地驱动它、管理它的收发任务，几乎找不到成体系的分享。踩过几个坑，调通整个链路后，我觉得有必要把这段从硬件连接到软件架构设计的完整历程记录下来，特别是FreeRTOS任务调度那块，很多细节处理不好，整个系统的响应和稳定性都会大打折扣。

这篇文章就是为你准备的，如果你已经熟悉STM32的基本开发，用过一两个外设，现在正打算把LoRa这种低功耗广域网技术用到你的物联网设备、远程控制或者分布式采集系统中，那么接下来的内容会帮你避开我走过的弯路。我们不止于让模块“跑起来”，更要探讨如何在多任务环境下，让它“跑得稳”、“跑得好”。

1. 硬件连接与模块配置：避开初学者的“天坑”

拿到AS32 TTL-100模块，第一印象是引脚真不少，但核心通信其实就靠串口。很多新手第一脚就踩进坑里，不是因为电路多复杂，而是忽略了几个关键引脚的特殊性。

1.1 核心引脚连接详解

模块通过一个1.27mm间距的邮票孔引出接口，我们需要关注的主要是以下几组：

• 电源（VCC, GND）：这是老生常谈，但必须强调：务必使用稳定、低噪声的3.3V电源。LoRa在发射瞬间电流峰值可能达到100mA以上，电源纹波过大会导致模块工作不稳定甚至重启。建议在模块的VCC和GND引脚就近放置一个10uF的钽电容和一个0.1uF的陶瓷电容。
• 串口（TXD, RXD）：与STM32的USART连接。这里有个经典交叉：模块的TXD接MCU的RXD，模块的RXD接MCU的TXD。我建议使用STM32的USART2或USART3，因为它们通常独立于下载接口（USART1），避免调试时冲突。
• 模式控制（MD0, MD1, AUX）：这是配置和正常工作的关键。AS32有三种主要工作模式，由这两个引脚的电平组合决定。

MD1	MD0	模块工作模式	说明
0	0	普通传输模式	上电后的默认模式，用于正常的数据收发。
0	1	WOR（Wake On Radio）模式	低功耗监听模式，周期性唤醒接收，适用于电池供电场景。
1	0	配置模式	在此模式下，可通过串口使用AT指令集对模块参数（如地址、速率、功率）进行配置。
1	1	保留	通常不使用。

注意：MD0和MD1引脚绝不能悬空！ 即使你只想用默认模式，也必须通过电阻（如上拉或下拉）将其固定到明确的高或低电平。悬空会导致引脚电平不确定，模块行为诡异，这是最常见的通信失败原因之一。对于初学者，最稳妥的做法是直接用杜邦线将其连接到STM32的GPIO上，由软件控制，或者焊接一个10kΩ的下拉电阻到GND。

• AUX引脚：这是一个输出引脚，用于指示模块状态。例如，在发送数据时，AUX会拉低；空闲时拉高。它可以用来中断通知MCU“模块已准备好发送下一帧”或“一帧数据已发送完毕”，用于优化流控。初期调试可以不接，但后期做高性能应用时很有用。

一个典型的连接示意图如下（以STM32F103C8T6和USART2为例）：

AS32 TTL-100          STM32F103
VCC          <----->  3.3V
GND          <----->  GND
TXD          <----->  PA3 (USART2_RX)
RXD          <----->  PA2 (USART2_TX)
MD0          <----->  PA4 (GPIO_Output)
MD1          <----->  PA5 (GPIO_Output)
AUX          <----->  PA6 (GPIO_Input，可选)

1.2 使用配置工具设定模块参数

在焊接好硬件后，我强烈建议你先用USB转TTL工具和厂商的上位机软件单独配置模块，确保模块本身是好的，参数符合你的网络规划。这能排除一半的软件问题。

1. 硬件连接：将USB转TTL的3.3V、GND、TXD、RXD分别与模块对应引脚连接。关键一步：将模块的MD0接高电平（3.3V），MD1接低电平（GND），使模块进入配置模式。
2. 软件操作：打开泽耀科技提供的配置工具，选择正确的COM口，波特率通常为9600（注意：这是配置通信的波特率，与模块后续工作波特率是两回事）。点击“打开串口”。
3. 读取与设置参数：点击“读取参数”，软件会显示模块当前的所有设置。你需要重点关注这几项：
   • 空中速率：决定通信速度和距离。速率越低，距离越远，抗干扰越强，但传输越慢。根据你的需求在0.3k到19.2k之间选择。
   • 工作频率：确保通信双方频率一致。国内常用433MHz频段。
   • 发射功率：功率越大，距离越远，但耗电也越大。一般设置在20dBm（约100mW）是个平衡点。
   • 模块地址：在定点传输模式下，用于标识设备。0xFFFF为广播地址。
   • 串口波特率：模块与MCU通信的速率，建议设置为115200或9600，与你的STM32程序设置一致。
   • 校验位/停止位：通常为8N1（8数据位，无校验，1停止位）。
4. 写入参数：修改后，点击“写入参数”，软件会提示成功。然后，将MD0和MD1都设置为低电平（接GND），让模块重启进入普通传输模式。此时，你可以用串口调试助手，在两个都配置好的模块间互相发送文本，测试基本通信是否正常。

2. STM32底层驱动开发：构建可靠的通信基础

当模块能通过USB转TTL正常通信后，下一步就是把它交给STM32来控制。我们需要编写稳定、健壮的底层驱动，为上层的FreeRTOS任务提供干净的接口。

2.1 GPIO与USART初始化

驱动代码的核心是初始化连接模块的USART和模式控制GPIO。这里以STM32标准外设库为例，展示关键部分。

// lora.c
#include "lora.h"
#include "stm32f10x.h"

// 定义硬件连接
#define LORA_USARTx        USART2
#define LORA_USART_IRQn    USART2_IRQn
#define LORA_USART_APBx    RCC_APB1Periph_USART2
#define LORA_GPIO_APBx     RCC_APB2Periph_GPIOA
#define LORA_GPIOx         GPIOA
#define LORA_TX_PIN        GPIO_Pin_2
#define LORA_RX_PIN        GPIO_Pin_3
#define LORA_MD0_PIN       GPIO_Pin_4
#define LORA_MD1_PIN       GPIO_Pin_5
#define LORA_AUX_PIN       GPIO_Pin_6  // 可选

// 接收缓冲区及相关变量
uint8_t lora_rx_buffer[LORA_RX_BUF_SIZE];
volatile uint16_t lora_rx_write_idx = 0;
volatile uint16_t lora_rx_read_idx = 0;
volatile uint8_t lora_rx_flag = 0; // 一帧接收完成标志

void LORA_GPIO_Init(void) {
    GPIO_InitTypeDef GPIO_InitStructure;

    // 使能时钟
    RCC_APB2PeriphClockCmd(LORA_GPIO_APBx, ENABLE);

    // 配置USART TX为复用推挽输出
    GPIO_InitStructure.GPIO_Pin = LORA_TX_PIN;
    GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP;
    GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
    GPIO_Init(LORA_GPIOx, &GPIO_InitStructure);

    // 配置USART RX为浮空输入
    GPIO_InitStructure.GPIO_Pin = LORA_RX_PIN;
    GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IN_FLOATING;
    GPIO_Init(LORA_GPIOx, &GPIO_InitStructure);

    // 配置MD0, MD1为推挽输出，并初始化为0（普通模式）
    GPIO_InitStructure.GPIO_Pin = LORA_MD0_PIN | LORA_MD1_PIN;
    GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP;
    GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
    GPIO_Init(LORA_GPIOx, &GPIO_InitStructure);
    GPIO_ResetBits(LORA_GPIOx, LORA_MD0_PIN);
    GPIO_ResetBits(LORA_GPIOx, LORA_MD1_PIN);

    // 配置AUX为输入（可选）
    GPIO_InitStructure.GPIO_Pin = LORA_AUX_PIN;
    GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IPU; // 上拉输入
    GPIO_Init(LORA_GPIOx, &GPIO_InitStructure);
}

void LORA_USART_Init(uint32_t baudrate) {
    USART_InitTypeDef USART_InitStructure;
    NVIC_InitTypeDef NVIC_InitStructure;

    // 使能USART时钟
    RCC_APB1PeriphClockCmd(LORA_USART_APBx, ENABLE);

    // USART参数配置
    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_USARTx, &USART_InitStructure);

    // 使能USART接收中断
    USART_ITConfig(LORA_USARTx, USART_IT_RXNE, ENABLE);

    // 配置USART中断
    NVIC_InitStructure.NVIC_IRQChannel = LORA_USART_IRQn;
    NVIC_InitStructure.NVIC_IRQChannelPreemptionPriority = 1; // 抢占优先级
    NVIC_InitStructure.NVIC_IRQChannelSubPriority = 0; // 子优先级
    NVIC_InitStructure.NVIC_IRQChannelCmd = ENABLE;
    NVIC_Init(&NVIC_InitStructure);

    // 使能USART
    USART_Cmd(LORA_USARTx, ENABLE);
}

2.2 中断驱动型数据接收与环形缓冲区

为了不阻塞系统，我们采用中断方式接收数据，并使用环形缓冲区（Ring Buffer）来缓存收到的字节。这是保证在高速或突发数据流下不丢帧的关键。

// 中断服务函数
void USART2_IRQHandler(void) {
    uint8_t data;
    if(USART_GetITStatus(USART2, USART_IT_RXNE) != RESET) {
        data = USART_ReceiveData(USART2); // 读取数据
        uint16_t next_idx = (lora_rx_write_idx + 1) % LORA_RX_BUF_SIZE;

        // 如果缓冲区未满，则写入
        if(next_idx != lora_rx_read_idx) {
            lora_rx_buffer[lora_rx_write_idx] = data;
            lora_rx_write_idx = next_idx;

            // 简单帧尾判断：如果收到换行符`\n`，则认为一帧结束
            // 实际应根据你的通信协议来定，比如超时判断或特定结束符
            if(data == '\n') {
                lora_rx_flag = 1; // 设置帧接收完成标志
            }
        } else {
            // 缓冲区溢出处理，可以增加错误计数
        }
        USART_ClearITPendingBit(USART2, USART_IT_RXNE);
    }
}

// 上层调用，从环形缓冲区读取一帧数据
uint16_t LORA_ReceiveFrame(uint8_t *buf, uint16_t max_len, uint32_t timeout) {
    uint16_t len = 0;
    uint32_t start_tick = xTaskGetTickCount(); // FreeRTOS的Tick计数

    // 等待一帧数据接收完成的标志
    while(lora_rx_flag == 0) {
        if((xTaskGetTickCount() - start_tick) > timeout) {
            return 0; // 超时，返回0
        }
        vTaskDelay(1); // 让出CPU，避免忙等
    }

    // 读取数据，直到遇到帧尾或缓冲区空
    taskENTER_CRITICAL(); // 进入临界区保护共享资源
    while(lora_rx_read_idx != lora_rx_write_idx && len < max_len) {
        buf[len++] = lora_rx_buffer[lora_rx_read_idx];
        lora_rx_read_idx = (lora_rx_read_idx + 1) % LORA_RX_BUF_SIZE;
        // 如果读到帧尾，跳出循环
        if(buf[len-1] == '\n') {
            break;
        }
    }
    lora_rx_flag = 0; // 清除标志
    taskEXIT_CRITICAL(); // 退出临界区
    return len;
}

这种“中断填充缓冲区 + 主循环解析”的模式，是嵌入式串口处理的经典方法，它能有效解耦高速硬件事件和相对低速的业务逻辑。

3. FreeRTOS任务设计：构建响应式应用框架

当底层驱动准备就绪，我们就可以在FreeRTOS上构建应用了。目标是将LoRa的收发功能封装成独立、可管理的任务，并处理好它们与其他系统任务（如传感器采集、状态显示）的协调。

3.1 任务划分与优先级规划

在一个典型的物联网终端节点中，我倾向于将LoRa相关功能划分为两个核心任务：

1. LORA发送任务：负责将需要上报的数据（如传感器数据、设备状态）打包并通过LoRa模块发送出去。这个任务通常由其他任务通过队列（Queue）来触发。
2. LORA接收任务：持续监听LoRa模块收到的数据，对指令进行解析并执行相应操作（如控制继电器、修改参数）。它应该是常驻运行的。

此外，还需要一个应用协调任务（或叫主控任务），它负责调度传感器采集、处理用户输入，并决定何时向LORA发送任务发送数据。

任务优先级需要仔细考量。通常：

• LORA接收任务：给予较高优先级。因为对远程指令的响应要及时，避免因系统繁忙而延迟。例如，设置优先级为3。
• LORA发送任务：优先级可以稍低于接收任务，但高于一般的后台处理任务。因为它需要及时将重要数据发出，但通常不要求微秒级响应。例如，设置优先级为2。
• 应用协调任务：优先级可以设为最低（如1），因为它主要负责流程协调，实时性要求不高。

3.2 使用队列进行任务间通信

任务之间不能直接共享变量，FreeRTOS的队列（Queue）是线程安全的数据传递利器。例如，传感器采集任务将数据打包好后，放入一个队列，LORA发送任务从队列中取出数据并发送。

// 定义消息结构体
typedef struct {
    uint8_t  sensor_id;
    uint32_t timestamp;
    float    value;
} sensor_data_t;

// 在头文件中声明队列句柄
extern QueueHandle_t xSensorDataQueue;

// 在应用协调任务中（例如传感器读取后）
sensor_data_t data_to_send;
data_to_send.sensor_id = 1;
data_to_send.timestamp = xTaskGetTickCount();
data_to_send.value = read_temperature();

// 将数据发送到队列，等待100ms（Tick数）
if(xQueueSend(xSensorDataQueue, &data_to_send, pdMS_TO_TICKS(100)) != pdPASS) {
    // 发送失败，可能是队列满，需要处理（如丢弃旧数据或记录错误）
}

// 在LORA发送任务中
void vLoRaSendTask(void *pvParameters) {
    sensor_data_t received_data;
    uint8_t lora_packet[20]; // 假设的LoRa数据包缓冲区

    for(;;) {
        // 无限等待队列中的数据
        if(xQueueReceive(xSensorDataQueue, &received_data, portMAX_DELAY) == pdPASS) {
            // 成功收到数据，将其封装为LoRa协议包
            uint16_t packet_len = encode_sensor_data(&received_data, lora_packet);

            // 调用底层驱动发送
            LORA_SendData(lora_packet, packet_len);

            // 可以添加发送完成后的处理，如LED指示
            vToggleLED();
        }
    }
}

3.3 接收任务的阻塞式设计

LORA接收任务的设计目标是低功耗且及时响应。我们可以利用FreeRTOS的xQueueReceive或信号量（Semaphore）在无数据时阻塞任务，让出CPU时间。

一种更高效的方式是结合我们驱动层的lora_rx_flag。我们可以在驱动层收到完整一帧后，释放一个二进制信号量（Binary Semaphore），从而唤醒接收任务。

// 在lora.c中定义信号量
SemaphoreHandle_t xLoRaFrameSemaphore = NULL;

// 在初始化函数中创建信号量
void LORA_Init(void) {
    // ... 其他初始化代码
    xLoRaFrameSemaphore = xSemaphoreCreateBinary();
}

// 修改中断服务函数，在收到完整帧后给出信号量（在中断中必须使用FromISR版本）
void USART2_IRQHandler(void) {
    // ... 数据接收和帧判断代码 ...
    if(data == '\n') { // 帧结束
        BaseType_t xHigherPriorityTaskWoken = pdFALSE;
        xSemaphoreGiveFromISR(xLoRaFrameSemaphore, &xHigherPriorityTaskWoken);
        portYIELD_FROM_ISR(xHigherPriorityTaskWoken); // 如果需要，立即进行任务切换
    }
}

// LORA接收任务
void vLoRaReceiveTask(void *pvParameters) {
    uint8_t rx_frame[64];
    uint16_t frame_len;

    for(;;) {
        // 等待信号量，无限期阻塞直到收到一帧数据
        if(xSemaphoreTake(xLoRaFrameSemaphore, portMAX_DELAY) == pdTRUE) {
            // 信号量被触发，说明有完整帧到达
            frame_len = LORA_ReadFrameFromBuffer(rx_frame, sizeof(rx_frame));

            if(frame_len > 0) {
                // 解析并处理指令
                process_lora_command(rx_frame, frame_len);
            }
        }
    }
}

这种设计使得接收任务绝大部分时间处于阻塞状态，不消耗CPU资源，只在有数据需要处理时才被激活，非常高效。

4. 高级主题与实战优化

当基础框架跑通后，为了应对更复杂的实际场景，我们还需要考虑一些高级特性和优化点。

4.1 功耗管理与WOR模式

对于电池供电的设备，功耗是生命线。AS32 TTL-100支持WOR模式。在此模式下，模块大部分时间处于深度睡眠，只在极短的周期内唤醒监听信道，功耗可以低至十几个微安。

使用WOR模式，你需要：

1. 硬件配置：通过配置工具将模块设置为WOR模式，并设置唤醒周期（如2秒）。
2. 软件协同：发送端需要在数据前增加一定长度的前导码，确保在接收端唤醒的窗口期内能捕捉到信号。这要求通信双方在时间和协议上紧密配合。
3. STM32控制：你的STM32主控也应进入低功耗模式（如Stop模式），通过模块的AUX引脚或RTC定时器来同步唤醒。这涉及到更复杂的电源管理策略。

4.2 通信协议与可靠性增强

串口透传只是把字节发出去，实际项目必须定义自己的应用层协议，以确保数据的可靠性和可解析性。一个简单的帧结构可以包括：

字段	长度（字节）	描述
帧头	2	固定值，如0xAA55，用于帧同步
目标地址	2	接收模块的地址
源地址	2	发送模块的地址
命令字	1	标识数据类型或指令
数据长度	1	负载数据的长度
负载数据	N	实际传输的数据
校验和	2	CRC16校验，用于检错
帧尾	1	固定值，如0x0D

在发送任务中，你需要封装这样的协议包；在接收任务中，需要严格解析，校验帧头、帧尾和CRC，丢弃无效或损坏的数据包。对于关键指令，还可以加入应答重传机制。

4.3 天线与射频性能调优

最后，别忘了硬件层面的优化。LoRa的通信距离极大依赖于天线和环境。

• 天线选择：务必使用与模块频率匹配（如433MHz）的天线，并且天线类型（鞭状、弹簧、PCB天线）要符合你的结构设计。
• 天线安装：天线应尽量远离金属物体和高速数字电路（如MCU、开关电源），避免遮挡。
• 实地测试：在预期的部署环境中进行拉距测试，记录不同速率、功率下的包接收率（PER），找到最适合当前环境的参数组合。你会发现，有时候降低一点速率，通信成功率会有质的提升。

调试LoRa链路时，我习惯准备一个USB供电的AS32模块作为“监听哨兵”，连接到电脑的串口调试助手，实时显示空中所有的数据包，这对于分析网络中的通信状况、查找干扰源非常有帮助。