1. 启用 log
lvgl 内置有日志模块,并使用 MCU 的串口实时输出用户库中正在发生的事情。要启用 lvgl 日志记录,需要用户在 配置文件 lv_conf.h 中将 LV_USE_LOG 条件编译宏定义设置为 1,这样就启用了 lvgl 的日志功能程序模块。但是仅仅配置该宏定义并无法输出日志。
2. 实现串口字符串输出函数
前面提到 lvgl 要能够输出信息需要依赖于 MCU 的串口,所以这一步我们需要编写实现 MCU 的串口驱动,但对于不同的串口驱动编写具有一定的差别这取决于具体使用的 MCU ,所以对于串口驱动编写这里并不会赘述。但是对于串口输出字符串部分这确是通用的,例如 void put_string(const char * str) 这个函数名的命名并不是唯一的,这里仅仅描述大致的编写样式。因为该函数用于 lvgl 内部输出函数调用,所以具体的形参个数和形参类型我们可以参考 lvgl 的 log 回调函数指针的定义形式 。
lvgl 回调函数指针定义
/**
* Log print function. Receives a string buffer to print".
*/
typedef void (*lv_log_print_g_cb_t)(const char *buf);
我们字符串输出函数定义
void put_string(const char * str)
{
// MCU 串口字符串输出函数
usart_send_string(CURRENT_USART, str);
}
3. 注册输出回调函数
前面说到我们定义的字符串输出函数是用于 lvgl 内部回调使用的,换句话说就是 lvgl 内部存在一个函数指针(即 lv_log_print_g_cb_t 指针),这个函数指针最终会指向我们定义的串口输出字符串函数(即 put_string 函数)。但是这个指针如何指向我们定义的函数呢,答案就是通过注册的方式(直白一些就是简单赋值),lvgl 提供了注册函数 void lv_log_register_print_cb(lv_log_print_g_cb_t print_cb) 下面来看看该函数具体内容,如下所示:
/**
* Register custom print/write function to call when a log is added.
* It can format its "File path", "Line number" and "Description" as required
* and send the formatted log message to a console or serial port.
* @param print_cb a function pointer to print a log
*/
void lv_log_register_print_cb(lv_log_print_g_cb_t print_cb)
{
custom_print_cb = print_cb;
}
是的,其内部仅仅一条简单的赋值语句。 最后,具体的使用方法即 lv_log_register_print_cb(put_string); 将其放置到我们程序的 main() 函数执行一次即可注册。
4. 日志级别
LV_LOG_LEVEL_TRACE 记录所有信息 LV_LOG_LEVEL_INFO 记录重要事件 LV_LOG_LEVEL_WARN 记录是否发生了警告事件 LV_LOG_LEVEL_ERROR 记录错误信息,当系统可能发生故障时或致命错误 LV_LOG_LEVEL_NONE 不要记录任何东西
级别高于设置的日志级别的事件也将被记录。例如,如果使用 LV_LOG_LEVEL_WARN 级别,也会记录错误。
|