DLT产品参考手册

缩写词注解

缩写词

英文全称

中文解释

API

Application Programming Interface

应用编程接口

DLT

Diagnostic Log and Trace

诊断日志与跟踪

DET

Default Error Tracer

默认错误跟踪

APID

Application ID

应用标识符

CTID

Context ID

上下文标识符

MCNT

Message Counter

消息计数器

MSBF

Most Significant Byte First

最有效字节优先

MSBI

Message Bus Info

消息总线信息

MSCI

Message Control Info

消息控制信息

MSLI

Message Log Info

消息日志信息

MSTP

Message Type

消息类型

MSTI

Message Trace Info

消息跟踪信息

NOAR

Number of Arguments

参数个数

STMS

Timestamp

时间戳

UEH

Use Extended Header

使用扩展消息头

VERB

Verbose

冗余

VERS

Version Number

版本编号

WEID

With ECU ID

携带ECU标识符

WSID

With Session ID

携带会话标识符

WTMS

With Timestamp

携带时间戳

简介

image1

图1-1 AUTOSAR软件架构图

本文档是AUTOSAR架构中诊断日志与跟踪 DLT模块的用户参考手册。旨在指导使用DLT模块的用户能够清晰地了解诊断日志与跟踪的功能，以及如何去配置和使用DLT模块。

DLT模块为使用者提供了通用的日志和跟踪记录消息功能。本参考文档的主要重点如何将指定格式数据或本地缓冲数据通过通信接口发往网络总线。

AUTOSAR日志与跟踪诊断协议栈处于BSW基础软件层，包括DLT、DET等系统服务。如图1-1所示，橙色区域标注的所有模块都归属于AUTOSAR软件架构中日志与跟踪诊断协议栈的管理范畴，基础软件层还提供系统服务，网络通信服务，I/O服务以及复杂设备驱动。

参考资料

[1] AUTOSAR_SRS_DiagnosticLogAndTrace.pdf

[2] AUTOSAR_PRS_LogAndTraceProtocol.pdf

[3] AUTOSAR_SWS_DiagnosticLogAndTrace.pdf

[4] AUTOSAR_SWS_DefaultErrorTracer.pdf

功能描述

DLT功能

DLT功能介绍

描述AUTOSAR软件架构中的基础软件模块DLT的功能设计和配置说明；它可以收集来自DET和DLT使用者的日志与跟踪信息；DLT模块通过通信总线转发诊断日志与跟踪消息，使这些信息可以在ECU外部可见；为此，DLT模块定义了在总线上发送和接收专用日志/跟踪信息的API；此外，可以选择使用NvM模块持久地存储DLT模块的更新过滤设置。这使ECU能够以所需的级别发送日志/跟踪信息，而不需要每次在ECU启动时通过外部客户端工具在通信总线上发出显式设置请求。

image2

图2-1 模块间交互关系

DLT功能实现

image3

图2‑2 基于AUTOSAR的DLT软件架构

如图所示展示了AUTOSAR诊断日志与跟踪消息记录DLT模块的软件分层架构。可以看到DLT模块处于BSW基础软件的系统服务层，与DET模块处于并列关系，并且当DET模块检测到错误信息时会通过API接口向DLT模块进行汇报；DLT模块也可以将收集到的标准格式的诊断日志与跟踪消息封装成特定格式的Pdu数据，然后转发给通信协议栈的PduR模块，选择一种通信协议将组装好的Pdu数据发送到网络总线上，由外部客户端的上位机软件对网络总线上的诊断日志与跟踪消息进行录取；通信协议栈可以接收来自外部客户端的DLT控制命令消息，由PduR模块从网络总线上获取Pdu数据，然后PduR模块将解析好的数据提交给DLT模块，由DLT模块提取出控制命令消息并根据DLT命令字来设置相应的DLT用户中的配置信息。

DLT组件交互

image4

图2-3 DLT在AUTOSAR分层架构中的位置

DLT模块应该提供以下功能：

  • 日志信息记录

    • 记录来自AUTOSAR软架构中应用程序组件DLT用户的错误、警告和信息等消息，并提供一个标准化的AUTOSAR接口；在BSW的一个系统集中子服务组件(DLT)中收集来自所有AUTOSAR软件架构中DLT用户的所有日志和跟踪消息；来自DET模块的日志消息。

  • 跟踪信息记录

    • 实现用于跟踪软件组件变量、函数调用，函数返回，状态机的状态等事件的实时更新情况。

  • 控制命令请求与响应

    • 使能/禁止每个通道的日志与跟踪消息，并通过反馈控制每一个通道的日志级别与跟踪状态。

DLT控制命令集

表3-1 DLT控制命令集描述

服务 标识符

DLT命令名称

命令详细描述

是否 支持

0x00

NotSupported

不支持命令

×

0x01

SetLogLevel

设置日志级别

√

0x02

SetTraceStatus

设置跟踪状态

√

0x03

GetLogInfo

获取已注册的日志信息

√

0x04

GetDefautlogLevel

获取默认日志级别

√

0x05

StoreConfiguration

存储当前配置信息到NvM

√

0x06

Re setToFactoryDefault

将配置信息恢复到默认值

√

0x07

Se tComInterfaceStatus

设置通信接口的状态

×

0x08

S etComIfMaxBandwidth

设置通信接口的最大带宽

×

0x09

SetVerboseMode

设置冗余模式

×

0x0A

SetMessageFiltering

设置DLT消息过滤状态

√

0x0B

Reversed

预留

×

0x0C

GetLocalTime

获取本地时间

×

0x0D

SetUseECUID

设置用户ECU标识符

×

0x0E

SetUseSessionID

设置用户会话标识符

×

0x0F

SetUseTimestamp

设置用户时间错

×

0x10

S etUseExtendedHeader

设置用户扩展头

×

0x11

SetDefaultLogLevel

设置默认日志级别

√

0x12

Se tDefaultTraceStatus

使能/禁止默认跟踪状态

√

0x13

GetSoftwareVersion

获取软件版本信息

×

0x14

Me ssageBufferOverflow

消息缓冲区溢出通知

×

0x15

Ge tDefaultTraceStatus

获取默认跟踪状态

√

0x16

Get ComInterfacelStatus

获取通信接口状态

×

0x17

GetLogChannelNames

获取日志通道的名称

√

0x18

G etComIfMaxBandwidth

获取通信接口的最大带宽

×

0x19

G etVerboseModeStatus

获取冗余模式状态

×

0x1A

GetMes sageFilteringStatus

获取DLT消息过滤状态

×

0x1B

GetUseECUID

获取用户ECU标识符

×

0x1C

GetUseSessionID

获取用户会话标识符

×

0x1D

GetUseTimestamp

获取用户时间戳

×

0x1E

G etUseExtendedHeader

获取用户扩展头

×

0x1F

GetTraceStatus

获取当前跟踪状态

√

0x20

SetL ogChannelAssignment

设置 给定日志通道的映射路径

√

0x21

Set LogChannelThreshold

设置 给定日志通道的过滤阈值

√

0x22

Get LogChannelThreshold

获取 给定日志通道的过滤阈值

√

0x23

BufferO verflowNotification

DLT缓冲区溢出的指示通知

√

0x24

SyncTimeStamp

同步时间戳的指示

√

DLT模块注册或注销ApplicationID和ContextId

DLT模块能够通知日志级别的变化，DLT模块只有注册相应的ApplicationId / ContextId，才能在运行时使用ApplicationId/ContextId的元组，并存储到本地进行全局管理。如果参数DltGeneralRegisterContextNotification设置为TRUE，那么每次调用Dlt_RegisterContext时，Dlt模块将发送包含所提供的ApplicationId / ContextId的DLT消息。

DLT模块可以从已注册的用户列表中删除所有软件组件对应元组的应用程序ApplicationId和上下文ContextId标识符。

如果参数DltGeneralRegisterContextNotification设置为TRUE，那么每次调用Dlt_UnregisterContext时，Dlt模块都将发送包含所提供的ApplicationId / ContextId的DLT消息。

DLT日志与跟踪消息发送

Dlt消息发送路径描述Dlt日志和跟踪消息从源到接收的流程。源可以是DLT用户，而PDU路由通信栈表示接收端。

在调用Dlt_SendLogMessage或Dlt_SendTraceMessage的上下文中，如图所示描述用于描述在通信总线上发送Dlt消息的各个步骤。

  • 产生时间戳

  • 设置消息过滤

  • 选择目标日志通道

  • 检查消息长度

  • 根据日志通道阈值过滤消息

  • 拷贝Dlt 消息到指定日志通道的目标缓冲区

image5

图2-4 DLT日志与跟踪消息发送路径流程

源文件描述

表3-1 DLT组件文件描述

文件

说明

Dlt_Cfg.h

定义DLT模块预编译时用到的配置参数。

Dlt_Cfg.c

定义DLT模块中连接时用到的配置参数。

Dlt.h

DLT模块头文 件，包含了API函数的扩展声明并定义了端口的数据结构。

Dlt.c

DLT模块源文件，包含了API函数的实现。

Dlt_Cbk.c

用于实现Dlt模块供PduR调用的回调函数接口

Dlt_Cbk.h

用于声明Dlt模块供PduR调用的回调函数接口

Dlt_internal.h

Dlt模块内部接口的引用声明定义

Dlt_Types.h

Dlt模块类型定义头文件

Rte_Dlt_Type.h

Dlt模块与RTE模块交互的类型定义头文件

Dlt_MemMap.h

包含Dlt模块的内存抽象

image6

图3-1 DLT组件文件交互关系图

Dlt模块的文件结构如图所示。Dlt功能模块由10个文件组成，其中Dlt.c，Dlt.h两个文件中实现了Dlt的主要功能 ，这两个文件是每个Dlt模块必须实现的。

API接口

类型定义

Dlt_MessageTraceType类型定义

名称

Dlt_MessageTraceType

类型

Enumeration

范围

DLT_TRACE_VARIABLE = 1U

DLT_TRACE_FUNCTION_IN = 2U

DLT_TRACE_FUNCTION_OUT = 3U

