zhy
119 lines
3.5 KiB
C
119 lines
3.5 KiB
C
#include "uart4.h"
|
||
#include "stdio.h"
|
||
#include "string.h"
|
||
#include "stdarg.h"
|
||
|
||
/*
|
||
* 调试串口相关定义与缓冲区
|
||
*
|
||
* DEBUG_UART_HANDLE: 外部提供的 UART 句柄（在 CubeMX 产生的代码中为 huart4）
|
||
* DEBUG_TX_BUF_SIZE: 发送缓冲区大小（单位：字节），用于格式化输出
|
||
*/
|
||
#define DEBUG_UART_HANDLE huart4
|
||
#define DEBUG_TX_BUF_SIZE 256
|
||
/* 发送缓冲区：用于存放格式化后的字符串 */
|
||
static char debug_tx_buf[DEBUG_TX_BUF_SIZE];
|
||
/* DMA 发送忙标志（若使用 DMA 发送，可用来避免并发访问） */
|
||
static volatile uint8_t dma_busy = 0;
|
||
|
||
|
||
/*
|
||
* 阻塞字符串打印（Debug_Print）
|
||
* 说明：
|
||
* - 以阻塞方式调用 HAL_UART_Transmit 发送字符串数据，函数在发送完成或超时前会阻塞。
|
||
* - 适用场景：启动日志或对可靠性要求高、且发送频率低的调试信息。
|
||
* - 注意：不自动添加换行，需要用户在字符串末尾自己加上 "\r\n"（若需要）。
|
||
* 参数：
|
||
* - str：以 '\0' 结尾的字符串指针
|
||
*/
|
||
void Debug_Print(const char *str)
|
||
{
|
||
HAL_UART_Transmit(&DEBUG_UART_HANDLE,
|
||
(uint8_t *)str,
|
||
strlen(str),
|
||
100);
|
||
}
|
||
|
||
|
||
/*
|
||
* printf 风格的阻塞打印（Debug_Printf）
|
||
*
|
||
* 说明：
|
||
* - 使用 vsnprintf 将可变参数格式化到内部缓冲区 debug_tx_buf，再以阻塞方式发送。
|
||
* - vsnprintf 的返回值 len 表示所需的缓冲区长度（不含终止符）。当 len >= DEBUG_TX_BUF_SIZE
|
||
* 时表示输出被截断。此处将发送的数据长度限定为 DEBUG_TX_BUF_SIZE（不发送终止符）。
|
||
* - 若格式化失败（len <= 0）则直接返回，不进行发送。
|
||
* - 发送超时时间为 100 ms，可根据实际需要调整。
|
||
*
|
||
* 注意事项：
|
||
* - debug_tx_buf 为静态缓冲区，若在中断或多任务环境中使用，请确保同步（或改用 DMA/队列）。
|
||
* - 如果输出非常频繁或较大，建议改为异步（DMA）发送或使用环形缓冲队列以避免阻塞。
|
||
*
|
||
* 参数：
|
||
* - format: printf 风格的格式字符串
|
||
*/
|
||
void Debug_Printf(const char *format, ...)
|
||
{
|
||
va_list args;
|
||
int len;
|
||
va_start(args, format);
|
||
/* 将格式化内容写入缓冲区，最多写入 DEBUG_TX_BUF_SIZE 字节（包含终止符） */
|
||
len = vsnprintf(debug_tx_buf, DEBUG_TX_BUF_SIZE, format, args);
|
||
va_end(args);
|
||
|
||
/* 格式化失败或没有输出内容，直接返回 */
|
||
if (len <= 0)
|
||
{
|
||
return;
|
||
}
|
||
|
||
/* 如果输出长度超过缓冲区容量，截断到缓冲区最大容量（不发送末尾的 '\0'） */
|
||
if (len > DEBUG_TX_BUF_SIZE)
|
||
{
|
||
len = DEBUG_TX_BUF_SIZE;
|
||
}
|
||
|
||
/* 阻塞发送格式化后的数据 */
|
||
HAL_UART_Transmit(&DEBUG_UART_HANDLE,
|
||
(uint8_t *)debug_tx_buf,
|
||
len,
|
||
100);
|
||
}
|
||
|
||
/*
|
||
* DMA 打印：适合后面大量日志输出。
|
||
* 注意：TX DMA 建议 CubeMX 配 Normal，不要配 Circular。
|
||
*/
|
||
void Print_DMA(const char *str)
|
||
{
|
||
if (dma_busy)
|
||
{
|
||
return;
|
||
}
|
||
|
||
dma_busy = 1;
|
||
|
||
HAL_UART_Transmit_DMA(&DEBUG_UART_HANDLE,
|
||
(uint8_t *)str,
|
||
strlen(str));
|
||
}
|
||
|
||
|
||
|
||
uint8_t UART_IsBusy(void)
|
||
{
|
||
return dma_busy;
|
||
}
|
||
|
||
/*
|
||
* DMA 发送完成回调
|
||
* 注意：整个工程里 HAL_UART_TxCpltCallback 只能实现一次。
|
||
* 如果你其他地方也需要这个回调，要统一写在这里分发。
|
||
*/
|
||
void HAL_UART_TxCpltCallback(UART_HandleTypeDef *huart)
|
||
{
|
||
if (huart->Instance == UART4)
|
||
{
|
||
dma_busy = 0;
|
||
}
|
||
} |