sunnydragon 发表于 2016-11-14 20:16:57

【升级】C/C++ 日志库 EasyLogger 新增彩色日志、异步输出等

本帖最后由 sunnydragon 于 2016-11-14 21:44 编辑

EasyLogger 是一款超轻量级(ROM<1.6K, RAM<0.3K)、高性能的 C/C++ 日志库,非常适合对资源敏感的软件项目,例如: IoT 产品、可穿戴设备、智能家居等等。 EasyLogger 功能简单,上手速度快,更多实用功能支持以插件形式进行动态扩展。 主要特性
[*]支持用户自定义输出方式(例如:终端、文件、数据库、串口、485、Flash...);
[*]日志内容可包含级别、时间戳、线程信息、进程信息等;
[*]日志输出被设计为线程安全的方式,并支持 异步输出 及 缓冲输出 模式;
[*]支持多种操作系统(RT-Thread、UCOS、Linux、Windows...),也支持裸机平台;
[*]日志支持 RAW格式 ;
[*]支持按 标签 、 级别 、 关键词 进行动态过滤;
[*]各级别日志支持不同颜色显示
[*]扩展性强,支持以插件形式扩展新功能。

本次更新版本号 V1.11.13,主要发布以下重要功能:

1、新增彩色日志
所有级别日志可独立设置颜色,错误信息更加明显,日志更加赏心悦目,进一步提升调试效率。详细使用方法,请参照说明文档(点击查看)。Linux Demo 里已经默认开启了此功能,大致效果如下,欢迎试用

点击查看 在 xshell 上显示彩色串口日志的配置方法

2、新增异步输出模式(非阻塞输出模式)
之前的版本默认为阻塞的同步输出模式,即用户线程输出日志时,日志必须完全输出到输出介质(串口、网络、文件等)上,输出过程才会退回。
这样会影响应用软件执行时间及执行效率。开启异步输出模式后,后台有专门的日志线程负责完成日志输出功能,应用程序输出日志时,底层只将日志拷贝至缓冲区后,随即退出日志输出方法。

异步输出默认使用 POSIX pthread 实现,对于 Windows 、Liunx 、RT-Thread 及其他支持 POSIX pthread 的用户,只需开启异步输出相关配置,即可开启此功能。
对于缺少 pthread 支持的平台,例如:ucos ,也可以参考 elog_async.c 中关于异步输出线程的实现方式,自己动手实现。
PS:LinuxDemo 中已开启 pthread 异步输出模式,RT-Thread Demo 已使用其线程相关 API 实现异步输出模式。

3、新增缓冲输出模式
开启缓冲输出模式后,如果缓冲区不满,用户线程在进行日志输出时,无需等待日志彻底输出完成,即可直接返回。
但当日志缓冲区满以后,将会占用当前用户线程,自动将缓冲区中的日志全部输出干净。
同时用户也可以在其他非用户线程,通过定时等机制使用 `void elog_flush(void)` 将缓冲区中的日志输出干净。


下载方式
最新版请关注 GitHub:https://github.com/armink/EasyLogger
本坛下载:





浪客剑心绯村 发表于 2016-11-14 20:23:45

占一楼,顶!!!

fraser 发表于 2016-11-14 20:55:18

占二楼,顶!!!

ndt2000 发表于 2016-11-14 21:21:42

占三楼,顶!!!

霸气侧漏 发表于 2016-11-14 21:33:32


占四楼,顶!!!

落叶知秋 发表于 2016-11-14 21:48:05

占五楼,恭喜楼主又升级了这个开源项目。

love_zjb 发表于 2016-11-14 21:51:05

显示颜色是怎么实现的?

honami520 发表于 2016-11-15 00:51:30

好牛逼的东西,这个在资源丰富的芯片下面,可以直接使用;

myxiaonia 发表于 2016-11-15 08:08:14

闪存库现在可以作为数据保存组件使用了吗,就是频繁的保存很多用户参数

security 发表于 2016-11-15 08:46:42

本帖最后由 security 于 2016-11-15 09:01 编辑

love_zjb 发表于 2016-11-14 21:51
显示颜色是怎么实现的?

我猜是基于 ANSI/VT100 之类的虚拟终端控制协议。
我自己的 logger 是这么实现的。

dreambox 发表于 2016-11-15 10:09:27

不错,谢谢楼主

gujiamao_love 发表于 2016-11-15 10:53:49

love_zjb 发表于 2016-11-14 21:51
显示颜色是怎么实现的?

你搜索下\033,我在putty下都是这么用的

sunnydragon 发表于 2016-11-15 20:29:06

love_zjb 发表于 2016-11-14 21:51
显示颜色是怎么实现的?

这个参照 ANSI 的一个标准,详见维基百科:https://en.wikipedia.org/wiki/ANSI_escape_code

sunnydragon 发表于 2016-11-15 20:31:15

honami520 发表于 2016-11-15 00:51
好牛逼的东西,这个在资源丰富的芯片下面,可以直接使用;

不用很丰富的资源,支持嵌入式操作系统的产品,支持这些功能会更加轻松。