DLT_TRACE_STATE = 4U

DLT_TRACE_VFB = 5U

描述

用于定义Dlt模块跟踪消息的枚举类型

Dlt_ExtHeadMsgInfoType类型定义

名称

Dlt_ExtHeadMsgInfoType

类型

Enumeration

范围

DLT_TYPE_LOG = 0U

DLT_TYPE_APP_TRACE = 1U

DLT_TYPE_NW_TRACE = 2U

DLT_TYPE_CONTROL = 3U

描述

用于定义Dlt模块的消息信息的枚举类型

Dlt_MessageNetworkType类型定义

名称

Dlt_MessageNetworkType

类型

Enumeration

范围

DLT_NW_TRACE_IPC = 1U

DLT_NW_TRACE_CAN = 2U

DLT_NW_TRACE_FLEXRAY = 3U

DLT_NW_TRACE_MOST = 4U

DLT_NW_TRACE_ETHERNET = 5U

DLT_NW_TRACE_SOMEIP = 6U

描述

用于定义Dlt模块的跟踪消息的枚举类型

Dlt_MessageControlType类型定义

名称

Dlt_MessageControlType

类型

Enumeration

范围

DLT_CONTROL_REQUEST = 1U

DLT_CONTROL_RESPONSE = 2U

描述

用于定义Dlt模块的控制消息的枚举类型

Dlt_FilterInfoType类型定义

名称

Dlt_FilterInfoType

类型

structure

定义

typedef struct

{

Dlt_MessageTypeType message_type;

Dlt_SessionIDType session_id;

Dlt_MessageLogInfoType log_info;

Dlt_MessageTraceInfoType trace_info;

} Dlt_FilterInfoType;

范围

无

描述

用于定义Dlt模块的过滤信息的结构体类型

Dlt_RunTimeType类型定义

名称

Dlt_RunTimeType

类型

structure

定义

typedef struct

{

boolean MessageFilterEnable;

boolean MessageFilterPass;

Dlt_MessageLogLevelType DefaultLogLevel;

boolean DefaultTraceStatus;

Dlt_SwcInfoType SwcInfo[DLT_SWC_NUM];

Dlt_ChannelInfoType ChannelInfo[DLT_CHANNEL_NUM];

} Dlt_RunTimeType;

范围

无

描述

用于描述Dlt模块的运行状态

Dlt_HeaderType类型定义

名称

Dlt_HeaderType

类型

union

定义

typedef union

{

uint8 AllBits;

struct

{

uint8 UseExtendedHeader : 1;

uint8 MostSignificantByteFirst : 1;

uint8 WithEcuId : 1;

uint8 WithSessionId : 1;

uint8 WithTimestamp : 1;

uint8 VersionNumber : 3;

} Dlt_Bits;

} Dlt_HeaderType;

范围

无

描述

用于定义Dlt模块的消息报文头信息的联合体类型

Dlt_DataTypeInfoType类型定义

名称

Dlt_DataTypeInfoType

类型

union

定义

typedef union

{

uint32 AllBits;

struct

{

uint32 Type_Length : 4;

uint32 Type_Bool : 1;

uint32 Type_Signed : 1;

uint32 Type_Unsigned : 1;

uint32 Type_Float : 1;

uint32 Type_Array : 1;

uint32 Type_String : 1;

uint32 Type_Raw : 1;

uint32 Variable_Info : 1;

uint32 Fixed_Point : 1;

uint32 Trace_Info : 1;

uint32 Type_Struct : 1;

uint32 String_Coding : 3;

uint32 Reserved : 14;

} Dlt_Bits;

} Dlt_DataTypeInfoType;

范围

无

描述

用于定义Dlt模块的负载数据信息的联合体类型

Dlt_MessageFormatType类型定义

名称

Dlt_MessageFormatType

类型

structure

定义

typedef struct

{

Dlt_DataTypeInfoType Type_Info;

const uint8 *Data_Payload;

} Dlt_MessageFormatType;

范围

无

描述

用于定义Dlt模块的消息格式的结构体类型

Dlt_StandardHeaderType类型定义

名称

Dlt_StandardHeaderType

类型

structure

定义

typedef struct

{

Dlt_HeaderType Header;

uint8 MessageCounter;

uint16 Length;

uint32 Ecu_Id;

Dlt_SessionIDType Session_Id;

uint32 Timestamp;

} Dlt_StandardHeaderType;

范围

无

描述

用于定义Dlt模块的标准消息头格式的结构体类型

Dlt_MessageInfoType类型定义

名称

Dlt_MessageInfoType

类型

union

定义

typedef union

{

uint8 AllBits;

struct

{

uint8 Verbose_Mode : 1;

uint8 MessageType : 3;

uint8 MessageTypeInfo : 4;

} Dlt_Bits;

} Dlt_MessageInfoType;

范围

无

描述

用于定义Dlt模块的消息信息格式的联合体类型

Dlt_ExtendedHeaderType类型定义

名称

Dlt_ExtendedHeaderType

类型

structure

定义

typedef struct

{

Dlt_MessageInfoType MessageInfo;

uint8 NumberOfArguments;

Dlt_ApplicationIDType ApplicationId;

Dlt_ContextIDType ContextId;

} Dlt_ExtendedHeaderType;

范围

无

描述

用于定义Dlt模块的扩展消息头格式的结构体类型

Dlt_NonVerboseLogMessageType类型定义

名称

Dlt_NonVerboseLogMessageType

类型

structure

定义

typedef struct

{

Dlt_StandardHeaderType Standard_Header;

Dlt_ExtendedHeaderType Extended_Header;

Dlt_MessageIDType Message_Id;

const uint8 *logData;

} Dlt_NonVerboseLogMessageType;

范围

无

描述

用于定义Dlt模块的非冗余模式日志消息的结构体类型

Dlt_VerboseLogMessageType类型定义

名称

Dlt_VerboseLogMessageType

类型

structure

定义

typedef struct

{

Dlt_StandardHeaderType Standard_Header;

Dlt_ExtendedHeaderType Extended_Header;

Dlt_MessageFormatType Log_Data[10];

} Dlt_VerboseLogMessageType;

范围

无

描述

用于定义Dlt模块的冗余模式日志消息的结构体类型

Dlt_NonVerboseTraceMessageType类型定义

名称

Dlt_NonVerboseTraceMessageType

类型

structure

定义

typedef struct

{

Dlt_StandardHeaderType Standard_Header;

Dlt_ExtendedHeaderType Extended_Header;

Dlt_MessageIDType Message_Id;

const uint8 *traceData;

} Dlt_NonVerboseTraceMessageType;

范围

无

描述

用于定义Dlt模块的非冗余模式跟踪消息的结构体类型

Dlt_VerboseTraceMessageType类型定义

名称

Dlt_VerboseTraceMessageType

类型

structure

定义

typedef struct

{

Dlt_StandardHeaderType Standard_Header;

Dlt_ExtendedHeaderType Extended_Header;

Dlt_MessageFormatType Trace_Data[10];

} Dlt_VerboseTraceMessageType;

范围

无

描述

用于定义Dlt模块的冗余模式跟踪消息的结构体类型

Dlt_NonVerboseDetLogMsgType类型定义

名称

Dlt_NonVerboseDetLogMsgType

类型

structure

定义

typedef struct

{

Dlt_StandardHeaderType Standard_Header;

Dlt_ExtendedHeaderType Extended_Header;

Dlt_MessageIDType Message_Id;

uint16 Module_Id;

uint8 Instance_Id;

uint8 App_Id;

uint8 Error_Id;

} Dlt_NonVerboseDetLogMsgType;

范围

无

描述

用于定义Dlt模块的非冗余模式Det日志消息的结构体类型

Dlt_VerboseDetLogMsgType类型定义

名称

Dlt_VerboseDetLogMsgType

类型

structure

定义

typedef struct

{

Dlt_StandardHeaderType Standard_Header;

Dlt_ExtendedHeaderType Extended_Header;

Dlt_MessageIDType Message_Id;

uint16 Module_Id;

uint32 Ex_Instance_Id;

uint8 Instance_Id;

uint32 Ex_App_Id;

uint8 App_Id;

uint8 Ex_Error_Id;

uint8 Error_Id;

} Dlt_VerboseDetLogMsgType;

范围

无

描述

用于定义Dlt模块的冗余模式Det日志消息的结构体类型

Dlt_LogChannelInfoType类型定义

名称

Dlt_LogChannelInfoType

类型

structure

定义

typedef struct

{

uint16 LogChannelId;

uint32 LogChannelName;

Dlt_LogLevelType DefaultLogLevel;

Dlt_LogLevelType LogChannelThreshold;

uint16 ApplicationIdCount;

Dlt_ApplicationIdInfoType ApplicationIdInfo[5];

} Dlt_LogChannelInfoType;

范围

无

描述

用于定义Dlt模块的日志通道信息的结构体类型

Dlt_TraceStatusInfoType类型定义

名称

Dlt_TraceStatusInfoType

类型

structure

定义

typedef struct

{

boolean DefaultTraceStatus;

Dlt_TraceStatusType TraceStatus;

Dlt_ApplicationIDType SwcApplicationId;

Dlt_ContextIDType SwcContextId;

} Dlt_TraceStatusInfoType;

范围

无

描述

用于定义Dlt模块的跟踪状态信息的结构体类型

输入函数描述

输入 模块

API

PduR

Std_ReturnType PduR_DltTransmit(PduIdType id, const PduInfoType *info);

DET

Std_ReturnType Det_ReportError

(

uint16 ModuleId,

uint8 InstanceId,

uint8 ApiId,

uint8 ErrorId

);

GPT

void Gpt_StartTimer(Gpt_ChannelType channel, Gpt_ValueType value);

void Gpt_StopTimer(Gpt_ChannelType channel);

void Gpt_EnableNotification(Gpt_ChannelType channel);

StbM

Std_ReturnType StbM_GetCurrentTime

(

StbM_SynchronizedTimeBaseType timeBaseId,

StbM_TimeStampType *timeStamp,

StbM_UserDataType *userData

);

