为 stm32 设计一个实用的日志输出系统

#if (__ARMCC_VERSION >= 6010050)            /* 使用AC6编译器时 */
__asm(".global __use_no_semihosting\n\t");  /* 声明不使用半主机模式 */
__asm(".global __ARM_use_no_argv \n\t");    /* AC6下需要声明main函数为无参数格式，否则部分例程可能出现半主机模式 */

#else
/* 使用AC5编译器时, 要在这里定义__FILE 和 不使用半主机模式 */
#pragma import(__use_no_semihosting)

struct __FILE
{
    int handle;
    /* Whatever you require here. If the only file you are using is */
    /* standard output using printf() for debugging, no file handling */
    /* is required. */
};

#endif

/* 不使用半主机模式，至少需要重定义_ttywrch\_sys_exit\_sys_command_string函数,以同时兼容AC6和AC5模式 */
int _ttywrch(int ch)
{
    ch = ch;
    return ch;
}

/* 定义_sys_exit()以避免使用半主机模式 */
void _sys_exit(int x)
{
    x = x;
}

char *_sys_command_string(char *cmd, int len)
{
    return NULL;
}

/* FILE 在 stdio.h里面定义. */
FILE __stdout;

/* 重定义fputc函数, printf函数最终会通过调用fputc输出字符串到串口 */
int fputc(int ch, FILE *f)
{
    while ((USART_UX->ISR & 0X40) == 0);    /* 等待上一个字符发送完成 */

    USART_UX->TDR = (uint8_t)ch;            /* 将要发送的字符 ch 写入到DR寄存器 */
    return ch;
}

void usart_printf(USART_TypeDef* USARTx, const char *format, ...) {
    va_list list;
    va_start(list, format);
    int len = vsnprintf(0, 0, format, list);
    char *s; 
    s = (char *)malloc(len + 1);
    vsprintf(s, format, list);
    USART_puts(USARTx,s);
    free(s);
    va_end(list);
    return;
}

void USART_putc(USART_TypeDef* USARTx, char c){
    while(USART_GetFlagStatus(USARTx, USART_FLAG_TXE) == RESET);
    USART_SendData(USARTx,c);
}

void USART_puts(USART_TypeDef* USARTx, const char *s){
    int i;
    for(i=0;s[i]!='\0';i++) USART_putc(USARTx,s[i]);
}

#if (__ARMCC_VERSION >= 6010050)            /* 使用AC6编译器时 */
__asm(".global __use_no_semihosting\n\t");  /* 声明不使用半主机模式 */
__asm(".global __ARM_use_no_argv \n\t");    /* AC6下需要声明main函数为无参数格式，否则部分例程可能出现半主机模式 */

#else
/* 使用AC5编译器时, 要在这里定义__FILE 和 不使用半主机模式 */
#pragma import(__use_no_semihosting)

// 定义日志级别
#define LOGQUIET 0
#define	LOGERR	  1
#define	LOGWARN  2
#define	LOGINFO  3
#define	LOGDBG   4

// 定义默认使用的日志级别
#ifndef LOGLEVEL
#define LOGLEVEL LOGINFO
#endif

// 根据所使用的日志级别，决定相应的 log_xxx 宏定义，这里是 ST 提供的 Demo ，
// 实际上我们可以根据需要，定义一个如 logging_format_printf 函数，输出时间、文件、函数、行号等信息
#if LOGLEVEL >= LOGDBG
#define log_dbg(fmt, ...)  printf("[%05ld.%03ld][DBG  ]" fmt, HAL_GetTick()/1000, HAL_GetTick() % 1000, ##__VA_ARGS__)
#else
#define log_dbg(fmt, ...)
#endif
#if LOGLEVEL >= LOGINFO
#define log_info(fmt, ...) printf("[%05ld.%03ld][INFO ]" fmt, HAL_GetTick()/1000, HAL_GetTick() % 1000, ##__VA_ARGS__)
#else
#define log_info(fmt, ...)
#endif
#if LOGLEVEL >= LOGWARN
#define log_warn(fmt, ...) printf("[%05ld.%03ld][WARN ]" fmt, HAL_GetTick()/1000, HAL_GetTick() % 1000, ##__VA_ARGS__)
#else
#define log_warn(fmt, ...)
#endif
#if LOGLEVEL >= LOGERR
#define log_err(fmt, ...)  printf("[%05ld.%03ld][ERR  ]" fmt, HAL_GetTick()/1000, HAL_GetTick() % 1000, ##__VA_ARGS__)
#else
#define log_err(fmt, ...)
#endif

/**
 * 提供函数定义
 */
typedef void (*lv_log_print_g_cb_t)(const char * buf);

// 定义函数变量
static lv_log_print_g_cb_t custom_print_cb;

// 组件内注册函数函数，
void lv_log_register_print_cb(lv_log_print_g_cb_t print_cb)
{
    custom_print_cb = print_cb;
}

// 外部实现函数
static void lvgl_log_cb(const char * buf)
{
    // 接入外部日志输出函数
    SdkLog( "LVGL", buf );
}

//********************************//
void some_proper_function()
{
    /// 在适当位置调用 lv_log_register_print_cb，
    /// custom_print_cb 将指向外部实现函数 lvgl_log_cb 
    /// 从而实现向外部输出日志
    lv_log_register_print_cb(lvgl_log_cb);
}

/**
 * Add a log
 * @param level the level of log. (From `lv_log_level_t` enum)
 * @param file name of the file when the log added
 * @param line line number in the source code where the log added
 * @param func name of the function when the log added
 * @param format printf-like format string
 * @param ... parameters for `format`
 */
void _lv_log_add(lv_log_level_t level, const char * file, int line, const char * func, const char * format, ...)
{
    // 按照需求往 buf 格式化输出字符串
    ......
    .....

    // 最后调用 custom_print_cb 向外输出日志，实现干净的解耦
    custom_print_cb(buf);
}