AUTOSAR_SWS_LogAndTrace文档中文翻译

1 Introduction and functional overview

本规范规定了AUTOSAR自适应平台日志和跟踪的功能。
日志和跟踪为AA提供接口，以便将日志信息转发到通信总线、控制台或文件系统。
提供的每个日志记录信息都有自己的严重性级别。对于每个严重级别，都提供了一个单独的方法供应用程序或自适应平台服务使用，例如ara::com。此外，提供了将十进制值转换为十六进制数字系统或二进制数字系统的实用方法。
为了将提供的日志记录信息打包成标准化的交付和表示格式，需要一个协议。为此，可以使用在AUTOSAR联盟内标准化的LT协议。
LT协议可以将附加信息添加到所提供的日志记录信息中。日志客户端可以使用这些信息来关联、排序或过滤接收到的日志帧。
关于用例和LT协议本身的详细信息由PRS日志和跟踪协议规范提供。有关LT协议的更多信息，请参阅[1]

此外，本文件还介绍了AUTOSAR自适应平台日志和跟踪。此外，本文档还介绍了对AUTOSAR自适应台日志和跟踪的附加规范扩展
**

2 Acronyms and Abbreviations

**

3 Input documents & related standards and norms 输入文件及相关标准规范

[1] Log and Trace Protocol Specification
AUTOSAR_PRS_LogAndTraceProtocol
[2] Glossary
AUTOSAR_TR_Glossary
[3] Specification of Manifest
AUTOSAR_TPS_ManifestSpecification
[4] Specification of the Adaptive Core
AUTOSAR_SWS_AdaptiveCore
[5] Requirements on Log and Trace
AUTOSAR_RS_LogAndTrace
[6] Specification of Time Synchronization for Adaptive Platform
AUTOSAR_SWS_TimeSync

3.2他适用规范

AUTOSAR提供了一个核心规范[4，SWS AdaptiveCore]，该规范也适用于日志和跟踪。本规范的“所有FC的一般要求”一章应被视为实施日志和跟踪的附加和必要规范。

4限制和假设

4.1已知限制
所提供的日志记录框架API设计为独立于底层日志记录后端实现，因此不施加限制。
4.2适用于汽车领域
无适用性限制

5对其他FC的依赖性

对其他FC没有依赖性。
5.1平台依赖性
本规范是AUTOSAR AUTOSAR自适应平台的一部分，因此依赖于它

6需求跟踪

下表引用了RS日志和跟踪[5]中指定的需求，并链接到这些需求的实现。请注意，如果特定要求的“满足者”栏为空，则表示本文件未满足此要求。

7功能规范本规范

定义了为日志和跟踪定义的C++日志API的使用。AA可以使用这些功能将日志消息转发到各种接收器，例如网络、串行总线、控制台或文件系统。
提供了以下功能：
1）初始化日志框架的方法（见7.3）
2）将十进制值转换为十六进制或二进制值的实用方法（见7.4）3）日志消息的自动时间戳（见7.5）
4）日志和跟踪网络带宽限制（见第7.6章）
AA和FC可以启动（见7.1.1）和关闭（见7.1.2）通过调用ARA::core::Initialize()或ARA::core::Deinitialize()，具有直接ARA接口的所有FC（例如，日志框架）

7.1功能集群生命周期

7.1.1启动
为了初始化日志框架，需要向日志框架提供强制性信息。这些信息是从应用程序执行清单和AUTOSAR元模型中提取的。执行清单参数Executable.loggingBehavior定义是否应初始化日志记录功能。在使用任何ara::log API之前，必须初始化日志记录框架（通过ara::core::Initialize）。否则将导致未定义的行为。
[SWS_LOG_00001]在日志框架能够处理之前记录的Log消息࿰