Std_ReturnType StbM_GetCurrentTimeExtended

(

StbM_SynchronizedTimeBaseType timeBaseId,

StbM_TimeStampExtendedType *timeStamp,

StbM_UserDataType *userData

);

NvM

Std_ReturnType NvM_ReadBlock

(

NvM_BlockIdType BlockId,

void *NvM_DstPtr

);

Std_ReturnType NvM_WriteBlock

(

NvM_BlockIdType BlockId,

const void *NvM_SrcPtr

);

Std_ReturnType NvM_EraseNvBlock(NvM_BlockIdType BlockId);

静态接口函数定义

Dlt_Init函数定义

函数名称：

Dlt_Init

函数原型：

void Dlt_Init(const Dlt_CfgType *ConfigPtr);

服务编号：

0x01

同步/异步：

同步

是 否可重入：

不可重载

输入参数：

ConfigPtr：指向Dlt模块配置结构的指针

值 域：

无

输入 输出参数：

无

输出参数：

无

返回值：

无

功能概述：

完成对Dlt模块的初始化处理；

如Dlt的配置 需要使用NVRamManager非易失数据存储，在 ECU 启动阶段非常晚才初始化；

Dlt_Init()函数应该在初始化 NVRamManager 之后调用；

Dlt_GetVersionInfo函数定义

函数名称：

Dlt_GetVersionInfo

函数原型：

void Dlt_GetVersionInfo(Std_VersionInfoType *VersionInfo);

服务编号：

0x02

同步/异步：

同步

是 否可重入：

不可重载

输入参数：

无

输入 输出参数：

无

输出参数：

versioninfo：保存版本信息的结构体地址

值 域：

无

返回值：

无

功能概述：

获取DLT模块的软件版本信息。

备注： 需要将相应编译宏定义开关设置为开启功能

Dlt_SendTraceMessage函数定义

函数名称：

Dlt_SendTraceMessage

函数原型：

Std_ReturnType Dlt_SendTraceMessage

(

Dlt_SessionIDType session_id,

const Dlt_MessageTraceInfoType *traceInfo,

const uint8 *traceData,

uint16 traceDataLength

);

服务编号：

0x04

同步/异步：

同步

是 否可重入：

不可重载

输入参数：

session_id：会话标识符

值 域：

0 -4294967295

traceInfo：跟踪信息参数

值 域：

无

traceData：跟踪数据缓冲区

值 域：

无

traceDataLength：跟踪数据长度

值 域：

0-65535

输入 输出参数：

无

输出参数：

无

返回值：

Std_ReturnType：

E_OK: API接口请求被接受

E_NOT_OK: API接口请求被拒绝

功能概述：

用于VFB虚拟功能总线模块向D lt模块转发跟踪信息的服务接口，Dl t模块收集到来自虚拟功能总线VFB的 跟踪信息以后，先存储到本地的消息 缓冲区中，然后发送到网络总线上。

Dlt_SendLogMessage函数定义

函数名称：

Dlt_SendLogMessage

函数原型：

Std_ReturnType Dlt_SendLogMessage

(

Dlt_SessionIDType session_id,

const Dlt_MessageLogInfoType *logInfo,

const uint8 *logData,

uint16 logDataLength

);

服务编号：

0x03

同步/异步：

同步

是 否可重入：

不可重载

输入参数：

session_id：会话标识符

值 域：

0 -4294967295

logInfo：日志信息参数

值 域：

无

logData：日志数据缓冲区

值 域：

无

logDataLength：日志数据长度

值 域：

0-65535

输入 输出参数：

无

输出参数：

无

返回值：

Std_ReturnType：

E_OK: API接口请求被接受

E_NOT_OK: API接口请求被拒绝

功能概述：

用于SW C模块向Dlt模块转发日志信息的服务 接口，Dlt模块收集到来自SWC模块的 日志信息以后，先存储到本地的消息 缓冲区中，然后发送到网络总线上。

Dlt_DetForwardErrorTrace函数定义

函数名称：

Dlt_DetForwardErrorTrace

函数原型：

void Dlt_DetForwardErrorTrace

(

uint16 moduleId,

uint8 instanceId,

uint8 apiId,

uint8 errorId

);

服务编号：

0x07

同步/异步：

同步

是 否可重入：

不可重载

输入参数：

moduleId：模块标识符ID

值 域：

0-65535

instanceId：实例标识符ID

值 域：

0-255

apiId：接口标识符ID

值 域：

0-255

errorId：错误标识符 ID

值 域：

0-255

输入 输出参数：

无

输出参数：

无

返回值：

无

功能概述：

用于Det模块向Dl t模块转发错误信息的服务接口，Dlt 模块收集到来自Det模块的 日志信息以后，先存储到本地的消息 缓冲区中，然后发送到网络总线上。

Dlt_RegisterContext函数定义

函数名称：

Dlt_RegisterContext

函数原型：

Std_ReturnType Dlt_RegisterContext

(

Dlt_SessionIDType session_id,

Dlt_ApplicationIDType appId,

Dlt_ContextIDType contextId,

const uint8 *appDescription,

uint8 lenAppDescription,

const uint8 *contextDescription,

uint8 lenContextDescription

);

服务编号：

0x05

同步/异步：

同步

是 否可重入：

不可重载

输入参数：

session_id：会话标识符

值 域：

0 -4294967295

appId：应用程序标识符

值 域：

0 -4294967295

contextId：下文标识符

值 域：

0 -4294967295

appDescription：应用描述信息

值 域：

无

len AppDescription：应用描述信息长度

值 域：

0-255

co ntextDescription：上下文描述信息

值 域：

无

lenContex tDescription：上下文描述信息长度

值 域：

0-255

输入 输出参数：

无

输出参数：

无

返回值：

Std_ReturnType：

E_OK: API接口请求被接受

E_NOT_OK: API接口请求被拒绝

功能概述：

用于SWC软件组件模块向 Dlt模块注册应用程序的上下文信息

Dlt_UnRegisterContext函数定义

函数名称：

Dlt_UnRegisterContext

函数原型：

Std_ReturnType Dlt_UnRegisterContext

(

Dlt_SessionIDType session_id,

Dlt_ApplicationIDType appId,

Dlt_ContextIDType contextId

);

服务编号：

0x16

同步/异步：

同步

是 否可重入：

不可重载

输入参数：

session_id：会话标识符

值 域：

0 -4294967295

appId：应用程序标识符

值 域：

0 -4294967295

contextId：下文标识符

值 域：

0 -4294967295

输入 输出参数：

无

输出参数：

无

返回值：

Std_ReturnType：

E_OK: API接口请求被接受

E_NOT_OK: API接口请求被拒绝

功能概述：

用于SWC软件组件模块向 Dlt模块注销应用程序的上下文信息

Dlt_SetLogLeve函数定义

函数名称：

Dlt_SetLogLeve

函数原型：

Std_ReturnType Dlt_SetLogLevel

(

Dlt_ApplicationIDType appId,

Dlt_ContextIDType contextId,

Dlt_LogMessageLevelType newLogLevel

);

服务编号：

0x08

同 步/异步：

同步

是 否可重入：

不可重载

输入参数：

appId：应用程序标识符

值 域 ：

0-4294967295

contextId：下文标识符

值 域 ：

0-4294967295

newLogLevel： 新的日志级别

值 域 ：

DLT_LOG_OFF

DLT_LOG_FATAL

DLT_LOG_ERROR

DLT_LOG_WARN

DLT_LOG_INFO

DLT_LOG_DEBUG

DLT_LOG_VERBOSE

输入 输出参数：

无

输出参数：

无

返回值：

Std_ReturnType：

E_OK: API接口请求被接受

E_NOT_OK: API接口请求被拒绝

功能概述：

向Dlt模块 请求设置日志级别的服务控制接口

Dlt_SetTraceStatus函数定义

函数名称：

Dlt_SetTraceStatus

函数原型：

Std_ReturnType Dlt_SetTraceStatus

(

Dlt_ApplicationIDType appId,

Dlt_ContextIDType contextId,

boolean newTraceStatus

);

服务编号：

0x09

同步/异步：

同步

是 否可重入：

不可重载

输入参数：

appId：应用程序标识符

值 域 ：

0-4294967295

contextId：下文标识符

值 域 ：

0-4294967295

newTraceStatus： 新的跟踪状态

值 域 ：

DLT_TRACE_ON

DLT_TRACE_OFF

输入 输出参数：

无

输出参数：

无

返回值：

Std_ReturnType：

E_OK: API接口请求被接受

E_NOT_OK: API接口请求被拒绝

功能概述：

向Dlt模块请 求设置当前跟踪状态的服务控制接口

Dlt_GetLogInfo函数定义

函数名称：

Dlt_GetLogInfo

函数原型：

Std_ReturnType Dlt_GetLogInfo

(

uint8 options,

Dlt_ApplicationIDType appId,

Dlt_ContextIDType contextId,

uint8 *status,

Dlt_LogInfoType *logInfo

);

服务编号：

0x0A

同步/异步：

同步

是 否可重入：

不可重载

输入参数：

options：选项字

值 域：

0-255

appId：应用程序标识符

值 域：

0 -4294967295

contextId：下文标识符

值 域：

0 -4294967295

输入 输出参数：

无

输出参数：

status：运行时执行状态

值 域：

无

logInfo：返回当前日志信息

值 域：

无

返回值：

Std_ReturnType：

E_OK: API接口请求被接受

E_NOT_OK: API接口请求被拒绝

功能概述：

向Dlt模块请 求获取当前日志信息的服务控制接口

Dlt_GetDefaultLogLevel函数定义

函数名称：

Dlt_GetDefaultLogLevel

函数原型：

Std_ReturnType Dlt_GetDefaultLogLevel

(

Dlt_MessageLogLevelType *defaultLogLevel

);

服务编号：

0x18

同步/异步：

同步

是 否可重入：

不可重载

输入参数：

无

输入 输出参数：

无

输出参数：

def aultLogLevel：当前的默认日志级别

值 域：

无

返回值：

Std_ReturnType：

E_OK: API接口请求被接受

