EasyLogger 开发介绍与功能说明

EasyLogger

• 优势：轻量级、高性能、嵌入式系统、快捷
• 许可：MIT Copyright (c) armink.ztl@gmail.com

已完成 ，详见：https://www.zybuluo.com/armink/note/94817

1 前期开发功能

• 支持多种日志级别
• 支持多种输出方式（终端、文件、串口、485...）
• 日志内容可包含时间戳、线程、进程信息
• 日志输出被设计为线程安全的方式
• 支持多种操作系统（RT-Thread、UCOS、Linux、Windows...），也支持裸机平台
• 自带终端与文件输出两个模式，用户也可移植其他输出方式
• 日志支持 RAW格式 [1]，可设定按 标签 [2]进行过滤

2 后期开发功能

• 在EasyFlash[3]中增加日志存储、读取功能，让EasyLogger与其无缝对接。让日志可存储在非文件系统中，并具有历史日检索的功能。
• 文件系统下的配置文件
• 文件系统下支持文件按容量转档，按时间区分
• 开发Web版的日志助手，兼容Linux与Windows系统，直接在网页上查看、过滤（支持正则表达式）、排序、保存日志等

3 功能说明

3.1 参数配置

EasyLogger拥有过滤方式、输出格式、输出方式这些属性。

• 过滤方式支持按照标签、级别进行过滤
• 输出格式包含级别、线程、进程等信息，最好一次生成，强调高效率
• 输出方式包括终端、文件、设备等，如开启文件输出方式，则需增加文件转存方式的配置
• 可设定动态和静态的输出级别（静态：一级开关，通过宏定义；动态：二级开关，通过API接口）
  

  注：目前参数配置及输出方式都是单例模式，即全局只支持一种配置方式。此模式下，软件会较为简单，但是无法支持复杂的输出方式。

3.2 输出级别

0.[A]：断言(Assert)
1.[E]：错误(Error)
2.[W]：警告(Warn)
3.[I]：信息(Info)
4.[D]：调试(Debug)
5.[V]：详细(Verbose)

3.3 输出过滤

3.3.1 过滤级别

3.3.2 过滤标签

3.3.3 过滤关键词（待定）

注：对于配置较低的MCU建议不开启关键词过滤（默认为不开启），增加关键字过滤将会在大程度上减低日志的输出效率。实际上过滤关键词功能交给上位机做会更轻松，所以后期Web版本的日志助手开发顺利，则该功能就可以放弃。

3.4 输出格式

注：默认为 RAW格式，RAW格式日志不会被标签过滤

3.5 输出方式

• 终端：方便用户动态查看，不具有存储功能。
• 文件与Flash：都具有存储功能，用户可以查看历史日志。但是文件方式需要文件系统的支持，而Flash方式更加适合应用在无文件系统的小型嵌入式设备中。

注：
1、文件与Flash输出方式的优先级较低，会在后期实现
2、以上内容可以打开思维导图看到更清晰的逻辑。

4. Todo

4.1 同步输出

同步输出方式会虽然软件简单，不存在日志覆盖的问题，但是在输出效率较低的方式下，会由于增加日志，而降低软件运行速度。所以后期会改进为异步输出方式。关键字过滤也会放到异步输出中去。

4.2 Arduino lib

把库增加到Arduino lib中，增加其Demo