20-11版本AUTOSAR_PRS_LogAndTraceProtocol文档翻译

1简介和概述

本协议规范规定了AUTOSAR协议Dlt的格式、消息序列和语义。
该协议允许将诊断、日志和跟踪信息发送到通信总线上。
因此，Dlt模块从应用程序或其他软件模块收集调试信息，向调试信息添加元数据，并将其发送到通信总线。
此外，Dlt协议允许根据严重级别过滤调试信息，例如“致命”、“错误”或“信息”。此筛选器可以在运行时通过外部日志记录工具发送的Dlt控制消息进行修改。
还可以直接向应用程序通知新的过滤器级别，以仅生成调试信息，特别是针对该选定的严重性级别，在运行时将消息分配给另一个通信总线，或者将修改后的Dlt配置存储为非易失性配置（如果硬件支持的话）。
在这里插入图片描述
1.1目的
Dlt协议可在ECU开发阶段用于记录调试信息，并将其外部存储在记录设备上。
1.2协议的适用性
它旨在在ECU的开发阶段使用Dlt协议。假设使用外部日志记录和跟踪工具来存储ECU生成的调试信息。
如果需要，还需要此日志记录和跟踪工具来在运行时修改过滤器设置，或者持久存储ECU的当前Dlt配置。
1.2.1安全和安保注意事项
强烈建议在开发阶段结束后停用Dlt功能。特别是，在任何情况下都应禁用注入功能！
Dlt功能的激活和停用应使用安全机制进行。
1.2.2约束和假设
Dlt协议设计为“无连接”工作。这意味着使用Dlt协议不需要外部通信或其他刺激。
尽管不需要连接外部日志记录工具，但有一个可以存储和解释接收到的调试消息的日志记录工具是有意义的。该设备还可用于生成Dlt控制消息以影响ECU，如修改过滤器设置（即更改调试信息的严重性级别）。
1.2.3限制
应考虑通信总线的可用（免费）带宽，以免对常规通信产生太大影响。
1.4对应用层的依赖
为了传输Dlt消息，应用程序需要知道是使用详细模式还是非详细模式发送Dlt消息。
此外，应用程序可以提供获得关于过滤器设置更改的通知的可能性。为此，应用程序应在Dlt模块中进行自身注册。

2用例

本章描述了可以通过实现Dlt协议的ECU的环境来实现的用例。
尽管Dlt协议与总线无关，但建议使用具有更高带宽的通信总线，如以太网。尽管如此，它并不局限于此。
2.1.1使用Dlt的用例通用日志记录
在这里插入图片描述
（1）应用程序/SW-C正在向Dlt模块提供日志消息。
（2）日志消息由实现Dlt协议的Dlt模块过滤或创建Dlt消息。（取决于日志级别。）
（3）Dlt模块将Dlt消息发送到通信总线。
（4）外部客户端接收并存储Dlt消息。
2.1.3 Dlt的用例运行时配置
在这里插入图片描述
（1）外部客户端设置日志和跟踪级别，并将更改发送到实现Dlt协议的Dlt模块。
（2）通过Dlt控制消息，将改变发送到实现Dlt协议的Dlt模块。
（3） Dlt模块相应地调整其过滤器设置的配置。
（4） Dlt模块向应用程序通知新的日志级别。
2.1.4用例非详细模式
为了减少总线上的流量，可以避免在通信总线上发送有关变量的元数据。
相反，一个外部文件保存了应如何解释有效载荷的信息。外部Dlt客户端将这些元数据与接收到的参数值合并并存储。
在这里插入图片描述

（1）应用程序/SW-C正在向Dlt模块提供非详细的日志记录数据。
（2） Dlt模块过滤并生成Dlt消息。
（3） Dlt模块向通信总线发送Dlt消息。
（4）外部客户端从外部文件获取元信息。
（5）合并后的信息由外部客户端存储。

5协议规范

5.1消息格式
消息格式对于调试数据和控制信息，使用相同的DLT消息格式。
它由一个标准报头、一个可选的扩展报头和一个有效载荷段组成在这里插入图片描述
5.1.1 Standard Header

[PRS_Dlt_00458] ⌈The Dlt Standard Header shall consist of the following fields in the
following order:
 Byte 0: HTYP (Header Type)
 Byte 1: MCNT (Message Counter)
 Byte 2-3: LEN (Length)
 Byte 4-7: ECU (ECU ID)
 Byte 8-11: SEID (Session ID)
 Byte 12-15: TMSP (Timestamp)