E_NOT_OK: API接口请求被拒绝

功能概述：

向Dlt 模块请求获 取当前默认日志级别的服务控制接口

Dlt_StoreConfiguration函数定义

函数名称：

Dlt_StoreConfiguration

函数原型：

Std_ReturnType Dlt_StoreConfiguration(void);

服务编号：

0x1A

同步/异步：

同步

是 否可重入：

不可重载

输入参数：

无

输入 输出参数：

无

输出参数：

无

返回值：

Std_ReturnType：

E_OK: API接口请求被接受

E_NOT_OK: API接口请求被拒绝

功能概述：

向Dlt模块请求存储配置的服务调用，即通过调 用NvM_WriteBlock()函数接口，将当前Dlt配置复制到NvRAM。

Dlt_ResetToFactoryDefault函数定义

函数名称：

Dlt_ResetToFactoryDefault

函数原型：

Std_ReturnType Dlt_ResetToFactoryDefault(void);

服务编号：

0x06

同步/异步：

同步

是 否可重入：

不可重载

输入参数：

无

输入 输出参数：

无

输出参数：

无

返回值：

Std_ReturnType：

E_OK: API接口请求被接受

E_NOT_OK: API接口请求被拒绝

功能概述：

向DLT模块请 求将日志级别和跟踪状态设置为非易失性存储的默认值。如果 特性NvMRAM支持被启用，所有存储在NvM中的Dlt值将被删除。

Dlt_SetMessageFiltering函数定义

函数名称：

Dlt_SetMessageFiltering

函数原型：

Std_ReturnType Dlt_SetMessageFiltering(boolean status);

服务编号：

0x1B

同步/异步：

同步

是 否可重入：

不可重载

输入参数：

status：新的消息过滤使能状态

值 域：

TRUE-FALSE

输入 输出参数：

无

输出参数：

无

返回值：

Std_ReturnType：

E_OK: API接口请求被接受

E_NOT_OK: API接口请求被拒绝

功能概述：

向DLT模块请 求使能/禁止Dlt模块的消息过滤功能

Dlt_SetDefaultLogLevel函数定义

函数名称：

Dlt_SetDefaultLogLevel

函数原型：

Std_ReturnType Dlt_SetDefaultLogLevel

(

Dlt_MessageLogLevelType newLogLevel

);

服务编号：

0x11

同 步/异步：

同步

是 否可重入：

不可重载

输入参数：

newLogLevel：新的默认日志级别

值 域 ：

DLT_LOG_OFF

DLT_LOG_FATAL

DLT_LOG_ERROR

DLT_LOG_WARN

DLT_LOG_INFO

DLT_LOG_DEBUG

DLT_LOG_VERBOSE

输入 输出参数：

无

输出参数：

无

返回值：

Std_ReturnType：

E_OK: API接口请求被接受

E_NOT_OK: API接口请求被拒绝

功能概述：

向Dlt模块请求设置 当前默认日志级别的服务控制接口

Dlt_SetDefaultTraceStatus函数定义

函数名称：

Dlt_SetDefaultTraceStatus

函数原型：

Std_ReturnType Dlt_SetDefaultTraceStatus

(

boolean newTraceStatus,

Dlt_LogChannelNameType logChannelName

);

服务编号：

0x12

同步/异步：

同步

是 否可重入：

不可重载

输入参数：

newTraceStatus：新的默认跟踪状态

值 域 ：

DLT_TRACE_OFF

DLT_TRACE_ON

logChannelName：日志通道名称

值 域 ：

0-4294967295

输入 输出参数：

无

输出参数：

无

返回值：

Std_ReturnType：

E_OK: API接口请求被接受

E_NOT_OK: API接口请求被拒绝

功能概述：

向Dlt模块请求设 置当前默认跟踪状态的服务控制接口

Dlt_GetDefaultTraceStatus函数定义

函数名称：

Dlt_GetDefaultTraceStatus

函数原型：

Std_ReturnType Dlt_GetDefaultTraceStatus

(

Dlt_LogChannelNameType logChannelName,

boolean *traceStatus,

);

服务编号：

0x19

同步/异步：

同步

是 否可重入：

不可重载

输入参数：

logChannelName：日志通道名称

值 域：

0 -4294967295

输入 输出参数：

无

输出参数：

traceStatus：当前默认跟踪状态

值 域：

无

返回值：

Std_ReturnType：

E_OK: API接口请求被接受

E_NOT_OK: API接口请求被拒绝

功能概述：

向Dlt模块请求设 置当前默认跟踪状态的服务控制接口

Dlt_GetLogChannelNames函数定义

函数名称：

Dlt_GetLogChannelNames

函数原型：

Std_ReturnType Dlt_GetLogChannelNames

(

uint8 *numberOfLogChannel,

Dlt_LogChannelNameType *logChannelName

);

服务编号：

0x17

同步/异步：

同步

是 否可重入：

不可重载

输入参数：

无

输入 输出参数：

无

输出参数：

nu mberOfLogChannel：日志通道的数量

值 域：

无

logChannelName：日志通道名称

值 域：

无

返回值：

Std_ReturnType：

E_OK: API接口请求被接受

E_NOT_OK: API接口请求被拒绝

功能概述：

向Dlt模块请 求获取日志通道名称的服务控制接口

Dlt_GetTraceStatus函数定义

函数名称：

Dlt_GetTraceStatus

函数原型：

Std_ReturnType Dlt_GetTraceStatus

(

Dlt_ApplicationIDType appId,

Dlt_ContextIDType contextId,

boolean *traceStatus,

);

服务编号：

0x1F

同步/异步：

同步

是 否可重入：

不可重载

输入参数：

appId：应用程序标识符

值 域：

0 -4294967295

contextId：上下文标识符

值 域：

0 -4294967295

输入 输出参数：

无

输出参数：

traceStatus：当前的跟踪状态

值 域：

无

返回值：

Std_ReturnType：

E_OK: API接口请求被接受

E_NOT_OK: API接口请求被拒绝

功能概述：

向Dlt模块请 求获取当前跟踪状态的服务控制接口

Dlt_SetLogChannelAssignment函数定义

函数名称：

Dlt_SetLogChannelAssignment

函数原型：

Std_ReturnType Dlt_SetLogChannelAssignment

(

Dlt_ApplicationIDType appId,

Dlt_ContextIDType contextId,

Dlt_LogChannelNameType LogChannelName,

Dlt_AssignmentOperationType addRemoveOp

);

服务编号：

0x20

同 步/异步：

同步

是 否可重入：

不可重载

输入参数：

appId：应用程序标识符

值 域 ：

0-4294967295

contextId：上下文标识符

值 域 ：

0-4294967295

LogChannelName：日志通道名称

值 域 ：

0-4294967295

addRemoveOp：追加或移除操作

值 域 ：

DLT_OP_ADD

DLT_OP_REMOVE

输入 输出参数：

无

输出参数：

无

返回值：

Std_ReturnType：

E_OK: API接口请求被接受

E_NOT_OK: API接口请求被拒绝

功能概述：

向Dlt模块请求 设置日志通道映射的服务控制接口

Dlt_SetLogChannelThreshold函数定义

函数名称：

Dlt_SetLogChannelThreshold

函数原型：

Std_ReturnType Dlt_SetLogChannelThreshold

(

Dlt_LogChannelNameType LogChannelName,

Dlt_LogLevelType newThreshold,

Dlt_TraceStatusType newTraceStatus

);

服务编号：

0x21

同 步/异步：

同步

是 否可重入：

不可重载

输入参数：

LogChannelName：日志通道名称

值 域 ：

0-4294967295

newThreshold：新的日志通道阈值

值 域 ：

DLT_LOG_OFF

DLT_LOG_FATAL

DLT_LOG_ERROR

DLT_LOG_WARN

DLT_LOG_INFO

DLT_LOG_DEBUG

DLT_LOG_VERBOSE

newTraceStatus：新的跟踪状态

值 域 ：

DLT_TRACE_OFF

DLT_TRACE_ON

输入 输出参数：

无

输出参数：

无

返回值：

Std_ReturnType：

E_OK: API接口请求被接受

E_NOT_OK: API接口请求被拒绝

功能概述：

向Dlt模块请求 设置日志通道阈值的服务控制接口

Dlt_GetLogChannelThreshold函数定义

函数名称：

Dlt_GetLogChannelThreshold

函数原型：

Std_ReturnType Dlt_GetLogChannelThreshold

(

Dlt_LogChannelNameType LogChannelName,

Dlt_LogLevelType *newThreshold,

Dlt_TraceStatusType *newTraceStatus

);

服务编号：

0x22

同 步/异步：

同步

是 否可重入：

不可重载

输入参数：

LogChannelName：日志通道名称

值 域 ：

0-4294967295

contextId：上下文标识符

值 域 ：

0-4294967295

LogChannelName：

值 域 ：

0-4294967295

addRemoveOp

值 域 ：

DLT_OP_ADD

DLT_OP_REMOVE

输入 输出参数：

无

输出参数：

newThreshold：新的日志通道阈值

值 域 ：

无

newTraceStatus：新的跟踪状态

值 域 ：

无

返回值：

Std_ReturnType：

E_OK: API接口请求被接受

E_NOT_OK: API接口请求被拒绝

功能概述：

向Dlt模块请求 返回日志通道阈值的服务控制接口

Dlt_TxFunction函数定义

函数名称：

Dlt_TxFunction

函数原型：

void Dlt_MainFunction(void);

服务编号：

0x80

同步/异步：

同步

是 否可重入：

不可重载

输入参数：

无

输入 输出参数：

无

输出参数：

无

返回值：

Std_ReturnType：

E_OK: API接口请求被接受

E_NOT_OK: API接口请求被拒绝

功能概述：

服务用于实现周期调度发送处理功能函数，用于Dlt 模块的异步操作逻辑处理，以及消息处理机制的发送任务处理

通信回调接口函数定义

Dlt_RxIndication函数定义

函数名称：

Dlt_RxIndication

函数原型：

void Dlt_RxIndication

(

PduIdType DltRxPduId,

const PduInfoType *PduInfoPtr,

Std_ReturnType Result

);

