开源代码DLT日志调试过程（linux环境下调试）

一、整体架构

DLT Daemon是一个后台服务程序；DLT Library是用户使用DLT时需要连接的动态库；DLT Client是上位机程序，用于展示日志，比如DLT viewer程序。这三个组件之间的连接方式如下图

 

 二、优缺点

优点：

1、本地存储可以指定缓存多少字节后写磁盘

2、可以动态修改保存的日志等级

3、可以修改dlt.conf来控制是否打印到console

4、可以电脑端用dl-viewer来实时抓取日志并保存

5、性能比较稳定

缺点：

暂时未发现

三、使用说明（ubuntu中调试）

3.1 代码下载与编译过程

获取dlt-daemon源码

git clone https://github.com/GENIVI/dlt-daemon.git

cd dlt-daemon

mkdir build

cd build

apt-get update

apt-get install –y build-essential

cmake ..

make

make install

ldconfig

dlt-daemon编译安装就完成了

注释：在/dlt-daemon/build/src/lib下生成libdlt.so.2.18.8,libdlt.so.2和libdlt.so是软链接文件，如果要适应其他平台，只要交叉编译就好。生成的dlt-daemon在/dlt-daemon/build/src/daemon下

获取dlt-viewer工具

git clone https://github.com/GENIVI/dlt-viewer.git

mkdir build

cd build

apt-get install ros-melodic-qt-create

apt-get install ros-melodic-qt-build

apt-get install libqt5serialport5-dev libudev-dev

cmake ..

make

这时，build/bin目录下就生成了可执行文件dlt-viewer

3.2 构造测试进程

日志等级如下：

example.c内容如下：

#include

#include

DLT_DECLARE_CONTEXT(myContext1);

DLT_DECLARE_CONTEXT(myContext2);

DLT_DECLARE_CONTEXT(myContext3);

int main()

{

        DLT_REGISTER_APP(“MAPP”,”Application for Logging”);

        DLT_REGISTER_CONTEXT(myContext1,”ai”,”Test1 1 for log”);

        DLT_REGISTER_CONTEXT(myContext2,”chen”,”Test2 2 for log”);

DLT_REGISTER_CONTEXT(myContext3,”bo”,”Test3 3 for log”);

    DLT_SET_APPLICATION_LL_TS_LIMIT(DLT_LOG_VERBOSE,DLT_TRACE_STATUS_ON);

        For (int i = 0; i < 2; i++)

{

  DLT_LOG(myContext3,DLT_LOG_FATAL,DLT_STRING(“11111 This is a fatal”),DLT_INT(i));

DLT_LOG(myContext2,DLT_LOG_ERROR,DLT_STRING(“22222 This is a ERROR”),DLT_INT(i));

DLT_LOG(myContext3,DLT_LOG_WARN,DLT_STRING(“3333 This is a WARN”),DLT_INT(i));

DLT_LOG(myContext1,DLT_LOG_INFO,DLT_STRING(“4444 This is a INFO”),DLT_INT(i));

DLT_LOG(myContext3,DLT_LOG_DEBUG,DLT_STRING(“5555 This is a debug”),DLT_INT(i));

DLT_LOG(myContext3,DLT_LOG_VERBOSE,DLT_STRING(“6 This is a VERBOSE”),DLT_INT(i));

}

sleep(3);

DLT_UNREGISTER_CONTEXT(myContext1);

DLT_UNREGISTER_CONTEXT(myContext2);

DLT_UNREGISTER_CONTEXT(myContext3);

DLT_UNREGISTER_APP();

Return 0;

}

说明：1、通过ECU ID来区分模块，比如SOC、NAD

      2、先要注册APP，类似于指定进程名字，比如PM

      3、再注册CONTEXT，一个APP下可以有多个CONTEXT，这个相当于进程中的应用划分，比如receive

      4、如果不使用了，调用解除注册

3.3 本地日志存储

查看/dlt-daemon/doc/dlt_offline_logstorage.md说明文档，进行以下操作：

cd dlt-daemon/src/daemon

cp dlt.conf /etc

vi /etc/dlt.conf

修改dlt.conf:

然后再在offlineLogstorageDirPath路径下创建本地log规则文件:dlt_logstorage.conf

在文件中写入过滤规则：

[Filter]           #筛选配置名称

LogAppName=             #要存储的应用程序的名称。多个应用程序可以用”,”分隔，”*”表示所有应用程序

ContextName=             #应用程序下的上下文名称