⌋ (RS_LT_00002)
5.1.1.1 Header Type
5.1.1.1报头类型DLT报头类型(HTYP)包含有关DLT消息的一般信息。
[PRS_DLT_00094]⌈报头类型(HTYP)应包含以下信息并按以下方式编码：
 Bit 0: UEH (Use Extended Header)
 Bit 1: MSBF (Most Significant Byte First)
 Bit 2: WEID (With ECU ID)
 Bit 3: WSID (With Session ID)
 Bit 4: WTMS (With Timestamp)
 Bit 5-7: VERS (Version Number)
⌋ (RS_LT_00002)
在这里插入图片描述
[PRS_Dlt_00600] ⌈The Header Type (HTYP) shall be the first byte of any Dlt
message. ⌋ (RS_LT_00002)
[PRS_Dlt_00601] ⌈The size of the Header Type (HTYP) shall be 1 byte. ⌋
(RS_LT_00002)
[PRS_Dlt_00602] ⌈If the UEH bit is set to ‘0’, the extended header is not used. ⌋
(RS_LT_00002)
[PRS_Dlt_00603] ⌈If the UEH bit is set to ‘1’, the extended header is used. ⌋
(RS_LT_00002)
Note: If the verbose mode is needed, the UEH bit has to be set to 1.
[PRS_Dlt_00604] ⌈If the MSBF bit is set to ‘0’, the payload data is encoded in little
endian format. ⌋ (RS_LT_00002, RS_LT_00016)
[PRS_Dlt_00605] ⌈If the MSBF bit is set to ‘1’, the payload data is encoded in big
endian format. ⌋ (RS_LT_00002, RS_LT_00016)
[PRS_Dlt_00606] ⌈If the WEID bit is set to ‘0’, the ECU ID (ECU) field is not
contained in the Standard Header. ⌋ (RS_LT_00002, RS_LT_00022)
[PRS_Dlt_00607] ⌈If the WEID bit is set to ‘1’, the ECU ID (ECU) field is contained in
the Standard Header. ⌋ (RS_LT_00002, RS_LT_00022)
[PRS_Dlt_00608] ⌈If the WSID bit is set to ‘0’, the Session ID (SEID) field is not
contained in the Standard Header. ⌋ (RS_LT_00002)
5.1.1.2消息计数器
消息计数器对传输到选定日志通道的DLT消息进行计数。
每个日志通道都需要维护自己的消息计数器。
在接收方，可以评估消息计数器值，以识别丢失的消息达到某个级别。
[PRS_DLT_00319]⌈消息计数器是一个无符号8位(0-255)整数。
⌋(RS_LT_00018)[PRS_DLT_00613]⌈在DLT模块初始化后，消息计数器(MCNT)应设置为‘0’。
⌋(RS_LT_00018)[PRS_DLT_00105]⌈对于传输到分配的日志通道的每条DLT消息，消息计数器应递增1。⌋(RS_LT_00018)[PRS_DLT_00106]⌈如果消息计数器达到255，则计数器将在下一条要传输的日志和跟踪消息时取整并从值‘0’开始。⌋(RS_LT_00018)
5.1.3正文/有效载荷格式
DLT有效载荷跟随在DLT报头或DLT扩展报头之后(如果使用)。DLT有效负载包含记录或跟踪的参数，或者它包含控制信息。
[PRS_DLT_00314]⌈如果UEH(使用扩展报头)位设置为‘1’，则有效载荷应与DLT扩展报头相邻。⌋(RS_LT_00013，RS_LT_00023)[PRS_DLT_00315]⌈如果UEH(使用扩展报头)位设置为‘0’，则有效载荷应与DLT标准报头相邻。⌋(RS_LT_00013，RS_LT_00023)5.1.3.1非冗余模式下的有效负载为了能够仅传输参数值，而不需要关于参数值的任何元信息，可以使用非冗余模式的附加属性，如参数名称或类型。
为了允许正确地分解接收到的DLT消息内包含的参数值，将专用消息ID添加到有效负载。
一个单独的外部文件根据相应的消息ID包含对有效载荷布局的描述。
在这里插入图片描述
5.2报文类型
5.2.1数据报文
DLT数据报文按照5.1章《报文格式》中所述进行组装。
5.2.2控制消息
DLT控制消息主要用于修改DLT模块在运行时的行为。它们允许改变通信总线来发送DLT数据消息，修改过滤器级别，配置可以触发存储为非易失性。
5.3服务/命令
以下章节介绍已定义的DLT命令，包括唯一ID(服务ID)、格式和所需参数。
[PRS_DLT_00635]⌈应支持使用以下服务ID的下列dlt命令：
在这里插入图片描述