服务编号：

0x42

同步/异步：

同步

是 否可重入：

不可重载

输入参数：

DltRxPduId：Dlt模块的接收PDU标识符

值 域 ：

0-65535

PduInfoPtr：包含接收到的 PDU 的长度(SduLength)，一个指向包含 PDU 的 缓冲区(SduDataPtr)的指针，以及与这个 PDU 相关的元数据。

值 域 ：

无

Result：N-PDU接收的结果

E_OK：PDU接收成功

E_NOT_OK：PDU接收失败

值 域 ：

E_OK

E_NOT_OK

输入 输出参数：

无

输出参数：

无

返回值：

无

功能概述：

Dlt模块以IF的方 式，从下层PduR模块接收总线上的PDU数据

Dlt_TriggerTransmit函数定义

函数名称：

Dlt_TriggerTransmit

函数原型：

Std_ReturnType Dlt_TriggerTransmit

(

PduIdType TxPduId,

const PduInfoType *PduInfoPtr

);

服务编号：

0x41

同步/异步：

同步

是 否可重入：

可重入 不同的PduId；对于相同的PduId不可重入

输入参数：

TxPduId：被请求被发送的SDU的标识符ID

值 域：

0 -65535

PduInfoPtr：包含一个指向要复制SDU数据 的缓冲区(SduDataPtr)的指针，以及SduLe ngh中可用的缓冲区大小。返回时，服务将 在SduLength中指示复制的SDU数据的长度

值 域：

无

输入 输出参数：

无

输出参数：

无

返回值：

Std_ReturnType：

E_OK: API接口请求被接受

E_NOT_OK: API接口请求被拒绝

功能概述：

在这个API中，上层模块(称为模块)将 检查可用数据是否符合PduInfoPtr->SduL ength报告的缓冲区大小。如果符合，则将 其数据复制到PduInfoPtr->SduDataPtr提 供的缓冲区中，并在PduInfoPtr->SduLen gth中更新实际复制数据的长度。如果没有 ，它返回E_NOT_OK而不改变PduInfoPtr。

Dlt_TxConfirmation函数定义

函数名称：

Dlt_TxConfirmation

函数原型：

void Dlt_TxConfirmation

(

PduIdType TxPduId,

Std_ReturnType Result

);

服务编号：

0x40

同步/异步：

同步

是 否可重入：

可重入 不同的PduId；对于相同的PduId不可重入

输入参数：

TxPduId：已发送的PDU的标识符ID

值 域 ：

0-65535

Result：N-PDU发送的结果

E_OK：PDU被发送成功

E_NOT_OK：PDU发送失败

值 域 ：

E_OK

E_NOT_OK

输入 输出参数：

无

输出参数：

无

返回值：

无

功能概述：

下层通信接口模块确认发送P DU数据成功，或发送PDU数据失败的通知。

Dlt_TpTxConfirmation函数定义

函数名称：

Dlt_TpTxConfirmation

函数原型：

void Dlt_TpTxConfirmation

(

PduIdType id,

Std_ReturnType Result

);

服务编号：

0x48

同步/异步：

同步

是 否可重入：

可重入

输入参数：

id：被发送I-PDU的标识符ID

值 域 ：

0-65535

Result：I-PDU发送的结果

E_OK：PDU被发送成功

E_NOT_OK：PDU发送失败

值 域 ：

E_OK

E_NOT_OK

输入 输出参数：

无

输出参数：

无

返回值：

无

功能概述：

这个函数在I-PDU在其网络上 发送之后被调用，结果表明发送是否成功

Dlt_CopyTxData函数定义

函数名称：

Dlt_CopyTxData

函数原型：

BufReq_ReturnType Dlt_CopyTxData

(

PduIdType id,

const PduInfoType *info,

const RetryInfoType *retry,

PduLengthType *availableDataPtr

);

服务编号：

0x43

同步/异步：

同步

是 否可重入：

可重入

输入参数：

id：被发送I-PDU的标识符

值 域：

0 -65535

Info：提供目标缓冲区(SduDataPtr)和要 复制的字节数(SduLength)。如果没有足够 的发送数据可用，上层模块不会复制数据 ，并返回BUFREQ_E_BUSY。下层模块可以重 试调用。SduLength为0可用于指示重试参 数中的状态变化或查询上层模块中当前可 用数据的数量。在本例中，SduDataPtr可 能 是 一 个NULL_PTR。

值 域：

无

Retry：此参数用于确认已发送 数据或在发送出现问题后重新发送数据。

值 域：

无

输入 输出参数：

无

输出参数：

availableDataPt r：指示上层模块的Tx缓冲区中可用的剩余 字节数。availableDataPtr可被支持动态 负载长度的TP模块用于确定以下CF的大小

值 域：

无

返回值：

BufReq_ReturnType：

BUFREQ_OK：

数 据已经完全按照请求复制到发送缓冲区。

BUFREQ_E_BUSY：

由于 Tx 数据量不够，请求无法完成。下层模块可 能稍后重试此调用。没有复制任何数据。

BUFREQ_E_NOT_OK：

没有复制数据， 请求失败。

功能概述：

这个函数在I-PDU在其网络上 发送之后被调用，结果表明发送是否成功

Dlt_StartOfReception函数定义

函数名称：

Dlt_StartOfReception

函数原型：

BufReq_ReturnType Dlt_StartOfReception

(

PduIdType id,

const PduInfoType *info,

PduLengthType TpSduLength,

PduLengthType *bufferSizePtr

);

服务编号：

0x46

同步/异步：

同步

是 否可重入：

可重入

输入参数：

id：I-PDU的标识符

值 域：

0 -65535

info：一个PduIn foType结构的指针，它包含传输协议I-PDU 接收的首帧或单帧的有效负载数据(没有协 议信息)和有效负载长度，以及与这个PDU 相关的元数据。如果首帧/单帧数据或元数 据都不可用，则此参数设置为NULL_PTR。

值 域：

无

TpSduLength：要接收的N-SDU的总长度

值 域：

0 -65535

输入 输出参数：

无

输出参数：

bufferSize Ptr：接收模块中可用的接收缓冲区。此参 数将用于计算传输协议模块中的块大小。

值 域：

无

返回值：

BufReq_ReturnType：

BUFREQ_OK：

连接已被接受。b ufferSizePtr表示可用的接收缓冲区;接待 继续。如果没有所需大小的缓冲区可用， 则bufferSizePtr将表示接收缓冲区大小为 0。

BUFREQ_E_NOT_OK：

连接被拒绝; 招待会将中止。bufferSizePtr保持不变。

BUFREQ_E_OVFL：

不能提供所需长度的缓冲区 ;接收将中止。bufferSizePtr保持不变。

功能概述：

这个函数在接收N-SDU 开始时被调用。N-SDU可能被分割成多个N- PDU(带有一个或多个后续CF的FF)，或者可 能由单个N-PDU(SF)组成。当TpSduLength 为0时 ，服务将提供当前可用的最大缓冲区大小

Dlt_TpRxIndication函数定义

函数名称：

Dlt_TpRxIndication

函数原型：

void Dlt_TpRxIndication

(

PduIdType id,

Std_ReturnType Result

);

服务编号：

0x45

同步/异步：

同步

是 否可重入：

可重入

输入参数：

id：接收到的I-PDU的标识符

值 域 ：

0-65535

Result：PDU数据接收的结果

值 域 ：

E_OK

E_NOT_OK

输入 输出参数：

无

输出参数：

无

返回值：

无

功能概述：

通过TP形式的API接口接收到 I-PDU后被调用，结果表明传输是否成功

Dlt_CopyRxData函数定义

函数名称：

Dlt_CopyRxData

函数原型：

BufReq_ReturnType Dlt_CopyRxData

(

PduIdType id,

const PduInfoType *info,

PduLengthType *bufferSizePtr

);

服务编号：

0x44

同步/异步：

同步

是 否可重入：

可重入

输入参数：

id：接收到的I-PDU的标识符

值 域：

0 -65535

info：提供 源缓冲区(SduDataPtr)和要复制的字节数 (SduLength)。SduLength为0可以用来查询 上层模块中可用缓冲区的当前数量。在本 例中，SduDataPtr可能是一个NULL_PTR。

值 域：

无

输入 输出参数：

无

输出参数：

buff erSizePtr：数据复制后可用的接收缓冲区

值 域：

无

返回值：

BufReq_ReturnType：

BUFREQ_OK：数据复制成功

BUFREQ_E_N OT_OK：数据未被复制，因为发生了错误。

功能概述：

调用这个 函数是为了将I-PDU段(N-PDU)接收到的数 据提供给上层。对这个函数的每次调用都 会提供I-PDU数据的下一部分。剩余缓冲区 的大小写入bufferSizePtr所指示的位置。

可配置函数定义

Dlt_InjectionCallback_<User>函数定义

函数名称：

Dlt_Injec tCallback_<User>

函数原型：

可配置

服务编号：

无

同步/异步：

同步

是 否可重入：

可重入

输入参数：

无

值域：

无

输入 输出参数：

无

输出参数：

无

返回值：

E_OK：操作成功

DLT_ E_ERROR：操作失败

功能概述：

用于注入控制 的可配置回调函数

Dlt_LogLevelChangedNotification_<User>函数定义

函数名称：

Dlt_L ogLevelChangedNot ification_<User>

函数原型：

可配置

服务编号：

无

同步/异步：

同步

是 否可重入：

可重入

输入参数：

无

值域：

无

输入 输出参数：

无

输出参数：

无

返回值：

E_OK：操作成功

DLT_ E_ERROR：操作失败

功能概述：

用于 日志/跟踪会话控制 的可配置回调函数

Dlt_TraceStatusChangedNotification_<User>函数定义

函数名称：

Dlt_Trac eStatusChangedNot ification_<User>

函数原型：

可配置

服务编号：

无

同步/异步：

同步

是 否可重入：

可重入

输入参数：

无

值域：

无

输入 输出参数：

无

输出参数：

无

返回值：

E_OK：操作成功