LogLevel=              #日志等级

File=                  #生成日志的文件名

FileSize=          #文件存储的最大字节数

NOFiles=          #最大文件数

SyncBehavior=           #日志同步策略，默认值：在每条消息之后同步。可以设置达到多少字节后同步

EcuID=                   #指定ECU标识

SpecificSize=     #达到特定大小后在存储设备中存储日志

注：其中”SyncBehavior”、”EcuID”和”SpecificSize”是可选的，其他的都是必选。

再启动dlt-daemon –c /etc/dlt.conf –d，这样就可以让dlt针对LOG这个app中以TEST为名的log(log等级大于DLT_LOG_WARN)都保存在/opt/test下的dlt文件中

运行测试进程，结果如下：

根据测试，总结如下：

1. 根据dlt_logstorage.conf日志来过滤内容
2. 当文件数达到最大个数时且文件内容达到最大限制，删除一个最旧的文件，创建一个新的文件

3.4 PC端日志抓取与存储

1. 使用的虚拟机跑的ubuntu，该测试使用VMnet1(仅主机模式)
2. 电脑端打开dlt-viewer.exe软件

 

默认dlt-damon的tcp端口默认值是3490

在ubuntu中执行命令，dlt-daemon -c /etc/dlt.conf –d

3.5 前期调试日志输出到console

1. dlt-daemon -c /etc/dlt.conf  /*注：不要在后台运行*/
2. 修改/etc/dlt.conf内容，修改如下内容

 

 运行测试程序，输出如下：

 3.6 日志等级动态调整

 查看AUTOSAR_SWS_DiagnosticLogAndTrace.pdf中存在修改日志等级的API Dlt_SetLogLevel,但是该开源代码中未有相关函数，经过查看，有控制设置整个模块日志等级的DLT_SET_APPLICATION_LL_TS_LIMIT函数，构造测试程序：

example.c内容如下：

#include

#include

#include

DLT_DECLARE_CONTEXT(myContext1);

DLT_DECLARE_CONTEXT(myContext2);

DLT_DECLARE_CONTEXT(myContext3);

int main()

{

        DLT_REGISTER_APP(“MAPP”,”Application for Logging”);

        DLT_REGISTER_CONTEXT(myContext1,”ai”,”Test1 1 for log”);

        DLT_REGISTER_CONTEXT(myContext2,”chen”,”Test2 2 for log”);

DLT_REGISTER_CONTEXT(myContext3,”bo”,”Test3 3 for log”);

    DLT_SET_APPLICATION_LL_TS_LIMIT(DLT_LOG_VERBOSE,DLT_TRACE_STATUS_ON);

        For (int i = 0; i < 10; i++)

{

  if (0 == access(“/tmp/testfile”,F_OK))

  {

     printf(“file is exist\n”);

     DLT_SET_APPLICATION_LL_TS_LIMIT(DLT_LOG_ERROR,DLT_TRACE_STATUS_ON);

  }

  else

  {

      printf(“file is not exist\n”);

}

 

  DLT_LOG(myContext3,DLT_LOG_FATAL,DLT_STRING(“11111 This is a fatal”),DLT_INT(i));

DLT_LOG(myContext2,DLT_LOG_ERROR,DLT_STRING(“22222 This is a ERROR”),DLT_INT(i));

DLT_LOG(myContext3,DLT_LOG_WARN,DLT_STRING(“3333 This is a WARN”),DLT_INT(i));

DLT_LOG(myContext1,DLT_LOG_INFO,DLT_STRING(“4444 This is a INFO”),DLT_INT(i));

DLT_LOG(myContext3,DLT_LOG_DEBUG,DLT_STRING(“5555 This is a debug”),DLT_INT(i));

DLT_LOG(myContext3,DLT_LOG_VERBOSE,DLT_STRING(“6 This is a VERBOSE”),DLT_INT(i));

sleep(10);

}

sleep(3);

DLT_UNREGISTER_CONTEXT(myContext1);

DLT_UNREGISTER_CONTEXT(myContext2);

DLT_UNREGISTER_CONTEXT(myContext3);

DLT_UNREGISTER_APP();

Return 0;

}

运行程序，在输入命令touch /tmp/ testfile,查看dlt-viewer抓取的内容如下：

可以实现动态修改

 注：这是一次性，永久修改等级，需要调整文件

3.7 网关功能

 说明：

 如果存在多个passive Mode（即多个模块，比如SOC、NAD、MCU都使用），那么需要配置一个网关，把这些模块的日志统一由网关输出，dlt viewer直接连接网关即可收集这些模块的日志。

