ARMmbed/mbed-os中STM32WL LoRaWAN在AS923区域OTAA上行问题解析

问题背景

在使用ARMmbed/mbed-os开发STM32WLE5芯片(RAK3172模块)的LoRaWAN应用时，开发者遇到了一个特定区域配置下的通信问题。当设备配置为AS923区域时，无法通过OTAA方式在923.2MHz和923.4MHz频段上完成上行通信，而同样的硬件在AU915和US915区域却能正常工作。

问题分析

经过深入排查，发现该问题主要涉及三个关键因素：

1. 天线增益设置不当：AS923区域对发射功率有特殊限制，默认的天线增益设置可能导致实际发射功率超出规范要求。

2. 射频输出模式配置：STM32WL芯片支持多种射频输出模式，而RAK3172模块仅支持高功率(HP)输出模式，需要明确配置。

3. 区域特定参数：AS923区域相比其他区域有更严格的功率限制和不同的频段规划。

解决方案

1. 调整天线增益参数

在mbed_app.json配置文件中添加以下宏定义，将天线增益设置为-30dB：

"macros": [
    "MBEDTLS_USER_CONFIG_FILE=\"mbedtls_lora_config.h\"",
    "LORAPHY_ANTENNA_GAIN=-30.0f"
]

这一调整确保了设备在AS923区域的发射功率符合规范要求。

2. 明确配置射频输出模式

针对RAK3172模块的特性，需要在配置中明确指定使用高功率(HP)输出模式：

"RAK3172": {
    "stm32wl-lora-driver.rf_switch_config": "RBI_CONF_RFO_HP"
}

3. 完整配置参考

结合上述调整，完整的配置示例如下：

{
    "config": {
        "main_stack_size": {
            "value": 16000
        }
    },
    "target_overrides": {
        "*": {
            "platform.stdio-baud-rate": 9600,
            "platform.minimal-printf-enable-floating-point": 1,
            "lora.over-the-air-activation": true,
            "lora.duty-cycle-on": false,
            "lora.duty-cycle-on-join": true,
            "lora.phy": "AS923",
            "lora.phy-as923-sub-region": "AS1",
            "lora.downlink-preamble-length": 8
        },
        "RAK3172": {
            "stm32wl-lora-driver.crystal_select": 0,
            "stm32wl-lora-driver.rf_switch_config": "RBI_CONF_RFO_HP",
            "target.stdio_uart_tx": "PA_2_ALT0",
            "target.stdio_uart_rx": "PA_3_ALT0",
            "platform.cpu-stats-enabled": 1
        }
    },
    "macros": [
        "MBEDTLS_USER_CONFIG_FILE=\"mbedtls_lora_config.h\"",
        "LORAPHY_ANTENNA_GAIN=-30.0f"
    ]
}

技术原理

1. AS923区域特性：该区域对发射功率有严格要求，最大等效全向辐射功率(EIRP)通常限制在16dBm。过高的天线增益设置会导致EIRP超标，可能被网关拒绝。

2. STM32WL射频架构：该芯片支持多种射频输出配置，包括高功率(HP)和低功率(LP)模式。RAK3172模块设计上仅支持HP模式，因此需要明确配置以避免内部自动选择可能导致的兼容性问题。

3. 功率控制机制：LoRaWAN协议栈会根据区域规范、天线增益和设备能力自动计算最大允许发射功率。正确的配置确保了这一计算过程的准确性。

最佳实践建议

1. 针对不同区域使用时，应查阅当地无线电规范，了解具体的功率限制要求。

2. 开发阶段建议启用mbed-trace调试功能，监控LoRaWAN协议栈的运行状态和射频参数。

3. 对于STM32WL系列芯片，应仔细查阅硬件参考手册，了解所用模块的具体射频特性。

4. 在实际部署前，建议使用频谱分析仪验证发射功率是否符合预期和规范要求。

通过以上调整和优化，开发者可以确保STM32WL平台在AS923区域稳定可靠地运行LoRaWAN通信。