DLT_E_MSG_ TOO_LARGE：内部DL T缓冲区的消息太长

DLT_E_CONTEXT_AL READY_REG：软件模 块上下文已被注册

DLT_E_UNKNOWN _SESSION_ID：提供 的会话ID是未知的

DLT_E_NO_B UFFER：缓冲区溢出

D LT_E_CONTEXT_NOT_ YET_REG：软件模块 上下文没有被注册

DLT_ E_ERROR：操作失败

功能概述：

用于SWC消息服务 的可配置回调函数

配置

主要介绍DLT模块的配置参数，列举配置项在配置界面显示的名称，对应的标准、可能的取值、默认的取值、参数描述及依赖关系，旨在指导用户如何使用配置工具进行DLT模块参数的配置。

表5-1 属性描述

UI名称

该配置项在配置工具界面显示的名称

取值范围

该配置项允许的取值区间

默认取值

该配置项默认的配置值

参数描述

该配置项在标准的AUTOSAR_EcucParamDef.arxml文件中的描述

依赖关系

该配置项与其他模块或配置项的关系

DltGeneral配置

|C:\\Users\\Administrator\\Desktop\\Dlt\\DltMGeneral.PNG|

图5-1 Dlt模块的General容器配置图

表5-2 Dlt模块的General配置属性描述

UI 名称

描述

DltGen eralDe vError Detect

取值范围

STD_ON,STD_OFF

默 | 认 | 取 | 值 |

S T D _ O F F

参数描述

是 否开启配置出错检测。 若开启，一旦检测到配 置出错，则代码停留在 故障出错位置。量产用 代码，需关闭该配置。

依赖关系

依赖于DET模块的配置

Dl tGener alInje ctionS upport

取值范围

STD_ON,STD_OFF

默认取值

STD_OFF

参数描述

使能或禁止Dl t模块应用程序注入功能

依赖关系

依赖于SWC模块的配置

DltG eneral NvRAMS upport

取值范围

STD_ON,STD_OFF

默认取值

STD_OFF

参数描述

使能或禁止Dlt模块对 非易失性RAM数据的支持

备注：

如果Dlt模块在运行时 能够持久地存储修改过 的参数，则应该设置该 引用并指向NvmBlock。

依赖关系

依赖于NvRAM模块的配置

D ltGene ralReg isterC ontext Notifi cation

取值范围

STD_ON,STD_OFF

默认取值

STD_OFF

参数描述

使能或禁止Dlt模块对 注册上下文通知的支持

依赖关系

依赖于SWC模块的配置

D ltGene ralReg isterC ontext Notifi cation

取值范围

STD_ON,STD_OFF

默认取值

STD_OFF

参数描述

如果此参数设置为T RUE，则每次SWC注册和/ 在Dlt模块/从Dlt模块注 销时发送Dlt控制消息。 否则，此通知将不发送

依赖关系

依赖于SWC模块的配置

Dlt Genera lRxDat aPathS upport

取值范围

STD_ON,STD_OFF

默认取值

STD_OFF

参数描述

启用或禁用Rx数 据路径来控制Dlt模块。

依赖关系

依赖于 通信协议栈模块的配置

DltTa skTime

取值范围

0…4294967295

默认取值

0

参数描述

用于配置Dlt模 块周期调度的时间基准

依赖关系

依赖于O S或系统环境模块的配置

Dlt Genera lStart UpDela yTimer

取值范围

1…10000

默认取值

0

参数描述

Dlt模块初始 化后启动日志和跟踪消 息传输的s中可配置延迟

依赖关系

依赖于O S或系统环境模块的配置

Dl tGener alTime StampS upport

取值范围

STD_ON,STD_OFF

默认取值

STD_OFF

参数描述

如果要在Dlt消 息中添加时间戳，则此 配置参数应设置为TRUE

依赖关系

依赖 于GPT或STBM模块的配置

D ltGene ralTra fficSh apingS upport

取值范围

STD_ON,STD_OFF

默认取值

STD_OFF

参数描述

启用或 禁用流量成形特性以限 制Dlt消息的最大带宽。

如 果启用，可以为每个日 志通道配置最大带宽。

依赖关系

依赖于 通信协议栈模块的配置

Dlt Genera lGetLo gInfoS tatusS upport

取值范围

STD_ON,STD_OFF

默认取值

STD_OFF

参数描述

启用或禁用Dlt模块对获 取日志信息状态的支持

依赖关系

无

D ltGene ralVer sionIn foApiv

取值范围

STD_ON,STD_OFF

默认取值

STD_OFF

参数描述

用于使能或禁 止版本信息API接口支持 的预处理宏编译开关。

依赖关系

无

DltGe neralG ptChan nelRef

取值范围

引用或下拉菜单

默认取值

无

参数描述

如果使用TimeStam pSupport，那么Dlt模块 将通过使用此处引用的G ptChannel调用Gpt_GetT imeElapsed从Gpt模块获 取时间。滴答持续时间 可以从GptChannelConf iguration容器的GptCha nnelTickFrequency参数 推导出来。这对于计算 Dlt消息中的微秒分辨率 时间戳输出是必要的。

依赖关系

依赖于GPT模块的配置

DltGen eralGp tChann elInfo

取值范围

引用或下拉菜单

默认取值

无

参数描述

用于DLT模块 GPT通道信息引用的配置

依赖关系

依赖于GPT模块的配置

DltBuf ferMax Length

取值范围

0…65535

默认取值

0

参数描述

用于描述 DLT模块缓冲区最大长度 的配置用于描述DLT模块 缓冲区最大长度的配置

依赖关系

无

DltGen eralNv RAMRef

取值范围

引用或下拉菜单

默认取值

无

参数描述

用于DLT模块对 非易失性RAM引用的配置

依赖关系

依赖于NvRAM模块的配置

D ltGene ralStb MTimeB aseRef

取值范围

0…4294967295

默认取值

0

参数描述

如果 使用TimeStampSupport, Dlt模块 将通过调用StbM_GetCu rrentTime从StbM模块获 取时间，此处引用StbMS ynchronizedTimeBase。

依赖关系

依赖于STBM模块的配置

DltConfigSet配置

新建DltConfigSet

DltConfigSet添加步骤为：鼠标选中DltConfigSets—单击右键—New—DltConfigSet。默认情况，无该配置项。

image7

图5-2 Dlt模块新建ConfigSet配置容器界面

DltConfigSet配置容器

image8

图5-3 Dlt模块ConfigSet配置容器界面

表5-3 Dlt模块的ConfigSet配置属性描述

UI 名称

描述

DltCon figSet

取值范围

下拉选项

默 | 认 | 取 | 值 |
无 |

参数描述

这个容器列出 了在预编译时可以启用 或禁用的所有全局Dlt功 能，以优化资源消耗。

依赖关系

无

D ltLogL evelSe ttings

取值范围

下拉选项

默认取值

无

参数描述

包含 Dlt日志级别阈值的设置

依赖关系

无

D ltLogO utputs

取值范围

下拉选项

默认取值

无

参数描述

包含日 志/跟踪消息输出的设置

依赖关系

无

DltPro tocols

取值范围

下拉选项

默认取值

无

参数描述

用于处理特 定协议变体的配置参数

依赖关系

无

Dlt RxPdus

取值范围

下拉选项

默认取值

无

参数描述

包含用于Dlt控制 消息接收的Pdu标识符ID

依赖关系

无

Dltt raceSt atusSe ttings

取值范围

下拉选项

默认取值

无

参数描述

包含Dlt跟踪状态的设置

依赖关系

无

DltLogLevelSettings配置

新建DltLogLevelSettings

DltLogLevelSettings添加步骤为：鼠标选中DltConfigSet—单击右键—New—DltLogLevelSettings。默认情况，无该配置项。

image9

图5-4 Dlt模块新建LogLevelSetting容器界面

DltLogLevelSettings配置容器

为Dlt模块设置初始默认日志级别，在DltLogLevelSettings选项卡中点击默认日志级别设置按钮DltDefaultLogLevel，从下拉菜单中选中一个配置作为默认日志级别。默认情况，该配置项设置为DLT_LOG_OFF。

image10

图5-5 Dlt模块LogLevelSetting配置容器界面

新建DltLogLevelThreshold

DltLogLevelThreshold添加步骤为：鼠标选中DltLogLevelSetting—单击右键—New—DltLogLevelThreshold。默认情况，无该配置项。

image11

图5-6 Dlt模块新建LogLevelThreshold容器界面

DltLogLevelThreshold配置容器

为Dlt模块设置初始日志级别，在DltLogLevelThreshold选项卡中点击日志级别阈值设置按钮Threshold，从下拉菜单中选中一个配置作为初始日志级别阈值。默认情况，该配置项设置为DLT_LOG_OFF。

image12

图5-7 Dlt模块的LogLevelThreshold配置容器界面

DltLogLevelThresholdSwcContextRef配置容器

为Dlt模块对应的日志级别阈值挂接SWC上下文注册的参考配置信息，在DltLogLevelThreshold选项卡中点击日志级别阈值SWC上下文引用挂接设置按钮LogLevelThresholdSwcContextRef，从下拉菜单中选中一个配置作为相应日志级别阈值的上下文配置信息。默认情况，无该配置项。

image13

图5-8 Dlt模块的LogLevelThresholdSwcContextRef配置容器界面

DltLogLevelSetting配置容器的属性描述

表5-4 Dlt模块的LogLevelSetting配置属性描述

UI 名称

描述

DltDef aultLo gLevel

取值范围

下拉选项

默 | 认 | 取 | 值 |
无 |

参数描述

这是在没有过 滤器匹配给定的Appica tionId和context时使用 的有效日志级别。这可 以看作是一个贯穿过滤 器定义，带有Appicatio nId和contexts的通配符 ，当没有其他过滤器匹 配时，将使用通配符。

依赖关系

无

Thr eshold

取值范围

下拉选项

默认取值

无

参数描述

用于为给定Appication Id和context的元组配置 初始的的日志级别阈值

依赖关系

无

LogLev elThre sholdS wcCont extRef

取值范围

下拉选项