sunnydragon 发表于 2016-11-15 20:33:29

myxiaonia 发表于 2016-11-15 08:08
闪存库现在可以作为数据保存组件使用了吗,就是频繁的保存很多用户参数

没太听明白你说的这个“数据保存组件”具体指的什么?

sunnydragon 发表于 2016-11-15 20:34:47

security 发表于 2016-11-15 08:46
我猜是基于 ANSI/VT100 之类的虚拟终端控制协议。
我自己的 logger 是这么实现的。 ...

是的,这个是 ANSI 的一个标准。

myxiaonia 发表于 2016-11-16 07:17:52

sunnydragon 发表于 2016-11-15 20:33
没太听明白你说的这个“数据保存组件”具体指的什么?

恩 恩 ,就是类似于把闪存当作eeprom来用

hanzo852 发表于 2016-11-16 08:44:19

编译失败
static const char *level_output_info[] = {
      = "A/",
         = "E/",
          = "W/",
          = "I/",
         = "D/",
       = "V/",
};
/* color output info */
static const char *color_output_info[] = {
      = ELOG_COLOR_ASSERT,
         = ELOG_COLOR_ERROR,
          = ELOG_COLOR_WARN,
          = ELOG_COLOR_INFO,
         = ELOG_COLOR_DEBUG,
       = ELOG_COLOR_VERBOSE,
};

///////////////
..\..\..\..\easylogger\src\elog.c(116): error:#29: expected an expression

security 发表于 2016-11-16 08:59:17

