Skip to content

Latest commit

 

History

History
116 lines (82 loc) · 4.92 KB

flash.md

File metadata and controls

116 lines (82 loc) · 4.92 KB
Raw

EasyLogger Flash插件移植说明

1、准备工作

在使用Flash插件前，保证EasyLogger的核心功能已经在项目中移植成功（移植文档点这里）。再确认已下载的源码中存在\easylogger\plugins\flash文件夹，该文件夹为Flash插件的所有源码。

2、导入项目

目前只有STM32F10x平台的RT-Thread系统Demo里面使用了Flash插件，如果你的项目与这个Demo平台一致，则可以先直接跳过2、3、4章节，按照第5章的要求设置参数，并运行、验证Demo。验证通过再按照下面的导入项目要求，将Demo中的移植文件直接导入到项目中即可。

  • 1、打开\easylogger\plugins\flash文件夹，内部文件结构如下：
源文件 描述
elog_flash.c Flash插件源码
elog_flash.h Flash插件头文件
elog_flash_cfg.h Flash插件配置头文件
elog_flash_port.c Flash插件移植文件
  • 2、将\easylogger\plugins\flash下的所有文件拷贝到项目中；
  • 3、添加elog_flash.c及elog_flash_port.c这些文件到项目的编译路径中；
  • 4、添加插件所在文件夹到编译的头文件目录列表中；

3、移植接口

3.1 移植初始化

Flash插件移植初始化。初始化Flash插件移植所需的资源等等。

ElogErrCode elog_flash_port_init(void)

3.2 Flash中的日志被读取后的输出接口

将日志从Flash中读取后，调用elog_flash_output()、elog_flash_output_all()及elog_flash_output_recent()进行输出展示时，将会调用此移植接口。可以在里面增加输出到终端、网络等功能。

void elog_flash_port_output(const char *log, size_t size)
参数 描述
log 日志内容
size 日志大小

例子：

void elog_flash_port_output(const char *log, size_t size) {
    /* output to terminal */
    rt_kprintf("%.*s", size, log);
}

3.3 资源同步锁-加锁

对日志写入Flash操作进行加锁，保证日志在并发写入时的正确性。有操作系统时可以使用获取信号量来加锁，裸机时可以通过关闭全局中断来加锁。

void elog_flash_port_lock(void)

3.4 资源同步锁-解锁

与加锁功能对应。

void elog_flash_port_unlock(void)

4、设置参数

配置时需要修改项目中的elog_flash_cfg.h文件，开启、关闭、修改对应的宏即可。

4.1 缓冲模式

开启后，需要写入Flash的日志会先存储至RAM缓冲区，当缓冲区满时，缓冲区中的所有日志将自动写入Flash。如果关闭，所有日志在输出时会立刻写入Flash。

  • 默认状态：开启
  • 操作方法：开启、关闭ELOG_FLASH_USING_BUF_MODE宏即可

4.1.1 缓冲区大小

当开启缓冲模式后，此配置才会生效，单位：byte。

  • 操作方法：修改ELOG_FLASH_BUF_SIZE宏对应值即可

5、测试验证

每次使用前，务必核心功能都已经初始化完成，再调用elog_flash_init()方法对Flash插件进行初始化，保证初始化没问题后，再调用elog_start()方法启动EasyLogger，最后就可以使用Flash插件自带的API方法进行测试。如果使用的RT-Thread的Demo，则可以按照这里的命令要求，接上finsh串口，输入finsh命令即可测试。

摘取自STM32平台下RT-Thread Demo中的初始化过程（点击查看全部）：

/* 初始化EasyFlash及EasyLogger */
if ((easyflash_init() == EF_NO_ERR)&&(elog_init() == ELOG_NO_ERR)) {
    /* 设置日志格式 */
    elog_set_fmt(ELOG_LVL_ASSERT, ELOG_FMT_ALL & ~ELOG_FMT_P_INFO);
    elog_set_fmt(ELOG_LVL_ERROR, ELOG_FMT_LVL | ELOG_FMT_TAG | ELOG_FMT_TIME);
    elog_set_fmt(ELOG_LVL_WARN, ELOG_FMT_LVL | ELOG_FMT_TAG | ELOG_FMT_TIME);
    elog_set_fmt(ELOG_LVL_INFO, ELOG_FMT_LVL | ELOG_FMT_TAG | ELOG_FMT_TIME);
    elog_set_fmt(ELOG_LVL_DEBUG, ELOG_FMT_ALL & ~(ELOG_FMT_FUNC | ELOG_FMT_P_INFO));
    elog_set_fmt(ELOG_LVL_VERBOSE, ELOG_FMT_ALL & ~(ELOG_FMT_FUNC | ELOG_FMT_P_INFO));
    /* 设置EasyLogger的断言钩子方法 */
    elog_assert_set_hook(elog_user_assert_hook);
    /* 初始化EasyLogger的Flash 插件 */
    elog_flash_init();
    /* 启动EasyLogger */
    elog_start();
    /* 设置RT-Thread提供的硬件异常钩子方法 */
    rt_hw_exception_install(exception_hook);
    /* 设置RT-Thread断言钩子方法 */
    rt_assert_set_hook(rtt_user_assert_hook);
}