默认取值

无

参数描述

用 于为日志级别阈值挂接 对应的上下文配置信息

依赖关系

依赖于DltSwc的配置项

DltLogOutputs配置

新建DltLogOutputs

DltLogOutputs添加步骤为：鼠标选中DltConfigSet—单击右键—New—DltLogOutputs。默认情况，无该配置项。

image14

图5-9 Dlt模块新建LogOutput容器界面

DltLogOutput配置容器

引用默认日志通道，如果没有找到其他匹配项，则必须将其用于日志/跟踪输出。在DltLogOutput选项卡中点击默认日志通道引用设置按钮。

DltDefaultLogChannelRef，从下拉菜单中选中一个配置作为默认日志通道。默认情况，无该配置项。

image15

图5-10 Dlt模块DefaultLogChannelRef配置容器界面

表5-5 Dlt模块的LogOutput配置属性描述

UI 名称

描述

DltLog Output

取值范围

下拉选项

默 | 认 | 取 | 值 |
无 |

参数描述

包含日 志/跟踪消息输出的设置

依赖关系

无

DltDe faultL ogChan nelRef

取值范围

下拉选项

默认取值

无

参数描述

引用默认 日志通道，如果没有找 到其他匹配项，则必须 将其用于日志/跟踪输出

依赖关系

无

D ltLogC hannel

取值范围

下拉选项

默认取值

无

参数描述

包含日 志/跟踪消息输出的设置

依赖关系

无

DltLo gChann elAssi gnment

取值范围

下拉选项

默认取值

无

参数描述

这 个容器包含Applicatio nId/ContextId对及其分 配的日志通道的预配置

依赖关系

无
新建DltLogChannel

DltLogChannel添加步骤为：鼠标选中DltLogOutput—单击右键—New—DltLogChannel。默认情况，无该配置项。

image16

图5-11 Dlt模块新建LogChannel容器界面

DltLogChannel配置容器

为Dlt模块设置日志通道指定发生缓冲区溢出时重置缓冲区溢出标志的周期时间；为日志通道特定消息缓冲区设置缓冲区大小；为日志通道配置索引名称；为Dlt日志或跟踪消息设置长限制；为日志通道设置日志级别阈值；为日志通道设置通信带宽；为日志通道的传输功能指定周期时间；打开/关闭对应日志通道。

默认情况，无该配置项。

image17

图5-12 Dlt模块LogChannel配置容器界面

表5-6 Dlt模块的LogChannel配置属性描述

UI 名称

描述

Dl tLogCh annelB ufferO verflo wTimer

取值范围

0.001…1

默 | 认 | 取 | 值 |

0

参数描述

指 定发生缓冲区溢出时重 置缓冲区溢出标志的周 期时间(以秒为单位)。

依赖关系

无

DltLo gChann elBuff erSize

取值范围

0…4294967295

默认取值

0

参数描述

日志通道特定消 息缓冲区的缓冲区大小

备注：以字节为单位

依赖关系

无

Dlt LogCha nnelId

取值范围

0…255

默认取值

0

参数描述

这是日志通道的4 个ASCII字符长的名称， 在Dlt控制消息中作为参 数名Dlt_interface使用

依赖关系

无

DltLo gChann elMaxM essage Length

取值范围

0…65535

默认取值

0

参数描述

Dlt日 志通道的最大消息长度

依赖关系

依赖于S WC或VFB发送消息的大小

DltL ogChan nelMax NumOfR etries

取值范围

0…255

默认取值

0

参数描述

Dlt日 志通道的最大尝试次数

依赖关系

依赖于S WC或VFB发送消息的大小

DltL ogChan nelThr eshold

取值范围

DLT_LOG_OFF

DLT_LOG_FATAL

DLT_LOG_ERROR

DLT_LOG_WARN

DLT_LOG_INFO

DLT_LOG_DEBUG

DLT_LOG_VERBOSE

默认取值

DL T_LOG_OFF

参数描述

用于为日志 通道设置日志级别阈值

依赖关系

无

DltLog Channe lTraff icShap ingBan dwidth

取值范围

0…

18446744073709551615

默认取值

0

参数描述

以位/秒为 单位设置最大可能带宽

依赖关系

依赖于通信总线的速率

Dl tLogCh annelT ransmi tCycle

取值范围

0.001…1

默认取值

0

参数描述

指定 此日志通道传输功能的 周期时间(以秒为单位)

依赖关系

无

Dlt LogTra ceStat usFlag

取值范围

STD_ON/STD_OFF

默认取值

STD_OFF

参数描述

参数来完 全打开/关闭此日志通道

依赖关系

无
新建DltTxPdu

DltTxPdu添加步骤为：鼠标选中DltLogChannel—单击右键—New—DltTxPdu。默认情况，无该配置项。

image18

图5-13 Dlt模块新建TxPdu容器界面

DltTxPdu配置容器

将相应日志通道的发送PDU与ECU模块的PDU信号关联起来，并对相应配置项进行设置，如DltTxPduHandleId、DltTxPduUseTp和DltTxPduIdRef等参数设置。

image19

图5-14 Dlt模块TxPdu配置容器界面

表5-7 Dlt模块的TxPdu配置属性描述

UI 名称

描述

Dl tTxPdu

取值范围

下拉选项

默 | 认 | 取 | 值 |
无 |

参数描述

包含AUTOSAR中Dlt模块 的Tx发送Pdu的配置参数

依赖关系

无

DltIT xPduHa ndleId

取值范围

0…65535

默认取值

0

参数描述

用作这个I-PDU ID的数值。

这个处理 Id用于api调用Dlt_TxCo nfirmation、Dlt_Trigg erTransmit、Dlt_Trigg erIPDUSend或Dlt_Trigg erIPDUSendWithMetaDat a,Dlt_CopyTxData和Dlt _TpTxConfirmation传输 IPDU分别确认传输,以及 PduId传递到Tx-I-PDU- callout配置了DltIPduC allout和/或DltIPduTri ggerTransmitCallout。

依赖关系

依赖于ECU和PDUR的配置

Dlt ITxPdu UsesTp

取值范围

TRUE/FALSE

默认取值

FALSE

参数描述

如果 设置为TRUE，则使用TP API传输PDU。

如果为FALSE，则使用IF API。

依赖关系

依赖于ECU和PDUR的配置

D ltTxPd uIdRef

取值范围

引用或下拉选项

默认取值

无

参数描述

引用全局的Pd u结构，以允许在通信堆 栈中协调句柄标识符ID

依赖关系

依赖于ECU和PDUR的配置
新建DltLogChannelAssignment

DltLogChannelAssignment添加步骤为：鼠标选中DltLogOutput—单击右键—New—DltLogChannelAssignment。默认情况，无该配置项。

image20

图5-15 Dlt模块新建LogChannelAssignment容器界面

DltLogChannelAssignment配置容器

为Dlt模块的日志通道分配挂接相应的上下文配置ContextRef信息，在DltLogChannelAssignment项卡中点击日志通道阈值设置按钮Assignment，从下拉菜单中选中一个配置作为日志通道分配的信息。

image21

图5-16 Dlt模块的LogChannelAssignment配置容器界面

表5-8 Dlt模块的LogChannelAssignment配置属性描述

UI 名称

描述

DltLo gChann elAssi gnment

取值范围

下拉选项

默 | 认 | 取 | 值 |
无 |

参数描述

这个容器包 含ApplicationId/Cont extId对应元组及其分配 的日志通道的预配置。

依赖关系

无

DltLog Channe lAssig nmentS wcCont extRef

取值范围

引用或下拉选项

默认取值

无

参数描述

引用分 配给Dlt日志通道的Appl icationId/ContextId对

依赖关系

依赖于DltSwc的配置项

DltL ogChan nelRef

取值范围

引用或下拉选项

默认取值

无

参数描述

对分配给Applicat ionId/ContextId对应元 组的Dlt日志通道的引用

依赖关系

依 赖于日志通道的配置项

DltProtocols配置

新建DltProtocols

DltProtocols添加步骤为：鼠标选中DltConfigSet—单击右键—New—DltProtocols。默认情况，无该配置项。

image22

图5-17 Dlt模块新建Protocol配置容器界面

DltProtocols配置容器

用于处理特定协议变体的配置参数，如Dlt标准消息报文头中是否使用EcuId，SessionId、TimeStamp等参数的配置，在非Verbose模式中是否使用扩展消息报文头的参数配置，Verbose模式的参数配置，Dlt消息过滤的状态配置。

image23

图5-18 Dlt模块Protocols配置容器界面

表5-9 Dlt模块的Protocols配置属性描述

UI 名称

描述

DltPr otocol

取值范围

引用或下拉选项

默 | 认 | 取 | 值 |
无 |

参数描述

用于处理特 定协议变体的配置参数

依赖关系

无

DltHe aderUs eEcuId

取值范围

TRUE，FALSE

默认取值

FALSE

参数描述

对应字 段WEID(携带有ECU标识 符ID)。如果设置了ECU ID，则应放在标准消 息头中，否则不需要。

如果使用参数D ltGeneralNvRamRef，该 参数将为对应的NVRam条 目定义初始值。如果没 有设置参数DltGeneralN vRamRef，则链接时或构 建后配置应该被使用。

依赖关系

无

Dlt Header UseSes sionID

取值范围

TRUE，FALSE

默认取值

FALSE

参数描述

对应于 字段WSID(携带有会话标 识符ID)。如果设置了， 会话ID应该放在标准消 息头中，否则不需要。

如果使用参数D ltGeneralNvRamRef，该 参数将为对应的NVRam条 目定义初始值。如果没 有设置参数DltGeneralN vRamRef，则链接时或构 建后配置应该被使用。

依赖关系

无

Dlt Header UseTim estamp

取值范围

TRUE，FALSE

默认取值

FALSE

参数描述

对应于字段WTMS(携带 有时间戳)。如果设置了 时间戳，应该放在标准 消息头，否则不需要。

如果使用参数D ltGeneralNvRamRef，该 参数将为对应的NVRam条 目定义初始值。如果没 有设置参数DltGeneralN vRamRef，则链接时或构 建后配置应该被使用。