配置：

使用两个虚拟机（仅主机模式VMnet1）

虚拟机1的IP为192.168.94.131，将dlt.conf中ECUId=1,这里不开启网关功能

虚拟机2的IP为192.168.94.132，将dlt.conf中ECUId=8，将Gateway Configuration内容打开，开启网关功能，内容如下：

 在虚拟机2中/etc下创建dlt_gateway.conf

 [PassiveNode ]           #模块标识，比如SOC

IPaddress                               #必须字段 模块的IP

Port                                   #为其端口号，默认端口号是3490

EcuID                                  #必须字段 是该模块的ECUID，在dlt.conf中配置

Connect                                #网关端连接模块节点的方式

Timeout                                #网关与模块建立连接的超时时间（配置为0为无休止连接）

SendControl                             #网关端与模块端建立后发给模块端的消息

                                                                DLT_SERVICE_ID_GET_LOG_INFO               0x03

                            DLT_SERVICE_ID_GET_DEFAULT_LOG_LEVEL           0x04

                           DLT_SERVICE_ID_GET_SOFTWARE_VERSION            0x13

SendSerialHeader                         #控制消息带串行头

SendPeriodicControl                       #定期发送下面的控制信息

                                        格式：control:interval[in seconds]

注：参考dlt_gateway.conf.5.md文档

验证过程：
1、启动虚拟机1中dlt-daemon:

dlt-daemon –c /etc/dlt.conf -d

2、启动虚拟机2网关端的dlt-daemon：

dlt-daemon –c /etc/dlt.conf -d

3、启动windows上的DLT Viewer软件

Hostname使用虚拟机2（网关端）的主机名

4、在虚拟机1中执行测试程序，发送dlt日志

 Dlt-viewer目前连接的是ECU8（网关端），但却打印ECU1的日志，证明网关功能已经成功

3.8 Verbose与Non-Verbose模式

介绍：

程序默认使用Verbose模式，如果需要使用Non-Verbose模式，那么日志打印前需要调用

DLT_NONVERBOSE_MODE()来切换;

注：参考dlt_for_developers.md  ### Logging command

验证过程：

Non-Verbose模式验证，测试代码如下：

DLT_NONVERBOSE_MODE();

DLT_LOG_ID(myContext3,DLT_LOG_FATAL,42,DLT_STRING(“00000 this is a fatal”),DLT_UNIT8(18));

生成的日志大小为71字节

 Verbose模式验证，测试代码如下：

DLT_VERBOSE_MODE();

DLT_LOG(myContext3,DLT_LOG_FATAL,DLT_STRING(“00000 this is a fatal”),DLT_UNIT8(18));

生成的日志大小为75字节

 经过多组测试发现Non-Verbose模式的日志比Verbose节省空间

日志内容：

使用dlt-viewer查看，相同的一条日志，verbose模式非常直观，non-verbose打印的内容不直观（需要生成插件）

3.9 DLT Injection功能

介绍：

默认情况下是允许Injection(配置在dlt.conf的InjectionMode）

注：参考dlt_for_developers.md ## DLT Injection Messages

验证过程：

1、启dlt-daemon程序

dlt-daemon –c /etc/dlt.conf

2、启一个测试程序一直跑在那（appId:MAPP ContextId:ai）

3、启动DLT-Viewer

 

可以看出injection成功

 3.10 syslog适配器

1、apt install libsystemd-dev 命令安装 libsystemd-dev 包

2、CMakeLists.txt 的64行将WITH_DLT_SYSTEM置为ON,重新编译dlt-daemon

3、将dlt-system.conf拷入/etc下，内容如下：

 

4、/etc/rsyslog.d/50-default.conf下增加*.*    @localhost:47111

sudo systemctl restart rsyslog.service

5、运行dlt-daemon、dlt-system

dlt-daemon –c /etc/dlt.conf -d

dlt-system –c /etc/dlt-system.conf –d

6、运行测试程序

7、查看结果

 

 3.11 Systemd Journal适应器

1、CMakeLists.txt 的50行将WITH_DLT_JOURNAL置为ON, 重新编译dlt-daemon

2、修改/etc下的dlt-system.conf，如下

3、运行dlt-daemon、dlt-system

dlt-daemon –c /etc/dlt.conf -d

dlt-system –c /etc/dlt-system.conf –d

4、运行测试程序

5、查看结果