1// 文件: project/ln_model_public/bsp/serial_hw.c
2
3static void uart_io_pin_request(struct Serial *serial)
4{
5    // ... 其他UART的配置 ...
6
7    else if (serial->port_id == SER_PORT_UART2)
8    {
9        /******************zrh add******************/
10        // 配置 PA1 为 UART2 的 RX 功能
11        hal_gpio_pin_afio_select(GPIOA_BASE, GPIO_PIN_1, UART2_RX);
12        // 配置 PA4 为 UART2 的 TX 功能
13        hal_gpio_pin_afio_select(GPIOA_BASE, GPIO_PIN_4, UART2_TX);
14        
15        // 使能 PA1 和 PA4 的复用功能
16        hal_gpio_pin_afio_en(GPIOA_BASE, GPIO_PIN_1, HAL_ENABLE);
17        hal_gpio_pin_afio_en(GPIOA_BASE, GPIO_PIN_4, HAL_ENABLE);
18        /*******************************************/
19    }
20}

这段代码的作用是将PA1和PA4引脚的功能复用（AFIO）为UART2的接收和发送端，并启用该功能。

第二步：构建线程安全的发送函数

这是整个功能的核心。我们需要在 project/ln_model_public/app/servers/qiniu/mcp_server/mcp_tools/smart_toilet/uart.c 文件中实现初始化、数据发送和互斥锁保护。

1// 文件: .../smart_toilet/uart.c
2
3#define LOG_PORT_BAUDRATE CFG_UART_BAUDRATE_LOG
4
5// 定义一个全局的串口句柄
6Serial_t cmd_Serial;
7// 定义一个互斥锁句柄，用于保护串口写操作
8static OS_Mutex_t uart_write_mutex;
9
10// 串口初始化函数
11int uart_init(void)
12{
13    // 初始化 cmd_Serial，指定使用 UART2，并设置波特率
14    serial_init(&cmd_Serial, SER_PORT_UART2, LOG_PORT_BAUDRATE, NULL);
15    return 0;
16}
17
18// 互斥锁初始化函数
19void uart_write_mutex_init(void)
20{
21    OS_MutexCreate(&uart_write_mutex);
22}
23
24// 基础的串口写函数
25int cmd_stdio_write(char *buf, size_t size)
26{
27    int ret = 0;
28    // 调用底层的 serial_write 函数进行实际的数据发送
29    ret = serial_write(&cmd_Serial, (const void *)buf, size);
30    return ret;
31}
32
33// 线程安全的串口写函数
34void safe_cmd_uart_write(char *buf, size_t size)
35{
36    // 判断调度器是否已经运行
37    if (OS_ThreadIsSchedulerRunning()) {
38        // 如果调度器已运行，检查互斥锁是否有效，无效则创建
39        if (!OS_MutexIsValid(&uart_write_mutex)) {
40            OS_MutexCreate(&uart_write_mutex);
41        }
42        // 获取互斥锁，如果已被其他任务占用，则等待
43        OS_MutexLock(&uart_write_mutex, OS_WAIT_FOREVER);
44    }
45
46    // 执行实际的发送操作
47    cmd_stdio_write(buf, size);
48
49    // 发送完成后，释放互斥锁
50    if (OS_ThreadIsSchedulerRunning()) {
51        OS_MutexUnlock(&uart_write_mutex);
52    }
53}

关键点分析：

uart_init: 负责初始化指定的串口（UART2）。
safe_cmd_uart_write: 这是提供给其他任务调用的接口。它在发送数据前会先尝试获取互斥锁 uart_write_mutex。这确保了在任何时刻，只有一个任务能够执行 cmd_stdio_write，从而避免了数据交错。发送完成后，立即释放锁。

第三步：在主函数中调用初始化

最后，我们需要在系统启动时调用我们刚刚创建的初始化函数。

在 project/ln_model_public/app/main.c 文件的 main 函数中，添加如下调用：

1// 文件: project/ln_model_public/app/main.c
2
3int main(int argc, char *argv[])
4{
5    // ... 系统时钟、中断等初始化 ...
6
7    log_init();
8
9    /******************zrh add******************/
10    // 初始化UART
11    uart_init();
12    // 初始化UART写操作的互斥锁
13    uart_write_mutex_init();
14    /*******************************************/
15
16    // ... 其他初始化 ...
17}

确保在系统调度器启动前完成这些初始化工作。

第四步：配置网络状态指示LED

为了方便调试，我们可以配置一个LED来指示网络状态。

在 project/ln_model_public/app/usr_app.c 文件中，定义LED所使用的GPIO引脚：

1// 文件: project/ln_model_public/app/usr_app.c
2
3// 定义网络状态指示灯的端口和引脚
4#define CONFIG_NET_STATUS_PORT (GPIOB_BASE)
5#define CONFIG_NET_STATUS_PIN  (GPIO_PIN_6)

这里我们将网络状态指示灯配置在了PB6引脚上。