STM32F091RC Nucleo开发板/dev/ttyACM0串口无消息显示问题

问题现象 #

• 可通过kermit、Putty、Python serial连接/dev/ttyACM0，波特率38400，终端显示连接提示但无设备发送的消息
• /dev目录下可见该端口，UART初始化参数与终端配置完全匹配
• 已调用HAL_UART_Transmit发送欢迎消息，但终端始终无显示

排查与解决步骤 #

1. 修复UART句柄作用域问题 #

你的MX_USART2_UART_Init函数内定义了局部变量UART_HandleTypeDef huart2，函数执行结束后该变量会被销毁，后续调用HAL_UART_Transmit时使用的&huart2是无效地址，导致发送失败。
修改方案：将huart2定义为全局变量，确保作用域覆盖发送函数：

// 在函数外全局声明
UART_HandleTypeDef huart2;

static void MX_USART2_UART_Init(void)
{
    /* USER CODE BEGIN USART2_Init 0 */
    /* USER CODE END USART2_Init 0 */

    /* USER CODE BEGIN USART2_Init 1 */
    /* USER CODE END USART2_Init 1 */
    huart2.Instance = USART2;
    huart2.Init.BaudRate = 38400;
    huart2.Init.WordLength = UART_WORDLENGTH_8B;
    huart2.Init.StopBits = UART_STOPBITS_1;
    huart2.Init.Parity = UART_PARITY_NONE;
    huart2.Init.Mode = UART_MODE_TX_RX;
    huart2.Init.HwFlowCtl = UART_HWCONTROL_NONE;
    huart2.Init.OverSampling = UART_OVERSAMPLING_16;
    huart2.Init.OneBitSampling = UART_ONEBIT_SAMPLING_DISABLED;
    huart2.AdvancedInit.AdvFeatureInit = UART_ADVFEATURE_NO_INIT;
    HAL_UART_Init(&huart2);
    /* USER CODE BEGIN USART2_Init 2 */
    /* USER CODE END USART2_Init 2 */
}

2. 验证GPIO引脚配置 #

Nucleo-STM32F091RC的USART2默认引脚为PA2(TX)、PA3(RX)，需确认HAL_UART_MspInit函数（通常在stm32f0xx_hal_msp.c中）已正确初始化GPIO：

void HAL_UART_MspInit(UART_HandleTypeDef* uartHandle)
{
    GPIO_InitTypeDef GPIO_InitStruct = {0};
    if(uartHandle->Instance==USART2)
    {
        /* 开启USART2时钟 */
        __HAL_RCC_USART2_CLK_ENABLE();
        /* 开启GPIOA时钟 */
        __HAL_RCC_GPIOA_CLK_ENABLE();
        
        /**USART2 GPIO配置
        PA2     ------> USART2_TX
        PA3     ------> USART2_RX
        */
        GPIO_InitStruct.Pin = GPIO_PIN_2|GPIO_PIN_3;
        GPIO_InitStruct.Mode = GPIO_MODE_AF_PP;
        GPIO_InitStruct.Pull = GPIO_NOPULL;
        GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH;
        GPIO_InitStruct.Alternate = GPIO_AF1_USART2;
        HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);
    }
}

3. 简化发送逻辑测试 #

跳过字符串宏，直接发送固定测试数据，排除字符串定义问题，同时添加换行符确保终端刷新显示：

void printWelcomeMessage(void) {
    uint8_t test_msg[] = "UART Test OK\n\r";
    HAL_UART_Transmit(&huart2, test_msg, sizeof(test_msg)-1, HAL_MAX_DELAY);
}

4. 确认物理连接通路 #

• 检查Nucleo板上的ST-Link与USART2的连接跳线（默认出厂已连接，可检查JP5/JP6等跳线是否在位）
• 用示波器或逻辑分析仪测量PA2引脚，确认调用发送函数时是否有电平变化，验证硬件输出是否正常

5. 检查初始化流程顺序 #

确保在调用printWelcomeMessage之前，已完成以下初始化步骤：

• 执行HAL_Init()
• 完成系统时钟初始化SystemClock_Config()
• 调用MX_USART2_UART_Init()初始化USART2

内容的提问来源于stack exchange，提问作者persona