stm32f103c8t6HAL库移植到GD32f103c8t6上，出现了串口乱码问题，如何解决

### 解决STM32F103C8T6 HAL库移植到GD32F103C8T6时的串口乱码问题 在将STM32F103C8T6的HAL库移植到GD32F103C8T6的过程中，可能会遇到串口通信出现乱码的情况。这种现象通常是由于以下几个原因引起的： #### 1. **时钟配置差异** STM32和GD32虽然兼容性强，但在内部时钟源、PLL倍频等方面存在细微差别。如果未正确调整GD32的系统时钟配置，则可能导致UART波特率计算错误，进而引发串口数据传输异常。 解决方案是在`SystemClock_Config()`函数中重新校准GD32的具体外设时钟频率[^1]。例如： ```c void SystemClock_Config(void) { RCC_OscInitTypeDef RCC_OscInitStruct = {0}; RCC_ClkInitTypeDef RCC_ClkInitStruct = {0}; /** Initializes the CPU, AHB and APB buses clocks */ RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSE; RCC_OscInitStruct.HSEState = RCC_HSE_ON; RCC_OscInitStruct.PLL.PLLState = RCC_PLL_ON; RCC_OscInitStruct.PLL.PLLSource = RCC_PLLSOURCE_HSE; RCC_OscInitStruct.PLL.PLLMUL = RCC_PLL_MUL9; // 调整为适合GD32的乘法因子 if (HAL_RCC_OscConfig(&RCC_OscInitStruct) != HAL_OK) { Error_Handler(); } /** Initializes the CPU, AHB and APB buses clocks */ RCC_ClkInitStruct.ClockType = RCC_CLOCKTYPE_HCLK|RCC_CLOCKTYPE_SYSCLK | RCC_CLOCKTYPE_PCLK1|RCC_CLOCKTYPE_PCLK2; RCC_ClkInitStruct.SYSCLKSource = RCC_SYSCLKSOURCE_PLLCLK; RCC_ClkInitStruct.AHBCLKDivider = RCC_SYSCLK_DIV1; RCC_ClkInitStruct.APB1CLKDivider = RCC_HCLK_DIV2; RCC_ClkInitStruct.APB2CLKDivider = RCC_HCLK_DIV1; if (HAL_RCC_ClockConfig(&RCC_ClkInitStruct, FLASH_LATENCY_2) != HAL_OK) { Error_Handler(); } } ``` #### 2. **USART初始化参数不匹配** 即使使用相同的HAL库代码，不同芯片可能需要不同的USART初始化参数。特别是对于波特率分频器的设置，需确保其值适配目标MCU的实际工作频率。 检查并修正如下部分代码中的波特率设定项： ```c static void MX_USART1_UART_Init(void) { huart1.Instance = USART1; huart1.Init.BaudRate = 115200; // 确认此速率与实际需求一致 huart1.Init.WordLength = UART_WORDLENGTH_8B; huart1.Init.StopBits = UART_STOPBITS_1; huart1.Init.Parity = UART_PARITY_NONE; huart1.Init.Mode = UART_MODE_TX_RX; huart1.Init.HwFlowCtl = UART_HWCONTROL_NONE; huart1.Init.OverSampling = UART_OVERSAMPLING_16; if (HAL_UART_Init(&huart1) != HAL_OK) { Error_Handler(); } } ``` 此处应特别关注`BaudRate`字段是否依据当前系统的主频进行了合理折算[^2]。 #### 3. **浮点数支持缺失** 当尝试通过printf输出含有浮点数值的信息至串口终端时，如果没有启用相应的微控制器库选项（如μLib），则会观察到不可预期的结果——即所谓的“乱码”。这是因为标准的新lib C库默认关闭了对小型嵌入式设备的支持功能。 为了克服这一障碍，在项目属性窗口下的Target标签页勾选Use MicroLIB复选框即可激活必要的处理机制[^3]。 另外还需自定义实现fputc接口来完成最终的数据流向映射操作： ```c int fputc(int ch, FILE *f){ HAL_UART_Transmit(&huart1,(uint8_t *)&ch,1,0xFFFF); return ch; } ``` 综上所述，针对从STM32迁移到GD系列过程中产生的各类潜在隐患逐一排查整改后，基本可消除因环境切换带来的负面影响因素影响正常业务逻辑运行状况。