hanzo852 发表于 2016-11-16 08:44
编译失败
static const char *level_output_info[] = {
      = "A/",


这种问题,我猜原因:多数是没打开 C99 编译选项,
请打开对 C99 的支持,再试下。

小溪 发表于 2016-11-16 09:48:42

hanzo852 发表于 2016-11-16 08:44
编译失败
static const char *level_output_info[] = {
      = "A/",


打开工程options for target's stm32f103xE,在 Misc Control一栏空白处添加--c99,再重新编译一下

sunnydragon 发表于 2016-11-16 18:53:53

hanzo852 发表于 2016-11-16 08:44
编译失败
static const char *level_output_info[] = {
      = "A/",


刚刚在 GitHub 上更新了:https://github.com/armink/EasyLogger ,增强了对 Keil4 的兼容性。

默认用 keil5 打开编译是不会有问题,估计你是用的 keil4 吧。

Keil 5 有个 C99 单选框(如下图),但 Keil4 没有。所以 Keil4 需要在 Misc Controls 里增加: --C99 选项

sunnydragon 发表于 2016-11-16 18:56:52

myxiaonia 发表于 2016-11-16 07:17
恩 恩 ,就是类似于把闪存当作eeprom来用

那你可以使用 EasyFlash :https://github.com/armink/EasyFlash

然后参考文档(点击查看),开启 磨损(擦写)平衡模式 ,应该能满足你的需求。

myxiaonia 发表于 2016-11-16 22:43:03

sunnydragon 发表于 2016-11-16 18:56
那你可以使用 EasyFlash :https://github.com/armink/EasyFlash

然后参考文档(点击查看),开启 磨损 ...

我特意去看了你的easyflash中env的实现方法,每个env是作为整体进行操作的,当然擦写平衡后我估计会使用类似fat32文件系统的做法,就是扇区顺序使用,类似于环形队列一样,但是这应该是对一个个env之间的做法

对于大量数据集合的形式用现在的env不大合适,因为修改很可能是其中一个字节,也可能是几kb这样的,如果将这个大数据集合拆分为多个互不相干的env,某些操作比如清空同一组参数就需要操作n次,而数据集合中
这些数据都是连续存放的,一条语句就完成了,用一个env的话,修改一个自己也写一遍整个env又太奢侈

有没有可能只对修改部分保存,但是开机读取这个env时又能准备的恢复过来

myxiaonia 发表于 2016-11-16 22:49:55

我自己现在的做法,大数据集合动态保存的做法,每次修改则记录偏移地址和长度,然后写入到flash,当然各种校验机制和写入策略都是有考虑的

sunnydragon 发表于 2016-11-17 07:42:55

myxiaonia 发表于 2016-11-16 22:49
我自己现在的做法,大数据集合动态保存的做法,每次修改则记录偏移地址和长度,然后写入到flash,当然各种 ...

是的,EasyFlash 现有实现方式虽然简单,但是针对大数据支持资源占用会非常高,所以目前还不太适合这类场景。

最近一直业余时间一直在忙 EasyLogger 的开发,在 EasyFlash 的后续开发计划中,会新增一种轻量级模式,所有数据无需再开辟内存进行缓存,保存在 Flash 的数据会使用压缩算法进行压缩,Env 的名字不在采用字符串存储等等很多降低系统资源占用的处理,欢迎继续关注 EasyFlash 的进展哈~

weiwei4 发表于 2016-11-17 08:49:35

不错不错,好资源

sunnydragon 发表于 2016-11-20 21:03:32

weiwei4 发表于 2016-11-17 08:49
不错不错,好资源

{:handshake:}

jie5313 发表于 2016-11-20 21:32:14

非常有帮助,谢了。。。。。。。。

sunnydragon 发表于 2016-11-29 08:03:26

jie5313 发表于 2016-11-20 21:32
非常有帮助,谢了。。。。。。。。

{:handshake:}

kaomantou 发表于 2016-12-2 12:28:00

多谢分享~~~~~~~~~··

chxaitz 发表于 2016-12-2 14:15:26

非常好用,赞一个~

闲鱼翻身 发表于 2016-12-2 16:52:43

正好项目要用到,试试

johnny412 发表于 2016-12-2 19:05:04

下载看看,多谢分享!

sunnydragon 发表于 2016-12-7 09:31:24

chxaitz 发表于 2016-12-2 14:15
非常好用,赞一个~

{:handshake:} 多谢支持哈~

jackem 发表于 2016-12-25 23:32:28

这个帖子我继续再顶!

talkingbeast 发表于 2016-12-25 23:43:09

谢谢分享,高质量的资料。

miaoguoqiang 发表于 2017-1-22 15:09:31

Linux下怎么加到自己的进程中。需要把整个源码全部加入?

sunnydragon 发表于 2017-1-23 10:40:55

miaoguoqiang 发表于 2017-1-22 15:09
Linux下怎么加到自己的进程中。需要把整个源码全部加入?

是的,你可以先试一下 Linux 的 Demo

XLoveEE 发表于 2017-1-24 09:14:06

可以,关注下!

miaoguoqiang 发表于 2017-5-15 14:36:33

本帖最后由 miaoguoqiang 于 2017-5-15 14:38 编辑

没看到linux下对日志的分割处理,相对于log4c,觉得log4c使用起来比较便捷

cyberkit 发表于 2017-5-16 09:59:26

相当给力,赞!

STT 发表于 2017-5-19 10:43:29

标记一下 以后方便查找

游在云间 发表于 2017-8-14 05:33:55

可以移植到freertos中吗?

sunnydragon 发表于 2017-8-14 08:09:37

游在云间 发表于 2017-8-14 05:33
可以移植到freertos中吗?

当然可以。可以参考下其他 OS 的 Demo 。

Harlan 发表于 2017-11-11 14:26:12

非常好,方便故障跟踪

Baldwin 发表于 2019-4-2 16:00:52

请问在移植easyLogger时,keil5.17环境,编译时报错,是什么原因呢?
static const char *level_output_info[] = {
      = "A/",
         = "E/",
          = "W/",
          = "I/",
         = "D/",
       = "V/",
};

..\Module\easyflash\src\elog.c(118): error:#29: expected an expression

sunnydragon 发表于 2019-4-2 16:04:39

Baldwin 发表于 2019-4-2 16:00
请问在移植easyLogger时,keil5.17环境,编译时报错,是什么原因呢?
static const char *level_output_inf ...

keil 里开启 C99 支持就好了

Baldwin 发表于 2019-4-2 16:08:24

sunnydragon 发表于 2019-4-2 16:04
keil 里开启 C99 支持就好了

可以了,谢谢

Baldwin 发表于 2019-4-3 09:22:55

按照github上移植手册进行了移植,https://github.com/armink/EasyLogger/blob/master/docs/zh/port/flash.md
为什么elog_flash.c中还需要调用easyflash.c easyflash.h?能否介绍一下文件调用方式和移植,谢谢

蛋定 发表于 2019-4-3 15:07:27

好东西,标记下

BCE312 发表于 2019-12-5 19:00:08

厉害了!

huhandong 发表于 2019-12-5 22:47:56

好东西,收藏先

malaoshi 发表于 2019-12-9 13:51:31

好东西,做个记号。

hall 发表于 2020-4-30 10:47:23

简单移植了一下,效果挺好!还要请教楼主两个问题:
1.好像不支持打印很长的带换行的字符串?比如像下面图片这样的。按我理解需要把这个logo存到一个大数组里,再用easylogger打印,我试了一下只能打印一部分,也不会换行。
2.easylogger没有输入命令的功能吧?比如在SecureCRT里用键盘做交互。

sunnydragon 发表于 2020-4-30 20:48:36

hall 发表于 2020-4-30 10:47
简单移植了一下,效果挺好!还要请教楼主两个问题:
1.好像不支持打印很长的带换行的字符串?比如像下面图 ...

1、这种其实按行打印就好,每一行对应一个日志代码
2、elog 主要负责日志输出,命令输入,还是得依赖于其他组件

hall 发表于 2020-5-1 00:34:45

sunnydragon 发表于 2020-4-30 20:48
1、这种其实按行打印就好,每一行对应一个日志代码
2、elog 主要负责日志输出,命令输入,还是得依赖于其 ...

懂了,感谢作者回复!{:lol:} {:handshake:}

richards 发表于 2020-5-1 00:44:57

不错 不错

chinazhsj 发表于 2020-12-31 16:45:06

好东西啊,赶紧研究一下
页: [1]
查看完整版本: 【升级】C/C++ 日志库 EasyLogger 新增彩色日志、异步输出等