当前位置：首页 > article >正文

STM32 C++编程，怎样使用printf函数从串口输出中文字符

article 2025/1/16 1:41:39

在STM32 C++编程中，使用printf函数从串口输出中文字符是可行的，但需要注意字符编码的问题。由于STM32的默认编码是ASCII，而中文字符通常属于Unicode编码（如UTF-8或GB2312），因此需要对字符编码进行转换和处理。

以下是实现串口输出中文字符的步骤和注意事项：

1. 字符编码的选择

在中文输出中，常用的编码格式有：

UTF-8：一种变长编码，兼容ASCII，适合多语言支持。
GB2312：简体中文字符集，适合中文输出。

在STM32中，推荐使用UTF-8编码，因为它与ASCII兼容，且可以通过简单的编码转换实现中文字符输出。

2. 使用`printf`输出中文字符

printf函数本身不支持直接输出Unicode字符，但可以通过以下方法实现中文字符的输出：

方法1：直接输出UTF-8编码的字符串

如果你在程序中使用UTF-8编码的字符串，可以直接将其传递给printf函数。

#include <stdio.h>
#include <string.h>

int main() {
    // UTF-8编码的中文字符串
    const char* utf8_str = "你好，世界！";

    // 通过printf输出
    printf("%s\n", utf8_str);

    return 0;
}

注意：

确保你的终端支持UTF-8编码，否则中文字符可能显示为乱码。
STM32串口发送的字符编码必须与接收端的编码一致。

方法2：将Unicode字符转换为UTF-8编码

如果你的中文字符是Unicode编码（如UTF-16或UTF-32），需要先将其转换为UTF-8编码，然后再输出。

#include <stdio.h>
#include <string.h>

// 模拟将Unicode字符转换为UTF-8编码的函数
void UnicodeToUTF8(const wchar_t* unicode_str, char* utf8_str, size_t max_len) {
    // 这里假设你有一个现成的转换函数，实际实现可能需要依赖库或手动实现
    // 例如，可以使用ICU库或Windows API进行转换
}

int main() {
    // Unicode字符串
    const wchar_t* unicode_str = L"你好，世界！";

    // 转换为UTF-8编码
    char utf8_str[100];
    UnicodeToUTF8(unicode_str, utf8_str, sizeof(utf8_str));

    // 通过printf输出
    printf("%s\n", utf8_str);

    return 0;
}

3. STM32串口配置

确保STM32的串口配置正确，能够发送UTF-8编码的字符：

#include "stm32f1xx_hal.h"

UART_HandleTypeDef huart1;

void USART1_Init() {
    __HAL_RCC_USART1_CLK_ENABLE();

    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;
    HAL_UART_Init(&huart1);
}

void USART1_Transmit(const char* str) {
    HAL_UART_Transmit(&huart1, (uint8_t*)str, strlen(str), HAL_MAX_DELAY);
}

int main() {
    HAL_Init();
    USART1_Init();

    const char* utf8_str = "你好，世界！";
    USART1_Transmit(utf8_str);

    while (1) {
        // 主循环
    }
}

注意：

确保串口波特率、数据位等配置与接收端匹配。
接收端的终端或工具需要支持UTF-8编码，否则中文字符会显示为乱码。

4. 编码格式的控制

为了控制串口输出的字符编码格式，可以：

UTF-8编码：直接输出UTF-8字符串，适合跨平台和多语言支持。
GB2312编码：如果接收端只支持GB2312，需要将UTF-8字符串转换为GB2312编码。

GB2312编码示例

假设你需要将UTF-8字符串转换为GB2312编码，可以使用字符编码转换库（如iconv）。

#include <iconv.h>
#include <string.h>

// 模拟将UTF-8转换为GB2312的函数
void UTF8ToGB2312(const char* utf8_str, char* gb2312_str, size_t max_len) {
    iconv_t cd = iconv_open("GB2312", "UTF-8");
    if (cd == (iconv_t)-1) {
        return;
    }

    size_t in_len = strlen(utf8_str);
    size_t out_len = max_len;
    const char* in_buf = utf8_str;
    char* out_buf = gb2312_str;

    iconv(cd, &in_buf, &in_len, &out_buf, &out_len);
    iconv_close(cd);
}

int main() {
    const char* utf8_str = "你好，世界！";
    char gb2312_str[100];
    UTF8ToGB2312(utf8_str, gb2312_str, sizeof(gb2312_str));

    // 输出GB2312编码的字符串
    printf("%s\n", gb2312_str);

    return 0;
}