ulog 是 RT-Thread 全新的日志组件，其前后端分离式设计，使得更多的后端可以轻松的对接上去。该软件包主要实现了 ulog 的 Flash 后端 以及 ulog 的过滤器参数存储 两大功能，它的底层基于 Flash 闪存库 EasyFlash ，使得来自于 ulog 的日志及过滤参数可以轻松保存在 Flash 上。其主要功能特点如下：
- 资源占用小，与 EasyFlash 的 ENV 及 LOG 功能无缝对接；
- 日志采用循环替换方式进行存储，当日志分区满了以后，会自动删除最久的日志；
- 已存储的历史日志支持读取到 RT-Thread 控制台中，便于阅读、调试；
- 可选择性的读取近期一部分日志到 RT-Thread 控制台中；
- 开机自动装载已保存的 ulog 过滤参数；
- 所有功能提供了 Finsh/MSH 命令，支持：日志读取，日志清理，保存过滤参数。
本软件包遵循 MIT 许可，详见 LICENSE 文件。
- RT-Thread 3.1.1+
- EasyFlash 3.0.0+
使用本软件包需要在 RT-Thread 的包管理器中选择它，具体路径如下：
RT-Thread online packages
tools packages --->
[*] ulog_easyflash: The ulog flash plugin by EasyFlash.
[*] Enable the flash backend for ulog
[*] Save the ulog filter configuration to flash
Version (latest) --->
Enable the flash backend for ulog：开启 ulog 的 flash 后端功能；Save the ulog filter configuration to flash：开启保存 ulog 过滤参数的功能。
然后让 RT-Thread 的包管理器自动更新，或者使用 pkgs --update 命令更新包到 BSP 中。
注意 ：
- 如果之前未开启 EasyFlash 的 LOG 功能，开启本软件包后，需要在 EasyFlash 选项中配置日志区域大小，配置名称为： Saved log area size。
- 使用保存过滤参数功能前，需保证 ulog 那边开启了运行时过滤功能，配置名称为：Enable runtime log filter.
需要在应用层调用 ulog_ef_backend_init() 初始化函数即可。如果项目开启了组件自动初始化，甚至连这个函数都无需调用，软件包里已经为这个函数添加了组件初始化功能。
通过该函数：void ulog_ef_log_lvl_set(rt_uint32_t level) ，可以设定想要保存到 Flash 里的日志级别，低于该级别的日志将被 丢弃 。举例：设定只保存警告（含）以上级别的日志，可以执行如下代码 ：
ulog_ef_log_lvl_set(LOG_LVL_WARNING)；通过该函数：void ulog_ef_filter_cfg_load(void) ，可以转载 Flash 中已经存储的 ulog 过滤参数。如果项目开启了组件自动初始化，这个函数会在上电时自动运行。
通过该函数：void ulog_ef_filter_cfg_save(void) ，可以将 ulog 已设定的过滤参数保存至 flash 中，该函数也有对应的 Finsh/MSH 命令：ulog_filter_save ，需要保存时，执行一下即可。
Flash 日志相关的命令格式为 ulog_flash <read|clean>
历史日志存到 Flash 后，可以通过下面的命令读取到控制台上，方便开发者回顾日志，分析问题。
- 读取全部的历史日志，输入命令：
ulog_flash read
msh />ulog_flash read
10-23 10:28:51.618 D/example tshell: LOG_D(1): RT-Thread is an open source IoT operating system from China.
10-23 10:28:51.618 I/example tshell: LOG_I(1): RT-Thread is an open source IoT
......
msh />- 读取近期的 200 字节日志，输入命令：
ulog_flash read 200
msh />ulog_flash read 200
log_w(50): RT-Thread is an open source IoT operating system from China.
10-23 19:37:05.137 E/test tshell: ulog_e(50): RT-Thread is an open source IoT operating system from China.
msh />当需要清空日志区的全部历史日志时，可以输入命令： ulog_flash clean
msh />ulog_flash clean
10-24 10:00:22.307 I/easyflash tshell: All logs which in flash is clean OK.
msh />稍等片刻，日志清理完成将会显示清理成功的提示。
在调试开发过程中，ulog 的过滤参数设定完成后，如果需要保存，可以输入命令：ulog_filter_save 。保存完完成后，重启再次使用 ulog_filter 命令，可以看到之前保存的过滤参数。
msh />ulog_filter_save
[Flash] (../packages/EasyFlash-latest/src/ef_env.c:821) Calculate ENV CRC32 number is 0x10C41F91.
[Flash] (../packages/EasyFlash-latest/src/ef_env.c:774) Erased ENV OK.
[Flash] (../packages/EasyFlash-latest/src/ef_env.c:788) Saved ENV OK.
msh />- 使用本软件包前，需保证依赖的选项被提前打开，否则在 menuconfig 无法看到选项。