依赖关系

无

DltU seExtH eaderI nNonVe rbMode

取值范围

TRUE，FALSE

默认取值

FALSE

参数描述

非冗长Verbose消息( 相对于冗长消息)不需要 扩展头。如果将此标志 设置为true，则扩展头 也应用于非冗长消息。

如果启 用了DltGeneralNvRAMSu pport，则此参数是对应 NVRam条目的初始值。如 果没有设置DltGeneralN vRAMSupport，则链接时 或构建后配置应使用。

依赖关系

无

DltUs eVerbo seMode

取值范围

TRUE，FALSE

默认取值

FALSE

参数描述

如 果此标志设置为TRUE， 则有效负载将以详细模 式传输，否则有效负载 将以非详细模式传输。

依赖关系

无

Dl tEcuId

取值范围

引用或下拉选项

默认取值

无

参数描述

这是一个选择 容器，用于在一个EcuId 值和一个callout之间进 行选择，以获得EcuId。

参数描述

无
新建DltEcuId

image24

图5-19 Dlt模块新建EcuId配置容器界面

DltEcuId配置容器

表5-10 Dlt模块的EcuId配置属性描述

UI 名称

描述

Dl tEcuId

取值范围

引用或下拉选项

默 | 认 | 取 | 值 |

参数描述

这是一个选择 容器，用于在一个EcuId 值和一个callout之间进 行选择，以获得EcuId。

依赖关系

无

Dlt EcuIdC allout Choice

取值范围

TRUE，FALSE

默认取值

FALSE

参数描述

EcuId的配置通过 Callout回调函数来获取

依赖关系

无

D ltEcuI dValue Choice

取值范围

TRUE，FALSE

默认取值

FALSE

参数描述

EcuId的配 置直接通过数值来获取

依赖关系

无
新建DltEcuIdValueChoice

image25

图5-20 Dlt模块新建EcuIdValueChoice配置容器界面

DltEcuIdValueChoice配置容器

image26

图5-21 Dlt模块新建EcuIdValueChoice配置容器界面

表5-11 Dlt模块的EcuIdValueChoice配置属性描述

UI 名称

描述

D ltEcuI dValue Choice

取值范围

引用或下拉选项

默 | 认 | 取 | 值 |
无 |

参数描述

EcuId的配 置直接通过数值来获取

依赖关系

无

D ltEcuI dValue

取值范围

字符串：uint8 []

默认取值

无

参数描述

如果使用此选项，则 应从配置的字符串中获 取EcuId。这是在Dlt协 议中使用的ECU的名称。 如果你想使用一个数字 表示类型，这是字符。

依赖关系

无
DltEcuIdCalloutChoice配置容器

表5-12 Dlt模块的EcuIdCalloutChoice配置属性描述

UI 名称

描述

Dlt EcuIdC allout Choice

取值范围

引用或下拉选项

默 | 认 | 取 | 值 |

参数描述

EcuId的配置通过 Callout回调函数来获取

依赖关系

无

D ltEcuI dValue

取值范围

回调函数

默认取值

–

参数描述

如 果使用此选项，则应通 过调用此处配置的callo ut函数来获取该EcuId。

依赖关系

无

DltRxPdus配置

新建DltRxPdus

DltRxPdus添加步骤为：鼠标选中DltConfigSet—单击右键—New—DltRxPdus。默认情况，无该配置项。

image27

图5-22 Dlt模块新建RxPdu配置容器界面

DltRxPdus配置容器

为Dlt模块通信机制的接收链路配置PDU参数，如DltIRxPduHandleId、DltIRxPduUsesTp和DltRxPduIdRef等参数的设置。

image28

图5-23 Dlt模块RxPdus配置容器界面

表5-13 Dlt模块的RxPdus配置属性描述

UI 名称

描述

Dl tRxPdu

取值范围

引用或下拉选项

默 | 认 | 取 | 值 |

参数描述

包含用于Dlt控制 消息接收的Pdu标识符ID

依赖关系

依赖 于ECUC和PDUR的配置项

DltIR xPduHa ndleId

取值范围

0…65536

默认取值

0

参数描述

用作这个I-PDU ID的数值。 API调用Dlt_RxIndicat ion、Dlt_TpRxIndicati on、Dlt_StartOfRecept ion和Dlt_CopyRxData时 需要DltRxPduHandleId 来接收来自PduR的I-PDU (DltIPduDirection: r eceive)，以及传递给Rx IPDU-callout的PduId。

依赖关系

依赖 于ECUC和PDUR的配置项

Dlt IRxPdu UsesTp

取值范围

TRUE，FALSE

默认取值

FALSE

参数描述

如果 设置为TRUE，则使用TP API接收PDU。

如果为FALSE，则使用IF API。

依赖关系

依赖 于ECUC和PDUR的配置项

D ltRxPd uIdRef

取值范围

引用或下拉选项

默认取值

–

参数描述

引用全局的Pd u结构，以允许在通信堆 栈中协调句柄标识符ID

依赖关系

依赖 于ECUC和PDUR的配置项

DltTraceStatusSettings配置

新建DltTraceStatusSettings

DlttraceStatusSettings添加步骤为：鼠标选中DltConfigSet—单击右键—New—DlttraceStatusSettings。默认情况，无该配置项。

image29

图5-24 Dlt模块新建TraceStatusSetting配置容器界面

DltTraceStatusSettings配置容器

为Dlt模块设置初始默认跟踪状态，在DltTraceStatusSettings选项卡中点击默认跟踪状态设置按钮DltDefaultTraceStatus，从下拉菜单中选中一个配置作为默认跟踪状态。默认情况，该配置项设置为FALSE。

image30

图5-25 Dlt模块TraceStatusSettings配置容器界面

表5-14 Dlt模块的TraceStatusSettings配置属性描述

UI 名称

描述

Dlt TraceS tatusS etting

取值范围

引用或下拉选项

默 | 认 | 取 | 值 |
无 |

参数描述

包含跟踪状态的设置

依赖关系

无

Dlt Defaul tTrace Status

取值范围

TRUE，FALSE

默认取值

FALSE

参数描述

这是在没有过 滤器匹配给定的Applica tionId和ContextId时使 用的有效跟踪状态。这 可以看作是一个带有通 配符ApplicationId和Co ntextId的穿透过滤器定 义，当没有其他过滤器 匹配时，将使用通配符

依赖关系

无

DltTra ceStat usAssi gnment

取值范围

引用或下拉选项

默认取值

无

参数描述

这 个容器包含Applicatio nId/ContextId对及其分 配的跟踪状态的预配置

依赖关系

无
DltTraceStatusSettingsSwcContext配置容器
image31
图5-26 Dlt模块TraceStatusAssignmentSwcContext配置容器界面

表5-15 Dlt模块的TraceStatusAssignmentSwcContext配置属性描述

UI 名称

描述

DltTra ceStat usAssi gnment

取值范围

引用或下拉选项

默 | 认 | 取 | 值 |

参数描述

这个 容器包含ApplicationI d/ContextId对及其分配 的跟踪状态的预配置。

依赖关系

无

Dl tTrace Status

取值范围

TRUE，FALSE

默认取值

FALSE

参数描述

跟 踪给定的ApplicationI d/ContextId元组的状态

依赖关系

无

D ltTrac eStatu sAssig nmentS wcCont extRef

取值范围

引用或下拉选项

默认取值

–

参数描述

对已分配Dlt跟踪状 态的ApplicationId/Co ntextId对应元组的引用

依赖关系

无

DltSwc配置

新建DltSwc

DltSwc添加步骤为：鼠标选中DltConfigSets—单击右键—New—DltConfigSet。默认情况，无该配置项。

image32

图5-27 Dlt模块新建Swc配置容器图

DltSwc配置容器

为Dlt模块的SWC上下文配置表设置会话标识符、是否支持日志级别更新通知、日志消息最大长度和跟踪消息最大长度等参数的配置。

默认情况，无该配置项。

image33

图5-28 Dlt模块Swc配置容器界面

表5-16 Dlt模块的Swc配置属性描述

UI 名称

描述

DltSwc

取值范围

下拉选项

默 | 认 | 取 | 值 |
无 |

参数描述

包含AUTOSAR Dlt模块与S WCs交互所需的配置参数

依赖关系

无

Dlt SwcSes sionId

取值范围

0…4294967295

默认取值

0

参数描述

一个ECU范围的 唯一标识符ID，用于标 识SWC(实例)使用的端口

依赖关系

无

Dlt SwcSup portLo gLevel Change Notifi cation

取值范围

TRUE，FALSE

默认取值

FALSE

参数描述

标志指示Dlt是否必须 提供一个R-Port来通知 SWC关于日志级别的更改

依赖关系

无

MaxS wcLogM essage Length

取值范围

0…65535

默认取值

0

参数描述

定义日 志消息允许的最大长度

依赖关系

无

MaxSwc TraceM essage Length

取值范围

0…65535

默认取值

0

参数描述

定义跟 踪消息允许的最大长度

依赖关系

无

D ltSwcC ontext

取值范围

引用或下拉选项

默认取值

无

参数描述

这个容器包含SWC所支 持的ApplicationId/Co ntextId对应元组的配置

依赖关系

无

DltSwcContext配置容器

为Dlt模块的SWC上下文配置表设置应用程序标识符和上下文标识符。默认情况，无该配置项。

image34

图5-29 Dlt模块SwcContext配置容器界面

表5-17 Dlt模块的SwcContext配置属性描述

UI 名称

描述

D ltSwcC ontext

取值范围

下拉选项

默 | 认 | 取 | 值 |
无 |

参数描述

这个容器包含 SWC所支持的Applicatio nId/ContextId对的配置

依赖关系

无

D ltSwcA pplica tionId

取值范围

字符串：uint8 []

默认取值

无

参数描述

用于描述SWC应 用程序标识符的字符串

依赖关系

无

Dlt SwcCon textId

取值范围

字符串：uint8 []

默认取值

FALSE

参数描述

用于描述SW C上下文标识符的字符串

依赖关系

无